swipium 1.5.0 → 2.0.0

package/dist/lib/gestures.js

@@ -0,0 +1,141 @@
+// Shared screen-relative gesture geometry. qa_act and the flow runner derive
+// swipe/scroll vectors the SAME way: anchored as fractions of the real screen size and
+// clamped on-screen, with fixed legacy coordinates ONLY as the fallback when the driver
+// cannot report a size. WDA swipes are in POINTS (a modern iPhone is ≤~440pt wide), so any
+// fixed pixel constant is off-screen there.
+/** ~8% edge inset used by qa_act gestures. Stays clear of the iOS system-gesture zones
+ * (home indicator, notification/control-center edges). Flow replay keeps inset 0 so
+ * existing recorded flows keep their historical [1, size-1] clamp. */
+export const GESTURE_EDGE_INSET = 0.08;
+/** Legacy fixed-coordinate vectors, used ONLY when screenSize() is unknown. */
+export const FALLBACK_SWIPE = {
+    up: [540, 1500, 540, 600],
+    down: [540, 600, 540, 1500],
+    left: [800, 1100, 200, 1100],
+    right: [200, 1100, 800, 1100],
+};
+export const AREA_ANCHOR = {
+    center: [0.5, 0.5],
+    top: [0.5, 0.3],
+    bottom: [0.5, 0.7],
+    left: [0.3, 0.5],
+    right: [0.7, 0.5],
+};
+/** Legacy swipe travel in px when the screen size is unknown (the old qa_act constant). */
+const FALLBACK_DISTANCE = 800;
+function clamper(size, insetFrac) {
+    const insetX = Math.max(1, Math.round(size.width * insetFrac));
+    const insetY = Math.max(1, Math.round(size.height * insetFrac));
+    return {
+        x: (x) => Math.max(insetX, Math.min(size.width - insetX, Math.round(x))),
+        y: (y) => Math.max(insetY, Math.min(size.height - insetY, Math.round(y))),
+    };
+}
+/** Device-relative swipe vector (fractions of the screen), falling back to fixed coords if no size.
+ * insetFrac keeps every endpoint at least that fraction of the screen away from each edge;
+ * the default 0 preserves the flow runner's historical [1, size-1] clamp. */
+export function swipeVector(size, dir, area = 'center', distance = 0.6, insetFrac = 0) {
+    if (!size)
+        return FALLBACK_SWIPE[dir];
+    const [ax, ay] = AREA_ANCHOR[area];
+    const cx = size.width * ax;
+    const cy = size.height * ay;
+    const vd = (size.height * distance) / 2;
+    const hd = (size.width * distance) / 2;
+    const clamp = clamper(size, insetFrac);
+    const v = {
+        up: [cx, cy + vd, cx, cy - vd],
+        down: [cx, cy - vd, cx, cy + vd],
+        left: [cx + hd, cy, cx - hd, cy],
+        right: [cx - hd, cy, cx + hd, cy],
+    }[dir];
+    return [clamp.x(v[0]), clamp.y(v[1]), clamp.x(v[2]), clamp.y(v[3])];
+}
+/** Swipe starting at an explicit point (a resolved qa_act target). The start is used
+ * VERBATIM (it is a real element the caller asked to swipe from, and 0 is a legitimate
+ * coordinate), while the derived end point is clamped on-screen. */
+export function swipeFromPoint(size, from, dir, distance = 0.5, insetFrac = 0) {
+    const dist = size ? (dir === 'up' || dir === 'down' ? size.height : size.width) * distance : FALLBACK_DISTANCE;
+    const to = {
+        up: { x: from.x, y: from.y - dist },
+        down: { x: from.x, y: from.y + dist },
+        left: { x: from.x - dist, y: from.y },
+        right: { x: from.x + dist, y: from.y },
+    }[dir];
+    if (!size)
+        return [from.x, from.y, Math.round(to.x), Math.round(to.y)];
+    const clamp = clamper(size, insetFrac);
+    return [from.x, from.y, clamp.x(to.x), clamp.y(to.y)];
+}
+/** Fraction of a scrollable container kept clear on each side when a scroll is anchored in it.
+ * keeps the finger off sticky headers/footers that sit flush with the container's edges. */
+export const SCROLL_CONTAINER_INSET = 0.1;
+/** Minimum on-screen extent (px/pt) a scrollable container needs on each axis to anchor a swipe. */
+const MIN_SCROLL_CONTAINER = 48;
+/** PURE: the visible rect of the LARGEST scrollable node, or null when there is none worth using.
+ * Android marks containers `scrollable="true"`; the WDA source normalizer maps
+ * ScrollView/Table/CollectionView to the same attribute. A clipped Android node can report
+ * inverted bounds (e.g. `[210,315][750,124]`, its visible area is empty): such nodes are
+ * ignored, and every rect is clipped to the screen when the size is known. */
+export function largestScrollableRect(nodes, size) {
+    let best = null;
+    let bestArea = 0;
+    for (const n of nodes ?? []) {
+        if (!n.scrollable)
+            continue;
+        let [x1, y1, x2, y2] = n.bounds;
+        if (size) {
+            x1 = Math.max(0, x1);
+            y1 = Math.max(0, y1);
+            x2 = Math.min(size.width, x2);
+            y2 = Math.min(size.height, y2);
+        }
+        // inverted / collapsed after clipping > not visible, can't be a gesture anchor
+        if (x2 - x1 < MIN_SCROLL_CONTAINER || y2 - y1 < MIN_SCROLL_CONTAINER)
+            continue;
+        const area = (x2 - x1) * (y2 - y1);
+        if (area > bestArea) {
+            bestArea = area;
+            best = [x1, y1, x2, y2];
+        }
+    }
+    return best;
+}
+/** Swipe vector anchored INSIDE a scrollable container: centered on the container, travel =
+ * `distance` × the container's extent on the swipe axis, both endpoints kept `containerInset`
+ * inside the container AND (when possible) `screenInset` inside the screen. A swipe that starts
+ * on a sticky app bar above the list moves nothing. That's why the container matters. */
+export function swipeInRect(rect, dir, size, distance = 0.6, containerInset = SCROLL_CONTAINER_INSET, screenInset = 0) {
+    const [x1, y1, x2, y2] = rect;
+    const w = x2 - x1;
+    const h = y2 - y1;
+    const cx = x1 + w / 2;
+    const cy = y1 + h / 2;
+    const axisRange = (lo, hi, extent, screen) => {
+        const inset = Math.max(1, Math.round(extent * containerInset));
+        let a = lo + inset;
+        let b = hi - inset;
+        if (screen != null && screenInset > 0) {
+            const si = Math.max(1, Math.round(screen * screenInset));
+            const sa = Math.max(a, si);
+            const sb = Math.min(b, screen - si);
+            if (sb > sa)
+                [a, b] = [sa, sb]; // only when the two insets still leave room
+        }
+        return [a, b];
+    };
+    const [minX, maxX] = axisRange(x1, x2, w, size?.width);
+    const [minY, maxY] = axisRange(y1, y2, h, size?.height);
+    const cX = (x) => Math.round(Math.max(minX, Math.min(maxX, x)));
+    const cY = (y) => Math.round(Math.max(minY, Math.min(maxY, y)));
+    const vd = (h * distance) / 2;
+    const hd = (w * distance) / 2;
+    const v = {
+        up: [cx, cy + vd, cx, cy - vd],
+        down: [cx, cy - vd, cx, cy + vd],
+        left: [cx + hd, cy, cx - hd, cy],
+        right: [cx - hd, cy, cx + hd, cy],
+    }[dir];
+    return [cX(v[0]), cY(v[1]), cX(v[2]), cY(v[3])];
+}
+//# sourceMappingURL=gestures.js.map

