agentsmesh 0.36.0 → 0.37.0

package/dist/{init-Dtp4V1_v.d.ts → init-BtgoRmIs.d.ts}

@@ -383,13 +383,8 @@ declare function importLegacyLessons(projectRoot: string, options: ImportLegacyO
 /**
  * Cross-platform process lock backed by an atomic mkdir.
  *
- * Acquire semantics: mkdir with no `recursive` option is atomic per POSIX and
- * returns EEXIST if the directory already exists. That makes it a reliable
- * cross-process mutex without any third-party dependency.
- *
  * Stale recovery: the holder writes its PID and start timestamp into the lock
- * dir. On contention we peek at the PID: a dead same-host holder is evicted at
- * once. A live holder (or one on another host, whose PID we cannot probe) is
+ * dir. A dead same-host holder is evicted at once. A live or remote holder is
  * evicted only past `staleMs` — an hours-long bound that catches a hung
  * process or a recycled PID, never a slow but healthy run.
  */

package/dist/lessons.d.ts

@@ -1,5 +1,5 @@
-import { o as RankedLesson, j as LessonsQuery, A as AddLessonInput, a as AddLessonOptions, b as AddLessonResult } from './init-Dtp4V1_v.js';
-export { c as AddLessonTriggers, D as DEFAULT_RECALL_LIMIT, X as DEFAULT_RECALL_MAX_TOKENS, I as ImportLegacyOptions, d as ImportLegacyReport, Y as LESSONS_LOCK_FILENAME, L as LESSONS_PROCEDURAL_RULE, e as Lesson, f as LessonStatus, g as LessonsGraph, Z as LessonsGraphExistsError, h as LessonsGraphSchema, i as LessonsPaths, M as MatchedLesson, k as MergeLessonsOptions, l as MergeLessonsResult, m as MutateOptions, R as RankOptions, n as RankReason, S as ScaffoldLessonsResult, p as StripMarkersOptions, q as StripMarkersReport, T as Topic, r as Trigger, s as TriggerKind, U as UnknownTopicError, V as ValidationFinding, t as ValidationLevel, u as ValidationReport, v as acquireLessonsLock, w as addLesson, x as graphFilePath, y as importLegacyLessons, _ as lessonsLockPath, z as lessonsPaths, B as loadLessonsGraph, C as mergeLessons, E as mutateLessonsGraph, F as parseGraph, G as queryLessons, H as rankLessons, J as scaffoldLessons, K as serializeGraph, N as stripLegacyMarkers, O as stripMarkersInGraph, P as toRelPath, Q as tryLoadLessonsGraph, W as validateLessonsGraph } from './init-Dtp4V1_v.js';
+import { o as RankedLesson, j as LessonsQuery, A as AddLessonInput, a as AddLessonOptions, b as AddLessonResult } from './init-BtgoRmIs.js';
+export { c as AddLessonTriggers, D as DEFAULT_RECALL_LIMIT, X as DEFAULT_RECALL_MAX_TOKENS, I as ImportLegacyOptions, d as ImportLegacyReport, Y as LESSONS_LOCK_FILENAME, L as LESSONS_PROCEDURAL_RULE, e as Lesson, f as LessonStatus, g as LessonsGraph, Z as LessonsGraphExistsError, h as LessonsGraphSchema, i as LessonsPaths, M as MatchedLesson, k as MergeLessonsOptions, l as MergeLessonsResult, m as MutateOptions, R as RankOptions, n as RankReason, S as ScaffoldLessonsResult, p as StripMarkersOptions, q as StripMarkersReport, T as Topic, r as Trigger, s as TriggerKind, U as UnknownTopicError, V as ValidationFinding, t as ValidationLevel, u as ValidationReport, v as acquireLessonsLock, w as addLesson, x as graphFilePath, y as importLegacyLessons, _ as lessonsLockPath, z as lessonsPaths, B as loadLessonsGraph, C as mergeLessons, E as mutateLessonsGraph, F as parseGraph, G as queryLessons, H as rankLessons, J as scaffoldLessons, K as serializeGraph, N as stripLegacyMarkers, O as stripMarkersInGraph, P as toRelPath, Q as tryLoadLessonsGraph, W as validateLessonsGraph } from './init-BtgoRmIs.js';
 import 'zod';
 
 /**

package/dist/lessons.js

@@ -2,11 +2,11 @@ import { z } from 'zod';
 import { readFileSync, existsSync, mkdirSync, writeFileSync, rmSync, statSync, renameSync, readdirSync, realpathSync, appendFileSync } from 'fs';
 import { resolve, dirname, join, relative, sep, basename, extname } from 'path';
 import { stringify, parse, parseDocument, YAMLSeq, YAMLMap } from 'yaml';
-import { createHash } from 'crypto';
+import { createHash, randomUUID } from 'crypto';
 import picomatch from 'picomatch';
-import { mkdir, rm, writeFile, readFile, stat, lstat, unlink, rename, chmod } from 'fs/promises';
+import { mkdir, rm, writeFile, readFile, stat, lstat, open, rename } from 'fs/promises';
 import { tmpdir, hostname } from 'os';
-import 'timers/promises';
+import { setTimeout as setTimeout$1 } from 'timers/promises';
 
 // src/lessons/graph-schema.ts
 var CURRENT_GRAPH_VERSION = 2;
@@ -1190,8 +1190,7 @@ async function acquireProcessLock(lockPath, opts = {}) {
     if (acquired) return acquired;
     const existing = await inspectLock(lockPath);
     if (existing !== "young" && isStale(existing, stale)) {
-      await rm(lockPath, { recursive: true, force: true }).catch(() => {
-      });
+      await rm(lockPath, { recursive: true, force: true });
       continue;
     }
     if (attempt >= retries) {
@@ -1215,7 +1214,13 @@ async function tryAcquire(lockPath) {
     started: Date.now(),
     hostname: getHostname()
   };
-  await writeFile(metadataPath, JSON.stringify(metadata), "utf-8");
+  try {
+    await writeFile(metadataPath, JSON.stringify(metadata), "utf-8");
+  } catch (error) {
+    await rm(lockPath, { recursive: true, force: true }).catch(() => {
+    });
+    throw error;
+  }
   let released = false;
   const cleanup = () => {
     if (released) return;
@@ -3038,6 +3043,91 @@ function shouldNormalizeLineEndings(path) {
   const base = basename(path).toLowerCase();
   return TEXT_DOTFILES.has(base);
 }
+var BINARY_EXTENSIONS = /* @__PURE__ */ new Set([
+  ".png",
+  ".jpg",
+  ".jpeg",
+  ".gif",
+  ".bmp",
+  ".ico",
+  ".webp",
+  ".avif",
+  ".tiff",
+  ".pdf",
+  ".zip",
+  ".gz",
+  ".tgz",
+  ".bz2",
+  ".xz",
+  ".7z",
+  ".rar",
+  ".jar",
+  ".woff",
+  ".woff2",
+  ".ttf",
+  ".otf",
+  ".eot",
+  ".mp3",
+  ".mp4",
+  ".wav",
+  ".ogg",
+  ".webm",
+  ".mov",
+  ".wasm",
+  ".bin",
+  ".dat",
+  ".db",
+  ".sqlite",
+  ".so",
+  ".dylib",
+  ".dll",
+  ".exe",
+  ".class",
+  ".pyc",
+  // Office and design documents are zip or proprietary containers.
+  ".xlsx",
+  ".xls",
+  ".docx",
+  ".doc",
+  ".pptx",
+  ".ppt",
+  ".odt",
+  ".ods",
+  ".psd",
+  ".ai",
+  ".sketch",
+  ".fig",
+  ".heic",
+  ".heif",
+  // Archives, columnar data, models and compressed payloads.
+  ".tar",
+  ".zst",
+  ".br",
+  ".lz4",
+  ".parquet",
+  ".avro",
+  ".orc",
+  ".pkl",
+  ".npy",
+  ".npz",
+  ".onnx",
+  ".pt",
+  ".safetensors",
+  ".gguf",
+  ".sqlite3",
+  ".avi",
+  ".mkv",
+  ".flac",
+  ".aac",
+  ".m4a",
+  ".ttc"
+]);
+function isBinaryPayloadPath(path) {
+  return BINARY_EXTENSIONS.has(extname(path).toLowerCase());
+}
+function payloadEncodingFor(path) {
+  return isBinaryPayloadPath(path) ? "latin1" : "utf-8";
+}
 function normalizeLineEndings(content) {
   return content.replace(/\r\n?/g, "\n");
 }
@@ -3045,11 +3135,28 @@ var EXECUTABLE_SCRIPT_EXTENSIONS = /* @__PURE__ */ new Set([".sh", ".bash", ".zs
 function executableModeFor(path) {
   return EXECUTABLE_SCRIPT_EXTENSIONS.has(extname(path).toLowerCase()) ? 493 : void 0;
 }
+var TRANSIENT_RENAME_CODES = /* @__PURE__ */ new Set(["EPERM", "EACCES", "EBUSY", "ENOTEMPTY", "EEXIST"]);
+async function renameWithRetry(from, to, options = {}) {
+  const attempts = options.attempts ?? 5;
+  const delayMs = options.delayMs ?? 50;
+  for (let attempt = 0; ; attempt++) {
+    try {
+      await rename(from, to);
+      return;
+    } catch (err) {
+      const code = err.code;
+      const transient = code !== void 0 && TRANSIENT_RENAME_CODES.has(code);
+      if (!transient || attempt >= attempts - 1) throw err;
+      await setTimeout$1(delayMs * 2 ** attempt);
+    }
+  }
+}
 
 // src/utils/filesystem/fs.ts
 async function readFileSafe(path) {
   try {
-    const data = await readFile(path, "utf-8");
+    const data = await readFile(path, payloadEncodingFor(path));
+    if (isBinaryPayloadPath(path)) return data;
     return data.startsWith(UTF8_BOM) ? data.slice(UTF8_BOM.length) : data;
   } catch (err) {
     const e = err;
@@ -3073,40 +3180,28 @@ async function writeFileAtomic(path, content, options) {
         { errnoCode: "EISDIR" }
       );
     }
-    if (info.isSymbolicLink()) {
-      await unlink(path).catch((e) => {
-        if (e.code !== "ENOENT") throw e;
-      });
-    }
   } catch (err) {
     if (err instanceof FileSystemError) throw err;
     const e = err;
     if (e.code !== "ENOENT") throw err;
   }
-  const tmpPath = `${path}.tmp`;
+  const tmpPath = `${path}.tmp-${randomUUID()}`;
   const payload = shouldNormalizeLineEndings(path) ? normalizeLineEndings(content) : content;
   const mode = executableModeFor(path);
+  let handle;
+  let ownsTemporaryFile = false;
   try {
-    try {
-      const tmpInfo = await lstat(tmpPath);
-      if (tmpInfo.isSymbolicLink()) {
-        await unlink(tmpPath);
-      }
-    } catch (tmpErr) {
-      if (tmpErr.code !== "ENOENT") throw tmpErr;
-    }
-    const writeOpts = {
-      encoding: "utf-8",
-      flag: "w"
-    };
-    if (mode !== void 0) writeOpts.mode = mode;
-    await writeFile(tmpPath, payload, writeOpts);
-    await rename(tmpPath, path);
-    if (mode !== void 0) {
-      await chmod(path, mode);
-    }
+    handle = await open(tmpPath, "wx", mode);
+    ownsTemporaryFile = true;
+    await handle.writeFile(payload, payloadEncodingFor(path));
+    if (mode !== void 0) await handle.chmod(mode);
+    await handle.close();
+    handle = void 0;
+    await renameWithRetry(tmpPath, path);
   } catch (err) {
-    await rm(tmpPath, { force: true }).catch(() => {
+    await handle?.close().catch(() => {
+    });
+    if (ownsTemporaryFile) await rm(tmpPath, { force: true }).catch(() => {
     });
     const e = err;
     throw new FileSystemError(