agentsmesh 0.36.0 → 0.38.0

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

@@ -137,7 +137,7 @@ declare const DEFAULT_RECALL_LIMIT = 10;
  * lean; without a budget a broad match can return ~450+ rule-tokens. `--all`
  * (CLI) bypasses both caps. The top result is always kept (see RankOptions).
  */
-declare const DEFAULT_RECALL_MAX_TOKENS = 400;
+declare const DEFAULT_RECALL_MAX_TOKENS = 1200;
 /**
  * Rank matched lessons by relevance and apply optional caps. Three lightweight
  * signals are weighted-reciprocal-rank-fused (RRF): trigger specificity (inverse
@@ -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-z8Dlr5Cm.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-z8Dlr5Cm.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;
@@ -1582,6 +1587,28 @@ function collectFanout(graph, findings) {
 function normalizeRule2(rule) {
   return rule.trim().replace(/\s+/g, " ").toLowerCase();
 }
+var TIED_TRIGGER_SET_THRESHOLD = 5;
+function collectTriggerSetCollisions(graph, findings) {
+  const bySet = /* @__PURE__ */ new Map();
+  for (const [id, lesson] of Object.entries(graph.lessons)) {
+    if (lesson.status !== "active") continue;
+    const key = [...lesson.triggers].sort().join(",");
+    if (key === "") continue;
+    const group = bySet.get(key);
+    if (group === void 0) bySet.set(key, [id]);
+    else group.push(id);
+  }
+  const contested = [...bySet.values()].filter((ids) => ids.length > TIED_TRIGGER_SET_THRESHOLD);
+  if (contested.length === 0) return;
+  const largest = contested.reduce((a, b) => b.length > a.length ? b : a);
+  const affected = contested.reduce((n, ids) => n + ids.length, 0);
+  findings.push({
+    level: "warning",
+    code: "TIED_TRIGGER_SETS",
+    message: `${contested.length} trigger set(s) are each shared by more than ${TIED_TRIGGER_SET_THRESHOLD} active lessons (largest ${largest.length}, ${affected} lessons in total). Identical triggers score identically on specificity, so recall picks among them by weaker signals \u2014 split the triggers so the lesson that matters for a given file can win.`,
+    lessonIds: largest.sort()
+  });
+}
 
 // src/lessons/validate-keywords.ts
 function collectLowSignalKeywords(graph, findings) {
@@ -1646,6 +1673,7 @@ function validateLessonsGraph(graph, options = {}) {
   collectDuplicateTriggers(graph, findings);
   collectOrphans(graph, findings);
   collectFanout(graph, findings);
+  collectTriggerSetCollisions(graph, findings);
   collectLowSignalKeywords(graph, findings);
   collectStopwordKeywords(graph, findings);
   collectRunnerAnchoredPatterns(graph, findings);
@@ -2239,7 +2267,7 @@ function buildTopicCoherence(matches) {
 
 // src/lessons/ranking.ts
 var DEFAULT_RECALL_LIMIT = 10;
-var DEFAULT_RECALL_MAX_TOKENS = 400;
+var DEFAULT_RECALL_MAX_TOKENS = 1200;
 var RRF_K = 60;
 var SPECIFICITY_WEIGHT = 5;
 var TOPIC_COHERENCE_WEIGHT = 2;
@@ -3038,6 +3066,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 +3158,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 +3203,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(