package/dist/lib/gestures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gestures.js","sourceRoot":"","sources":["../../src/lib/gestures.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,uFAAuF;AACvF,wFAAwF;AACxF,2FAA2F;AAC3F,4CAA4C;AAO5C;;sEAEsE;AACtE,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEvC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,cAAc,GAAqC;IAC9D,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC;IACzB,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC;IAC3B,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC;IAC5B,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC;CAC9B,CAAC;AACF,MAAM,CAAC,MAAM,WAAW,GAAwC;IAC9D,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IACf,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IAChB,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;CAClB,CAAC;AACF,2FAA2F;AAC3F,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B,SAAS,OAAO,CAAC,IAAuC,EAAE,SAAiB;IACzE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAChE,OAAO;QACL,CAAC,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAChF,CAAC,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;KAClF,CAAC;AACJ,CAAC;AAED;;6EAE6E;AAC7E,MAAM,UAAU,WAAW,CACzB,IAA8C,EAC9C,GAAmB,EACnB,OAAkB,QAAQ,EAC1B,QAAQ,GAAG,GAAG,EACd,SAAS,GAAG,CAAC;IAEb,IAAI,CAAC,IAAI;QAAE,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IAC5B,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACvC,MAAM,CAAC,GAAG;QACR,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC;QAC9B,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC;QAChC,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;QAChC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;KAClC,CAAC,GAAG,CAAC,CAAC;IACP,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC;AAED;;oEAEoE;AACpE,MAAM,UAAU,cAAc,CAC5B,IAA8C,EAC9C,IAA8B,EAC9B,GAAmB,EACnB,QAAQ,GAAG,GAAG,EACd,SAAS,GAAG,CAAC;IAEb,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAC/G,MAAM,EAAE,GAAG;QACT,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE;QACnC,IAAI,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE;QACrC,IAAI,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE;QACrC,KAAK,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE;KACvC,CAAC,GAAG,CAAC,CAAC;IACP,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAID;4FAC4F;AAC5F,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAE1C,oGAAoG;AACpG,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC;;;;8EAI8E;AAC9E,MAAM,UAAU,qBAAqB,CACnC,KAA4G,EAC5G,IAA8C;IAE9C,IAAI,IAAI,GAAuB,IAAI,CAAC;IACpC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,CAAC,UAAU;YAAE,SAAS;QAC5B,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;QAChC,IAAI,IAAI,EAAE,CAAC;YACT,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACrB,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACrB,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC9B,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,+EAA+E;QAC/E,IAAI,EAAE,GAAG,EAAE,GAAG,oBAAoB,IAAI,EAAE,GAAG,EAAE,GAAG,oBAAoB;YAAE,SAAS;QAC/E,MAAM,IAAI,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QACnC,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;YACpB,QAAQ,GAAG,IAAI,CAAC;YAChB,IAAI,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;yFAGyF;AACzF,MAAM,UAAU,WAAW,CACzB,IAAiB,EACjB,GAAmB,EACnB,IAA8C,EAC9C,QAAQ,GAAG,GAAG,EACd,cAAc,GAAG,sBAAsB,EACvC,WAAW,GAAG,CAAC;IAEf,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC;IAC9B,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;IAClB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;IAClB,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACtB,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACtB,MAAM,SAAS,GAAG,CAAC,EAAU,EAAE,EAAU,EAAE,MAAc,EAAE,MAAe,EAAoB,EAAE;QAC9F,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC;QAC/D,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACnB,IAAI,MAAM,IAAI,IAAI,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACtC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC;YACzD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC;YACpC,IAAI,EAAE,GAAG,EAAE;gBAAE,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,4CAA4C;QAC9E,CAAC;QACD,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChB,CAAC,CAAC;IACF,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACvD,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACxD,MAAM,EAAE,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,MAAM,EAAE,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,CAAC,GAAG;QACR,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC;QAC9B,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC;QAChC,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;QAChC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;KAClC,CAAC,GAAG,CAAC,CAAC;IACP,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC"}

package/dist/lib/gitignore.js

@@ -1,6 +1,7 @@
-// Keep Swipium's generated artifacts out of the user's VCS. Both `swipium scan` and every
-// session (which writes .swipium/<id>/…) call this, so merely using Swipium never dirties a
-// developer's git tree. Idempotent; only touches a real git repo's .gitignore.
+// Keep Swipium's generated artifacts out of the user's VCS. Called when Swipium writes the app
+// map (src/appMap/store.ts) or the issue ledger (src/issues/store.ts), so the first such write
+// appends `.swipium/` to the project's .gitignore. `swipium scan` itself does not call this.
+// Idempotent; only touches a real git repo's .gitignore (it never runs Git).
 import { existsSync, readFileSync, appendFileSync } from 'node:fs';
 import { join } from 'node:path';
 export function ensureGitignored(root) {

package/dist/lib/gitignore.js.map

@@ -1 +1 @@
-{"version":3,"file":"gitignore.js","sourceRoot":"","sources":["../../src/lib/gitignore.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,4FAA4F;AAC5F,+EAA+E;AAE/E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAAE,OAAO,YAAY,CAAC;QACzD,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACpC,MAAM,GAAG,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,IAAI,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QACxD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,cAAc,CAAC,EAAE,EAAE,GAAG,MAAM,mDAAmD,CAAC,CAAC;QACjF,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,YAAY,CAAC,CAAC,+DAA+D;IACtF,CAAC;AACH,CAAC"}
+{"version":3,"file":"gitignore.js","sourceRoot":"","sources":["../../src/lib/gitignore.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,+FAA+F;AAC/F,6FAA6F;AAC7F,6EAA6E;AAE7E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAAE,OAAO,YAAY,CAAC;QACzD,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACpC,MAAM,GAAG,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,IAAI,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QACxD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,cAAc,CAAC,EAAE,EAAE,GAAG,MAAM,mDAAmD,CAAC,CAAC;QACjF,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,YAAY,CAAC,CAAC,+DAA+D;IACtF,CAAC;AACH,CAAC"}

package/dist/lib/image.js

@@ -1,4 +1,4 @@
-// Local, deterministic visual ops (PHASE3-PLAN §8.2) — baseline diff + template matching on
+// Local, deterministic visual ops: baseline diff + template matching on
 // decoded pixels. No AI, no network, no third-party code: just arithmetic over PNG bytes.
 import { decodePng, toGray } from './png.js';
 /** Per-pixel diff of two same-size screenshots. A pixel "changed" if any channel differs by > tol. */

package/dist/lib/image.js.map

@@ -1 +1 @@
-{"version":3,"file":"image.js","sourceRoot":"","sources":["../../src/lib/image.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,0FAA0F;AAE1F,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAW7C,sGAAsG;AACtG,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,IAAY,EAAE,GAAG,GAAG,EAAE;IAC5D,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QACjD,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,MAAM,EAAE,iBAAiB,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,EAAE;YACxE,KAAK,EAAE,CAAC;YACR,aAAa,EAAE,CAAC;YAChB,KAAK,EAAE,CAAC;YACR,GAAG,EAAE,IAAI;SACV,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC;IACtB,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC;IACtB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,IAAI,GAAG,MAAM,CAAC;IAClB,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;IACd,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YAChC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YAChC,IACE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG;gBACvC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG;gBAC/C,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,EAC/C,CAAC;gBACD,OAAO,EAAE,CAAC;gBACV,IAAI,CAAC,GAAG,IAAI;oBAAE,IAAI,GAAG,CAAC,CAAC;gBACvB,IAAI,CAAC,GAAG,IAAI;oBAAE,IAAI,GAAG,CAAC,CAAC;gBACvB,IAAI,CAAC,GAAG,IAAI;oBAAE,IAAI,GAAG,CAAC,CAAC;gBACvB,IAAI,CAAC,GAAG,IAAI;oBAAE,IAAI,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC7B,OAAO;QACL,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,OAAO,GAAG,KAAK;QACtB,aAAa,EAAE,OAAO;QACtB,KAAK;QACL,GAAG,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;KAC9F,CAAC;AACJ,CAAC;AAUD,SAAS,aAAa,CAAC,CAAa,EAAE,CAAS,EAAE,CAAS,EAAE,MAAc;IACxE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAC/C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE;YAAE,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAClH,CAAC;IACD,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,WAAmB,EAAE,QAAQ,GAAG,IAAI;IAClF,MAAM,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;IAC/B,MAAM,CAAC,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IACjC,wFAAwF;IACxF,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/D,MAAM,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/D,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;QACvD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAClD,CAAC;IACD,MAAM,MAAM,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,qCAAqC;IAC/E,IAAI,IAAI,GAAG,QAAQ,CAAC;IACpB,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,MAAM,MAAM,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC;IACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC;QAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC;YAC9C,IAAI,GAAG,GAAG,CAAC,CAAC;YACZ,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,GAAG,GAAG,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC;gBAC/C,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;gBACjC,MAAM,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;gBACvB,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE;oBAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;YACvF,CAAC;YACD,IAAI,GAAG,GAAG,IAAI,EAAE,CAAC;gBACf,IAAI,GAAG,GAAG,CAAC;gBACX,EAAE,GAAG,CAAC,CAAC;gBACP,EAAE,GAAG,CAAC,CAAC;YACT,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC;IAChC,mDAAmD;IACnD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;IAChD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;IAChD,OAAO,EAAE,KAAK,EAAE,KAAK,IAAI,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;AAC5F,CAAC"}
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../src/lib/image.ts"],"names":[],"mappings":"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"}

package/dist/lib/lockfile.js

@@ -1,60 +1,399 @@
 // Minimal advisory file lock for cross-process coordination on the small shared JSON files
-// under ~/.swipium (registry.json, processes.json). Two concurrent server instances are
-// common (multiple MCP clients), and an unlocked read-modify-write lets them clobber each
-// other's entries. The lock is a DIRECTORY (mkdir is atomic on POSIX and Windows): whoever
-// creates it holds it. A stale lock (holder crashed mid-write) is taken over after STALE_MS.
-// Waiting is a short synchronous spin — callers do tiny sync JSON rewrites — and on timeout
-// we fail the write rather than proceeding unlocked and reintroducing read-modify-write clobbers.
-import { mkdirSync, rmdirSync, statSync } from 'node:fs';
+// under ~/.swipium (registry.json, processes.json) and .swipium/app-map.json. Two concurrent
+// server instances are common (multiple MCP clients), and an unlocked read-modify-write lets them
+// clobber each other's entries. The lock is a DIRECTORY (mkdir is atomic on POSIX and Windows):
+// whoever creates it holds it. Each acquisition writes an OWNER file (`<lockPath>/owner` =
+// `pid:token`, created exclusively) so release can verify the lock is still ours. A holder that
+// stalled past the stale threshold and was taken over must NOT delete the new owner's lock.
+//
+// Stale takeover (holder crashed mid-write) is CLAIM-then-MOVE (H8, review round 2):
+//  1. claim: the taker creates `<lockPath>/.takeover` EXCLUSIVELY ('wx', with its own token).
+//     Only one taker can claim a given lock-directory instance, and the lock path never
+//     disappears during a failed claim, so a newcomer can't slip in;
+//  2. verify: the claimed directory must still be exactly the lock it judged stale (same owner,
+//     still old before the claim, same inode after it). If a racing waiter already replaced it with a FRESH lock, the claim is dropped
+//     and the fresh lock is left untouched (it never moved);
+//  3. move: rename the lock to a unique tombstone (`<lockPath>.stale-<pid>-<uuid>`), confirm the
+//     tombstone carries OUR claim (i.e. we moved the instance we verified), delete it, retry mkdir.
+// Residual race: between verify and move the path can only change if the presumed-dead holder
+// wakes up and releases, and a new holder re-creates the lock, inside that window. The post-move
+// claim check catches it: the moved lock is renamed back. If that restore fails because yet
+// another contender already created the path, the taker does NOT proceed (takeover failed > it
+// goes back to waiting) and does NOT delete the moved lock. It stays as a tombstone (never
+// treated as safe to rm while it may belong to a live holder) and is swept once older than the
+// stale threshold; the displaced holder is warned at release and removes its own tombstone.
+// Orphaned tombstones / claims (a taker crashed mid-takeover) are swept / expired as stale.
+//
+// Two variants:
+//  - withFileLock (sync): for the tiny synchronous JSON rewrites (registry/processes/app-map
+//    save). Waits are short synchronous sleeps (Atomics.wait, 25 ms slices, ≤ MAX_WAIT_MS total),
+//    so the critical section MUST be short: a sync fn cannot be heartbeated (no timer can fire
+//    while it runs). Slow work (e.g. the app-map static scan) belongs OUTSIDE the lock.
+//  - withFileLockAsync: for async critical sections. Waits yield to the event loop and a heartbeat
+//    refreshes the lock's mtime every staleMs/3 so a long holder is never judged stale.
+// On timeout both variants fail rather than proceed unlocked (that would reintroduce clobbers).
+import { mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, utimesSync, writeFileSync } from 'node:fs';
+import { randomUUID } from 'node:crypto';
+import { basename, dirname, join } from 'node:path';
 import { log } from './logger.js';
-const STALE_LOCK_MS = 10_000;
+export const STALE_LOCK_MS = 10_000;
 const MAX_WAIT_MS = 2_000;
 const RETRY_SLEEP_MS = 25;
-/** Synchronous sleep without spinning the CPU (Node allows Atomics.wait on the main thread). */
+/** 'retry' (lock vanished / stale takeover attempted) loops without sleeping at most this many
+ *  times in a row; after that it sleeps like 'busy'. A takeover that can never succeed (EACCES on
+ *  the claim, rename failure, a fresh claim from a crashed taker) must not busy-spin, since it would
+ *  block the event loop forever (the deadline is checked on EVERY iteration too). */
+const MAX_IMMEDIATE_RETRIES = 3;
+const OWNER_FILE = 'owner';
+const TOMBSTONE_MARK = '.stale-';
+const CLAIM_FILE = '.takeover';
+/** Test seams for simulating contender interleavings inside a takeover. Never set in production. */
+export const lockHooks = {};
+/** Synchronous sleep without spinning the CPU (Node allows Atomics.wait on the main thread).
+ *  Only ever called with short slices (RETRY_SLEEP_MS / rename backoff). */
 function sleepSync(ms) {
     Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
 }
-/** Run `fn` while holding the advisory lock at `lockPath` (a directory that must not pre-exist).
- *  Retries for up to MAX_WAIT_MS, taking over locks older than STALE_LOCK_MS (crashed holder). */
-export function withFileLock(lockPath, fn) {
-    const deadline = Date.now() + MAX_WAIT_MS;
-    let locked = false;
-    while (!locked) {
+/** The `pid:token` string of the lock's current owner, or null when absent/unreadable. */
+function currentOwner(lockPath) {
+    try {
+        return readFileSync(join(lockPath, OWNER_FILE), 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+function readFileOrNull(p) {
+    try {
+        return readFileSync(p, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+/** Remove our takeover claim from `dir` (only if it is still ours). */
+function dropClaim(dir, claimToken) {
+    const claim = join(dir, CLAIM_FILE);
+    if (readFileOrNull(claim) === claimToken)
+        rmSync(claim, { force: true });
+}
+/** A claim left by a taker that crashed mid-takeover would block every future takeover of that
+ *  lock: expire it once older than the stale threshold (moved aside atomically, then removed). */
+function expireStaleClaim(lockPath, staleMs) {
+    const claim = join(lockPath, CLAIM_FILE);
+    try {
+        if (Date.now() - statSync(claim).mtimeMs <= staleMs)
+            return;
+        const lockStat = statSync(lockPath);
+        const dead = `${claim}.dead-${randomUUID()}`;
+        renameSync(claim, dead);
+        rmSync(dead, { force: true });
+        // Removing the claim bumped the lock dir's mtime; keep it looking as stale as it is.
+        utimesSync(lockPath, lockStat.atime, lockStat.mtime);
+    }
+    catch {
+        /* gone or raced another expirer */
+    }
+}
+/** Take over a lock judged stale (claim > verify > move; see the header). Returns true when the
+ *  stale lock was removed (the caller should retry mkdir), false when the takeover failed and the
+ *  caller must go back to waiting: the lock was already gone, another taker holds the claim, a
+ *  racing waiter replaced it with a fresh lock (left untouched), or the moved lock turned out not
+ *  to be the verified one (restored, or kept as a tombstone if the path was re-created meanwhile).
+ *  Exported for tests. */
+export function takeOverStaleLock(lockPath, observed, staleMs = STALE_LOCK_MS) {
+    const claimToken = `${process.pid}:${randomUUID()}`;
+    // Identify the instance BEFORE claiming (writing the claim bumps the directory's mtime).
+    let before;
+    try {
+        const st = statSync(lockPath);
+        if (currentOwner(lockPath) !== observed.owner || Date.now() - st.mtimeMs <= staleMs)
+            return false; // replaced/refreshed
+        before = { ino: st.ino, dev: st.dev };
+    }
+    catch {
+        return false; // already gone
+    }
+    try {
+        writeFileSync(join(lockPath, CLAIM_FILE), claimToken, { flag: 'wx' });
+    }
+    catch (e) {
+        if (e.code === 'EEXIST')
+            expireStaleClaim(lockPath, staleMs);
+        return false; // lock gone (ENOENT) or another taker is mid-takeover
+    }
+    let isSame = false;
+    try {
+        const st = statSync(lockPath);
+        isSame = st.ino === before.ino && st.dev === before.dev && currentOwner(lockPath) === observed.owner;
+    }
+    catch {
+        isSame = false;
+    }
+    if (!isSame) {
+        // We claimed a FRESH lock (a racing waiter won the takeover and re-acquired after our
+        // observation). It never moved: just withdraw the claim.
+        dropClaim(lockPath, claimToken);
+        return false;
+    }
+    lockHooks.beforeTakeoverMove?.();
+    const tomb = `${lockPath}${TOMBSTONE_MARK}${process.pid}-${randomUUID()}`;
+    try {
+        renameSync(lockPath, tomb); // atomic
+    }
+    catch {
+        return false; // released meanwhile
+    }
+    if (readFileOrNull(join(tomb, CLAIM_FILE)) !== claimToken) {
+        // The path was replaced between verify and move: we moved someone else's (possibly live) lock.
+        lockHooks.beforeTakeoverRestore?.();
         try {
-            mkdirSync(lockPath); // atomic: throws EEXIST if another process holds the lock
-            locked = true;
+            renameSync(tomb, lockPath); // put it back untouched
         }
         catch {
+            // Another contender already re-created the path. Do NOT delete the moved lock (it may belong
+            // to a live holder) and do NOT proceed as owner: the takeover failed. The tombstone is swept
+            // once stale; its holder is warned at release.
+            log('error', 'file lock takeover moved a replaced lock and could not restore it; left as tombstone, not acquiring', {
+                lockPath,
+                tomb,
+            });
+        }
+        return false;
+    }
+    rmSync(tomb, { recursive: true, force: true });
+    return true;
+}
+/** Remove tombstones left by a taker that crashed between rename and rm. Best-effort. */
+export function sweepLockTombstones(lockPath, staleMs = STALE_LOCK_MS) {
+    let removed = 0;
+    try {
+        const dir = dirname(lockPath);
+        const prefix = `${basename(lockPath)}${TOMBSTONE_MARK}`;
+        for (const name of readdirSync(dir)) {
+            if (!name.startsWith(prefix))
+                continue;
+            const p = join(dir, name);
             try {
-                const st = statSync(lockPath);
-                if (Date.now() - st.mtimeMs > STALE_LOCK_MS) {
-                    rmdirSync(lockPath); // stale — the holder crashed; take over
-                    continue;
+                if (Date.now() - statSync(p).mtimeMs > staleMs) {
+                    rmSync(p, { recursive: true, force: true });
+                    removed++;
                 }
             }
             catch {
-                /* lock released between attempts — retry immediately */
-                continue;
-            }
-            if (Date.now() > deadline) {
-                log('error', 'file lock wait timed out — refusing unlocked registry mutation', { lockPath });
-                throw new Error(`Timed out waiting for file lock ${lockPath}`);
+                /* raced another sweeper */
             }
-            sleepSync(RETRY_SLEEP_MS);
         }
     }
+    catch {
+        /* parent missing/unreadable, nothing to sweep */
+    }
+    return removed;
+}
+/** One acquisition attempt: mkdir, else stale-check/takeover. Never sleeps. */
+function tryAcquire(lockPath, token, staleMs) {
+    try {
+        mkdirSync(lockPath); // atomic: throws EEXIST if another process holds the lock
+    }
+    catch (e) {
+        if (e.code !== 'EEXIST')
+            throw e;
+        let observed;
+        try {
+            observed = { owner: currentOwner(lockPath), mtimeMs: statSync(lockPath).mtimeMs };
+        }
+        catch {
+            return 'retry'; // lock released between attempts, retry immediately
+        }
+        if (Date.now() - observed.mtimeMs > staleMs) {
+            // stale: the holder crashed or stalled; take over atomically, then retry mkdir
+            takeOverStaleLock(lockPath, observed, staleMs);
+            return 'retry';
+        }
+        return 'busy';
+    }
+    // We created the dir. Record ownership EXCLUSIVELY ('wx'): if an owner file already exists the
+    // directory is not really ours (a takeover restore swapped a live lock into this path).
+    try {
+        writeFileSync(join(lockPath, OWNER_FILE), token, { flag: 'wx' });
+    }
+    catch (e) {
+        if (e.code === 'EEXIST')
+            return 'busy';
+        rmSync(lockPath, { recursive: true, force: true });
+        throw e;
+    }
+    // Re-check ownership after acquiring: the lock we hold must carry OUR token.
+    if (currentOwner(lockPath) !== token)
+        return 'busy';
+    sweepLockTombstones(lockPath, staleMs);
+    return 'acquired';
+}
+function release(lockPath, token) {
+    // Verify-then-release: only remove the lock while the owner file still holds OUR token. If fn()
+    // stalled past the stale threshold another process legitimately took the lock over, and deleting it
+    // here would let a THIRD process acquire while the new owner still runs.
+    if (currentOwner(lockPath) === token) {
+        try {
+            rmSync(lockPath, { recursive: true, force: true });
+        }
+        catch {
+            /* already removed (stale takeover raced our release) */
+        }
+    }
+    else {
+        log('warn', 'file lock was taken over while held: this holder stalled past the stale threshold (or was displaced by a takeover race) and its work may have raced the new holder', { lockPath });
+        removeOwnTombstones(lockPath, token);
+    }
+}
+/** A displaced holder's lock may survive as a tombstone (see takeOverStaleLock): remove the ones
+ *  carrying OUR token. They are ours, so this can never touch another holder's lock. */
+function removeOwnTombstones(lockPath, token) {
+    try {
+        const dir = dirname(lockPath);
+        const prefix = `${basename(lockPath)}${TOMBSTONE_MARK}`;
+        for (const name of readdirSync(dir)) {
+            if (!name.startsWith(prefix))
+                continue;
+            const p = join(dir, name);
+            if (currentOwner(p) === token)
+                rmSync(p, { recursive: true, force: true });
+        }
+    }
+    catch {
+        /* best-effort */
+    }
+}
+function newToken() {
+    // Ownership token: verify identity before acting (the same spirit as processRegistry's
+    // serverStillAlive pid+command check).
+    return `${process.pid}:${randomUUID()}`;
+}
+function timeoutError(lockPath) {
+    log('error', 'file lock wait timed out, refusing unlocked registry mutation', { lockPath });
+    return new Error(`Timed out waiting for file lock ${lockPath}`);
+}
+/** Run a SHORT synchronous `fn` while holding the advisory lock at `lockPath` (a directory that
+ *  must not pre-exist). Retries for up to maxWaitMs (blocking in 25 ms slices), taking over locks
+ *  older than staleMs. fn cannot be heartbeated, so keep it well under staleMs. */
+export function withFileLock(lockPath, fn, opts = {}) {
+    const staleMs = opts.staleMs ?? STALE_LOCK_MS;
+    const deadline = Date.now() + (opts.maxWaitMs ?? MAX_WAIT_MS);
+    const token = newToken();
+    let immediate = 0;
+    for (;;) {
+        const r = tryAcquire(lockPath, token, staleMs);
+        if (r === 'acquired')
+            break;
+        if (Date.now() > deadline)
+            throw timeoutError(lockPath);
+        if (r === 'retry' && immediate++ < MAX_IMMEDIATE_RETRIES)
+            continue;
+        immediate = 0;
+        sleepSync(RETRY_SLEEP_MS);
+    }
     try {
         return fn();
     }
     finally {
-        if (locked) {
+        release(lockPath, token);
+    }
+}
+/** Async variant: waits yield to the event loop, and a heartbeat refreshes the lock's mtime every
+ *  staleMs/3 while `fn` runs so a long (async) critical section is never judged stale. */
+export async function withFileLockAsync(lockPath, fn, opts = {}) {
+    const staleMs = opts.staleMs ?? STALE_LOCK_MS;
+    const deadline = Date.now() + (opts.maxWaitMs ?? MAX_WAIT_MS);
+    const token = newToken();
+    let immediate = 0;
+    for (;;) {
+        const r = tryAcquire(lockPath, token, staleMs);
+        if (r === 'acquired')
+            break;
+        if (Date.now() > deadline)
+            throw timeoutError(lockPath);
+        if (r === 'retry' && immediate++ < MAX_IMMEDIATE_RETRIES)
+            continue;
+        immediate = 0;
+        await new Promise((res) => setTimeout(res, RETRY_SLEEP_MS));
+    }
+    const heartbeat = setInterval(() => {
+        // Only refresh a lock that is still ours. Never keep a thief's lock alive on its behalf.
+        if (currentOwner(lockPath) !== token)
+            return;
+        try {
+            const now = new Date();
+            utimesSync(lockPath, now, now);
+        }
+        catch {
+            /* lock vanished; release will log */
+        }
+    }, Math.max(10, Math.floor(staleMs / 3)));
+    heartbeat.unref?.();
+    try {
+        return await fn();
+    }
+    finally {
+        clearInterval(heartbeat);
+        release(lockPath, token);
+    }
+}
+const RENAME_RETRY_CODES = new Set(['EPERM', 'EBUSY', 'EACCES']);
+/** renameSync that tolerates transient Windows sharing violations (antivirus/indexer briefly
+ *  holding the target): retries EPERM/EBUSY/EACCES with short backoff (≤ ~310 ms total). On
+ *  POSIX those errors are permanent, so it throws immediately. */
+export function renameWithRetry(from, to, opts = {}) {
+    const rename = opts.renameFn ?? renameSync;
+    const isWindows = opts.isWindows ?? process.platform === 'win32';
+    const delays = opts.delaysMs ?? [10, 20, 40, 80, 160];
+    for (let attempt = 0;; attempt++) {
+        try {
+            rename(from, to);
+            return;
+        }
+        catch (e) {
+            const code = e.code ?? '';
+            if (!isWindows || !RENAME_RETRY_CODES.has(code) || attempt >= delays.length)
+                throw e;
+            sleepSync(delays[attempt]);
+        }
+    }
+}
+/** Atomic file write: unique tmp sibling + rename (with Windows retry). Removes the tmp on failure. */
+export function writeFileAtomicSync(path, data) {
+    const tmp = `${path}.${process.pid}.${randomUUID().slice(0, 8)}.tmp`;
+    writeFileSync(tmp, data);
+    try {
+        renameWithRetry(tmp, path);
+    }
+    catch (e) {
+        rmSync(tmp, { force: true });
+        throw e;
+    }
+}
+/** Delete `<baseName>.*.tmp` siblings older than maxAgeMs (residue of a writer that crashed
+ *  between write and rename). Young tmp files may belong to a live writer and are kept. */
+export function cleanupOrphanTmpFiles(dir, baseName, maxAgeMs = 10 * 60_000) {
+    let removed = 0;
+    try {
+        for (const name of readdirSync(dir)) {
+            if (!name.startsWith(`${baseName}.`) || !name.endsWith('.tmp'))
+                continue;
+            const p = join(dir, name);
             try {
-                rmdirSync(lockPath);
+                if (Date.now() - statSync(p).mtimeMs > maxAgeMs) {
+                    rmSync(p, { force: true });
+                    removed++;
+                }
             }
             catch {
-                /* already removed (e.g. stale takeover by another process) */
+                /* raced another cleaner */
             }
         }
     }
+    catch {
+        /* dir missing, nothing to clean */
+    }
+    return removed;
 }
 //# sourceMappingURL=lockfile.js.map