@wrongstack/core 0.1.4 → 0.1.7

package/dist/defaults/index.js

@@ -180,9 +180,11 @@ var DefaultPathResolver = class {
   ensureInsideRoot(absPath) {
     const resolved = this.resolve(absPath);
     if (!this.isInsideRoot(resolved)) {
-      throw new Error(
-        `Path "${absPath}" resolves outside the project root (${this.projectRoot})`
-      );
+      const display = path2.isAbsolute(absPath) ? path2.basename(absPath) : absPath;
+      const err = new Error(`Path "${display}" resolves outside the project root`);
+      err.fullPath = absPath;
+      err.projectRoot = this.projectRoot;
+      throw err;
     }
     return resolved;
   }
@@ -352,7 +354,9 @@ var DefaultSessionStore = class {
     try {
       handle = await fsp.open(file, "a", 384);
     } catch (err) {
-      throw new Error(`Failed to open session file: ${err instanceof Error ? err.message : String(err)}`);
+      throw new Error(`Failed to open session file: ${err instanceof Error ? err.message : String(err)}`, {
+        cause: err
+      });
     }
     try {
       return new FileSessionWriter(id, handle, startedAt, meta, { dir: this.dir, filePath: file });
@@ -370,7 +374,8 @@ var DefaultSessionStore = class {
       handle = await fsp.open(file, "a", 384);
     } catch (err) {
       throw new Error(
-        `Failed to open session "${id}" for append: ${err instanceof Error ? err.message : String(err)}`
+        `Failed to open session "${id}" for append: ${err instanceof Error ? err.message : String(err)}`,
+        { cause: err }
       );
     }
     const writer = new FileSessionWriter(
@@ -393,7 +398,10 @@ var DefaultSessionStore = class {
     const events = [];
     for (const line of lines) {
       try {
-        events.push(JSON.parse(line));
+        const parsed = JSON.parse(line);
+        if (parsed !== null && typeof parsed === "object" && typeof parsed.type === "string" && typeof parsed.ts === "string") {
+          events.push(parsed);
+        }
       } catch {
       }
     }
@@ -410,7 +418,11 @@ var DefaultSessionStore = class {
         ids.map((id) => this.summaryFor(id).catch(() => null))
       );
       const out = sessions.filter((s) => s !== null);
-      out.sort((a, b) => a.startedAt < b.startedAt ? 1 : -1);
+      out.sort((a, b) => {
+        if (a.startedAt < b.startedAt) return 1;
+        if (a.startedAt > b.startedAt) return -1;
+        return a.id.localeCompare(b.id);
+      });
       return out.slice(0, limit);
     } catch {
       return [];
@@ -556,6 +568,8 @@ var FileSessionWriter = class {
   filePath;
   initDone = false;
   resumed;
+  appendFailCount = 0;
+  lastAppendWarnAt = 0;
   async writeSessionStart() {
     if (this.initDone || this.closed) return;
     this.initDone = true;
@@ -584,7 +598,19 @@ var FileSessionWriter = class {
       await this.handle.appendFile(`${JSON.stringify(event)}
 `, "utf8");
     } catch (err) {
-      console.warn("[session] append failed:", err instanceof Error ? err.message : String(err));
+      this.appendFailCount++;
+      const now = Date.now();
+      if (now - this.lastAppendWarnAt > 5e3) {
+        const suppressed = this.appendFailCount - 1;
+        const tail = suppressed > 0 ? ` (+${suppressed} suppressed)` : "";
+        console.warn(
+          "[session] append failed:",
+          err instanceof Error ? err.message : String(err),
+          tail
+        );
+        this.lastAppendWarnAt = now;
+        this.appendFailCount = 0;
+      }
     }
   }
   /**
@@ -790,6 +816,15 @@ function mergeAdjacentText(blocks) {
 var MAX_BYTES_TOTAL = 32e3;
 var DefaultMemoryStore = class {
   files;
+  /**
+   * Per-scope serialization queue. `remember` / `forget` / `consolidate` /
+   * `clear` are read-modify-write against a single file; without a lock,
+   * two concurrent calls on the same scope can read the same baseline and
+   * the later write silently drops the earlier entry. We chain each
+   * mutation onto the prior promise for the same scope so they run in
+   * issue order. Different scopes still proceed in parallel.
+   */
+  writeChain = /* @__PURE__ */ new Map();
   constructor(opts) {
     this.files = {
       "project-agents": opts.paths.inProjectAgentsFile,
@@ -797,6 +832,18 @@ var DefaultMemoryStore = class {
       "user-memory": opts.paths.globalMemory
     };
   }
+  async runSerialized(scope, work) {
+    const prior = this.writeChain.get(scope) ?? Promise.resolve();
+    const next = prior.catch(() => void 0).then(work);
+    this.writeChain.set(scope, next);
+    try {
+      return await next;
+    } finally {
+      if (this.writeChain.get(scope) === next) {
+        this.writeChain.delete(scope);
+      }
+    }
+  }
   async readAll() {
     const parts = [];
     for (const scope of ["project-agents", "project-memory", "user-memory"]) {
@@ -815,27 +862,32 @@ ${body.trim()}`);
     }
   }
   async remember(text, scope = "project-memory") {
-    const file = this.files[scope];
-    await ensureDir(path2.dirname(file));
-    let existing = "";
-    try {
-      existing = await fsp.readFile(file, "utf8");
-    } catch {
-    }
-    const ts = (/* @__PURE__ */ new Date()).toISOString();
-    const id = `mem_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
-    const entry = `
+    return this.runSerialized(scope, async () => {
+      const file = this.files[scope];
+      await ensureDir(path2.dirname(file));
+      let existing = "";
+      try {
+        existing = await fsp.readFile(file, "utf8");
+      } catch {
+      }
+      const ts = (/* @__PURE__ */ new Date()).toISOString();
+      const id = `mem_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
+      const entry = `
 - [${ts}] ${id} ${text.replace(/\n/g, " ")}
 `;
-    const next = existing.trim() ? existing.replace(/\n+$/, "") + entry : `# WrongStack Memory
+      const next = existing.trim() ? existing.replace(/\n+$/, "") + entry : `# WrongStack Memory
 ${entry}`;
-    await atomicWrite(file, next);
-    const buf = Buffer.byteLength(next, "utf8");
-    if (buf > MAX_BYTES_TOTAL) {
-      await this.consolidate(scope);
-    }
+      await atomicWrite(file, next);
+      const buf = Buffer.byteLength(next, "utf8");
+      if (buf > MAX_BYTES_TOTAL) {
+        await this.consolidateUnsafe(scope);
+      }
+    });
   }
   async forget(query, scope = "project-memory") {
+    return this.runSerialized(scope, async () => this.forgetUnsafe(query, scope));
+  }
+  async forgetUnsafe(query, scope) {
     const file = this.files[scope];
     let existing;
     try {
@@ -872,6 +924,9 @@ ${entry}`;
     return removed;
   }
   async consolidate(scope) {
+    return this.runSerialized(scope, async () => this.consolidateUnsafe(scope));
+  }
+  async consolidateUnsafe(scope) {
     const file = this.files[scope];
     let existing;
     try {
@@ -902,12 +957,14 @@ ${entry}`;
   }
   async clear(scope) {
     if (scope) {
-      await atomicWrite(this.files[scope], "");
-    } else {
-      for (const s of ["project-agents", "project-memory", "user-memory"]) {
-        await atomicWrite(this.files[s], "");
-      }
+      await this.runSerialized(scope, async () => atomicWrite(this.files[scope], ""));
+      return;
     }
+    await Promise.all(
+      ["project-agents", "project-memory", "user-memory"].map(
+        (s) => this.runSerialized(s, async () => atomicWrite(this.files[s], ""))
+      )
+    );
   }
 };
 function labelOf(scope) {
@@ -955,9 +1012,27 @@ var PATTERNS = [
     regex: /\b([A-Z_]{4,}(?:KEY|TOKEN|SECRET|PASSWORD|PWD))\s*[:=]\s*['"]?([A-Za-z0-9_/+=-]{20,})['"]?(?!\s*[A-Za-z_]{4,}(?:KEY|TOKEN|SECRET|PASSWORD|PWD))/g
   }
 ];
+var SCRUB_CHUNK_BYTES = 64 * 1024;
 var DefaultSecretScrubber = class {
   scrub(text) {
     if (!text) return text;
+    if (text.length <= SCRUB_CHUNK_BYTES) {
+      return this.scrubOne(text);
+    }
+    const out = [];
+    let i = 0;
+    while (i < text.length) {
+      let end = Math.min(i + SCRUB_CHUNK_BYTES, text.length);
+      if (end < text.length) {
+        const nl = text.lastIndexOf("\n", end);
+        if (nl > i + SCRUB_CHUNK_BYTES / 2) end = nl + 1;
+      }
+      out.push(this.scrubOne(text.slice(i, end)));
+      i = end;
+    }
+    return out.join("");
+  }
+  scrubOne(text) {
     let out = text;
     for (const p of PATTERNS) {
       out = out.replace(p.regex, (_match, group1, group2) => {
@@ -1062,7 +1137,17 @@ var DefaultSecretVault = class {
   }
 };
 function decryptConfigSecrets(cfg, vault) {
-  return walk(cfg, vault, (v) => vault.decrypt(v));
+  return walk(cfg, vault, (v, key) => {
+    try {
+      return vault.decrypt(v);
+    } catch (err) {
+      console.warn(
+        `[secret-vault] Failed to decrypt "${key}":`,
+        err instanceof Error ? err.message : err
+      );
+      return "";
+    }
+  });
 }
 function encryptConfigSecrets(cfg, vault) {
   return walk(cfg, vault, (v) => vault.encrypt(v));
@@ -1076,7 +1161,7 @@ function walk(node, vault, transform) {
   const out = {};
   for (const [k, v] of Object.entries(node)) {
     if (typeof v === "string" && isSecretField(k)) {
-      out[k] = transform(v);
+      out[k] = transform(v, k);
     } else if (typeof v === "object" && v !== null) {
       out[k] = walk(v, vault, transform);
     } else {
@@ -1150,9 +1235,11 @@ function walkCount(node, vault, counter) {
   }
   return out;
 }
+var FORBIDDEN_PROTO_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
 function deepMerge(a, b) {
   const out = { ...a };
   for (const [k, v] of Object.entries(b)) {
+    if (FORBIDDEN_PROTO_KEYS.has(k)) continue;
     const existing = out[k];
     if (v !== null && typeof v === "object" && !Array.isArray(v) && existing !== null && typeof existing === "object" && !Array.isArray(existing)) {
       out[k] = deepMerge(existing, v);
@@ -1165,7 +1252,22 @@ function deepMerge(a, b) {
 
 // src/utils/glob-match.ts
 function escapeRegex(s) {
-  return s.replace(/[.+^${}()|\\/]/g, "\\$&");
+  return s.replace(/[.+^${}()|\\]/g, "\\$&");
+}
+var COMPILED_GLOB_CACHE = /* @__PURE__ */ new Map();
+var CACHE_MAX_SIZE = 2e3;
+function getCachedGlob(pattern) {
+  const cached = COMPILED_GLOB_CACHE.get(pattern);
+  if (cached) return cached;
+  if (COMPILED_GLOB_CACHE.size >= CACHE_MAX_SIZE) {
+    const keys = [...COMPILED_GLOB_CACHE.keys()];
+    for (let i = 0; i < Math.floor(CACHE_MAX_SIZE / 4); i++) {
+      COMPILED_GLOB_CACHE.delete(keys[i]);
+    }
+  }
+  const re = compileGlob(pattern);
+  COMPILED_GLOB_CACHE.set(pattern, re);
+  return re;
 }
 function compileGlob(pattern) {
   let i = 0;
@@ -1214,7 +1316,7 @@ function compileGlob(pattern) {
   return new RegExp(re);
 }
 function matchGlob(pattern, input) {
-  return compileGlob(pattern).test(input);
+  return getCachedGlob(pattern).test(input);
 }
 function matchAny(patterns, input) {
   return patterns.some((p) => matchGlob(p, input));
@@ -1261,7 +1363,7 @@ var DefaultPermissionPolicy = class {
     if (!this.loaded) await this.reload();
     const namespaceEntry = this.findNamespaceEntry(tool.name);
     const entry = this.policy[tool.name] ?? namespaceEntry;
-    const subject = this.subjectFor(tool.name, input);
+    const subject = this.subjectFor(tool.name, input, tool.subjectKey);
     if (entry?.deny && subject && matchAny(entry.deny, subject)) {
       return { permission: "deny", source: "deny", reason: "matched deny pattern" };
     }
@@ -1309,16 +1411,23 @@ var DefaultPermissionPolicy = class {
       throw err;
     }
   }
-  subjectFor(toolName, input) {
+  subjectFor(toolName, input, subjectKey) {
     if (!input || typeof input !== "object") return void 0;
     const obj = input;
     const globChars = /[*?\[\]]/g;
     const escapeGlob = (s) => s.replace(globChars, (c) => `\\${c}`);
+    const normalizePath = (s) => escapeGlob(s.replace(/\\/g, "/"));
+    if (subjectKey) {
+      const v = obj[subjectKey];
+      if (typeof v === "string") {
+        return subjectKey === "path" || subjectKey === "file" || subjectKey === "files" ? normalizePath(v) : escapeGlob(v);
+      }
+    }
     if (toolName === "bash" && typeof obj.command === "string") {
       return escapeGlob(obj.command);
     }
     if (typeof obj.path === "string") {
-      return escapeGlob(obj.path.replace(/\\/g, "/"));
+      return normalizePath(obj.path);
     }
     if (typeof obj.url === "string") {
       return escapeGlob(obj.url);
@@ -1464,14 +1573,15 @@ function providerStatusToCode(status, type) {
 }
 
 // src/defaults/retry-policy.ts
-var DefaultRetryPolicy = class {
+var DefaultRetryPolicy = class _DefaultRetryPolicy {
+  static NETWORK_ERR_RE = /ECONN|ETIMEDOUT|ETIME|ENOTFOUND|EAI_AGAIN|fetch failed/i;
   shouldRetry(err, attempt) {
     if (err instanceof ProviderError) {
       if (!err.retryable) return false;
       return attempt < this.maxAttempts(err);
     }
     const msg = err.message ?? "";
-    const isNetwork = /ECONN|ETIMEDOUT|ETIME|ENOTFOUND|EAI_AGAIN|fetch failed/i.test(msg);
+    const isNetwork = _DefaultRetryPolicy.NETWORK_ERR_RE.test(msg);
     if (isNetwork) return attempt < 2;
     return false;
   }
@@ -1493,55 +1603,43 @@ var DefaultRetryPolicy = class {
 };
 
 // src/defaults/error-handler.ts
+var CONTEXT_OVERFLOW_RE = /context|too long|tokens/i;
+var NETWORK_ERR_RE = /ECONN|ETIMEDOUT|ETIME|ENOTFOUND|EAI_AGAIN|fetch failed/i;
 function buildRecoveryStrategies(opts) {
   return [
     {
       label: "context_overflow_reduce",
       compactor: opts?.compactor,
       async attempt(err, ctx) {
-        if (err instanceof ProviderError && (err.status === 413 || /context|too long|tokens/i.test(err.message))) {
-          if (this.compactor) {
-            try {
-              const report = await this.compactor.compact(ctx, { aggressive: true });
-              if (report.after < report.before) {
-                return {
-                  content: [{ type: "text", text: "[context compacted automatically \u2014 please retry]" }],
-                  stopReason: "end_turn",
-                  usage: { input: 0, output: 0 },
-                  model: ctx.model
-                };
-              }
-            } catch {
+        if (!(err instanceof ProviderError)) return null;
+        if (err.status !== 413 && !CONTEXT_OVERFLOW_RE.test(err.message)) return null;
+        if (this.compactor) {
+          try {
+            const report = await this.compactor.compact(ctx, { aggressive: true });
+            if (report.after < report.before) {
+              return { action: "retry", reason: "context_compacted" };
             }
+          } catch {
           }
-          return null;
         }
         return null;
       }
     },
     {
       label: "rate_limit_backoff",
-      async attempt(err, ctx) {
-        if (err instanceof ProviderError && err.status === 429) {
-          const delayMs = err.body?.retryAfterMs ?? 5e3;
-          const delay = Math.max(1e3, Math.min(delayMs, 6e4));
-          await new Promise((r) => setTimeout(r, delay));
-          return {
-            content: [{ type: "text", text: "[rate limit backoff applied \u2014 please retry]" }],
-            stopReason: "end_turn",
-            usage: { input: 0, output: 0 },
-            model: ctx.model
-          };
-        }
-        return null;
+      async attempt(err) {
+        if (!(err instanceof ProviderError) || err.status !== 429) return null;
+        const delayMs = err.body?.retryAfterMs ?? 5e3;
+        const delay = Math.max(1e3, Math.min(delayMs, 6e4));
+        await new Promise((r) => setTimeout(r, delay));
+        return { action: "retry", reason: "rate_limit_backoff" };
       }
     },
     {
       label: "downgrade_model",
       async attempt(err, ctx) {
-        if (err instanceof ProviderError && (err.status === 429 || err.status === 529 || err.status >= 500)) {
-          return null;
-        }
+        if (!(err instanceof ProviderError)) return null;
+        if (err.status !== 429 && err.status !== 529 && err.status < 500) return null;
         return null;
       }
     }
@@ -1564,12 +1662,12 @@ var DefaultErrorHandler = class {
       if (err.status === 429) return { kind: "rate_limit", retryable: true };
       if (err.status === 529) return { kind: "overloaded", retryable: true };
       if (err.status >= 500) return { kind: "server", retryable: true };
-      if (err.status === 413 || /context|too long|tokens/i.test(err.message)) {
+      if (err.status === 413 || CONTEXT_OVERFLOW_RE.test(err.message)) {
         return { kind: "context_overflow", retryable: false };
       }
       if (err.status >= 400) return { kind: "client", retryable: false };
     }
-    if (err instanceof Error && /ECONN|ETIMEDOUT|ETIME|ENOTFOUND|EAI_AGAIN|fetch failed/i.test(err.message)) {
+    if (err instanceof Error && NETWORK_ERR_RE.test(err.message)) {
       return { kind: "network", retryable: true };
     }
     return { kind: "unknown", retryable: false };
@@ -1633,13 +1731,28 @@ var DefaultSkillLoader = class {
   async manifestText() {
     const skills = await this.list();
     if (skills.length === 0) return "";
+    const entries = await this.listEntries();
     const lines = ["## Available skills"];
-    for (const s of skills) {
-      lines.push(`- **${s.name}** \u2014 ${s.description.replace(/\n/g, " ").trim()}`);
-      lines.push(`  Path: ${s.path}`);
+    for (const e of entries) {
+      const scopeTag = e.scope.length > 0 ? ` \u2014 ${e.scope.slice(0, 3).join(", ")}` : "";
+      lines.push(`- **${e.name}**${scopeTag}`);
+      lines.push(`  Use when: ${e.trigger}`);
     }
     return lines.join("\n");
   }
+  async listEntries() {
+    const skills = await this.list();
+    const entries = [];
+    for (const s of skills) {
+      try {
+        const raw = await fsp.readFile(s.path, "utf8");
+        const { trigger, scope } = parseDescription(raw);
+        entries.push({ name: s.name, trigger, scope, source: s.source, path: s.path });
+      } catch {
+      }
+    }
+    return entries;
+  }
   async readBody(name) {
     const m = await this.find(name);
     if (!m) throw new Error(`Skill "${name}" not found`);
@@ -1682,6 +1795,19 @@ function parseFrontmatter(raw) {
   flush();
   return out;
 }
+function parseDescription(raw) {
+  const fm = parseFrontmatter(raw);
+  const desc = fm.description ?? "";
+  const firstSentenceEnd = desc.indexOf(". ");
+  const trigger = firstSentenceEnd !== -1 ? desc.slice(0, firstSentenceEnd + 1).trim() : desc.trim().split("\n")[0] ?? "";
+  const scope = [];
+  const coversMatch = /(?:covers|for|including)\s+([^.]+)/i.exec(desc);
+  if (coversMatch) {
+    const items = coversMatch[1].replace(/[·•]/g, ",").split(",").map((s) => s.trim()).filter(Boolean);
+    scope.push(...items);
+  }
+  return { trigger, scope };
+}
 var BEHAVIOR_DEFAULTS = {
   version: 1,
   context: {
@@ -1730,11 +1856,13 @@ var ENV_MAP = {
 function isPrimitiveArray(a) {
   return a.every((v) => v === null || typeof v !== "object");
 }
+var FORBIDDEN_PROTO_KEYS2 = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
 function deepMerge2(base, patch) {
   if (typeof base !== "object" || base === null) return patch ?? base;
   if (typeof patch !== "object" || patch === null) return base;
   const out = { ...base };
   for (const [k, v] of Object.entries(patch)) {
+    if (FORBIDDEN_PROTO_KEYS2.has(k)) continue;
     const existing = out[k];
     if (Array.isArray(v)) {
       if (Array.isArray(existing) && isPrimitiveArray(v) && isPrimitiveArray(existing)) {
@@ -1802,8 +1930,12 @@ var DefaultConfigLoader = class {
     if (cfg.providers) {
       for (const pcfg of Object.values(cfg.providers)) {
         if (!pcfg || typeof pcfg !== "object") continue;
-        const keys = pcfg.apiKeys;
-        if (!Array.isArray(keys) || keys.length === 0) continue;
+        const rawKeys = pcfg.apiKeys;
+        if (!Array.isArray(rawKeys) || rawKeys.length === 0) continue;
+        const keys = rawKeys.filter(
+          (k) => !!k && typeof k === "object" && typeof k.label === "string" && typeof k.apiKey === "string"
+        );
+        if (keys.length === 0) continue;
         const existing = pcfg.apiKey;
         if (existing && existing.length > 0) continue;
         const activeLabel = pcfg.activeKey;
@@ -1814,23 +1946,42 @@ var DefaultConfigLoader = class {
       }
     }
     this.validateBehavior(cfg);
-    if (this.strict) this.validateIdentity(cfg);
+    if (this.strict) {
+      this.validateIdentity(cfg);
+    }
     return Object.freeze(cfg);
   }
   async readJson(file) {
+    let raw;
     try {
-      const raw = await fsp.readFile(file, "utf8");
-      const parsed = safeParse(raw);
-      if (parsed.ok && parsed.value) return parsed.value;
-    } catch {
+      raw = await fsp.readFile(file, "utf8");
+    } catch (err) {
+      if (err.code !== "ENOENT") {
+        console.warn(`[config] Failed to read "${file}":`, err);
+      }
+      return {};
     }
-    return {};
+    const parsed = safeParse(raw);
+    if (!parsed.ok || !parsed.value) {
+      console.warn(
+        `[config] Failed to parse "${file}": invalid JSON. Falling back to defaults for this layer.`
+      );
+      return {};
+    }
+    return parsed.value;
   }
   validateBehavior(cfg) {
     if (cfg.version === void 0) throw new Error("Config: missing version field");
     if (cfg.version !== 1) throw new Error(`Config: unsupported version ${cfg.version}`);
     const c = cfg.context;
     if (!c) throw new Error("Config: missing context section");
+    const fields = ["warnThreshold", "softThreshold", "hardThreshold"];
+    for (const f of fields) {
+      const v = c[f];
+      if (typeof v !== "number" || !Number.isFinite(v)) {
+        throw new Error(`Config: context.${String(f)} must be a finite number (got ${typeof v})`);
+      }
+    }
     if (c.warnThreshold >= c.softThreshold || c.softThreshold >= c.hardThreshold) {
       throw new Error("Config: context thresholds must satisfy warn < soft < hard");
     }
@@ -1878,7 +2029,8 @@ var DefaultConfigStore = class {
     for (const w of this.watchers) {
       try {
         w(next, prev);
-      } catch {
+      } catch (err) {
+        console.error("[config-store] watcher threw:", err);
       }
     }
     return next;
@@ -1955,21 +2107,33 @@ var DEFAULT_CONFIG_MIGRATIONS = [];
 
 // src/utils/token-estimate.ts
 var RoughTokenEstimate = (text) => Math.max(1, Math.ceil(text.length / 4));
+var ESTIMATE_CACHE = /* @__PURE__ */ new Map();
+var ESTIMATE_CACHE_MAX_SIZE = 1e4;
+function getCachedEstimate(key, compute) {
+  const existing = ESTIMATE_CACHE.get(key);
+  if (existing !== void 0) return existing;
+  if (ESTIMATE_CACHE.size >= ESTIMATE_CACHE_MAX_SIZE) {
+    const keys = [...ESTIMATE_CACHE.keys()];
+    for (let i = 0; i < Math.floor(ESTIMATE_CACHE_MAX_SIZE / 4); i++) {
+      ESTIMATE_CACHE.delete(keys[i]);
+    }
+  }
+  const estimate = compute();
+  ESTIMATE_CACHE.set(key, estimate);
+  return estimate;
+}
 function estimateToolInputTokens(input) {
   if (typeof input === "string") return RoughTokenEstimate(input);
-  if (input !== null && typeof input === "object" && "__tokenEstimate" in input) {
-    return input.__tokenEstimate;
-  }
-  const str = typeof input === "object" ? JSON.stringify(input) : String(input);
-  const estimate = RoughTokenEstimate(str);
-  if (input !== null && typeof input === "object" && !Array.isArray(input)) {
-    input.__tokenEstimate = estimate;
+  if (input === null || typeof input !== "object") {
+    return RoughTokenEstimate(String(input));
   }
-  return estimate;
+  const key = JSON.stringify(input);
+  return getCachedEstimate(key, () => RoughTokenEstimate(key));
 }
 function estimateToolResultTokens(content) {
   if (typeof content === "string") return RoughTokenEstimate(content);
-  return RoughTokenEstimate(JSON.stringify(content));
+  const key = JSON.stringify(content);
+  return getCachedEstimate(key, () => RoughTokenEstimate(key));
 }
 function estimateTextTokens(text) {
   return RoughTokenEstimate(text);
@@ -2010,9 +2174,18 @@ var HybridCompactor = class {
       }
     }
     let saved = 0;
-    for (let i = 0; i < preserveStart; i++) {
+    let changed = false;
+    const nextMessages = new Array(messages.length);
+    for (let i = 0; i < messages.length; i++) {
       const msg = messages[i];
-      if (!msg || !Array.isArray(msg.content)) continue;
+      if (i >= preserveStart) {
+        nextMessages[i] = msg;
+        continue;
+      }
+      if (!msg || !Array.isArray(msg.content)) {
+        nextMessages[i] = msg;
+        continue;
+      }
       const newContent = msg.content.map((b) => {
         if (b.type !== "tool_result") return b;
         const tokens = estimateToolResultTokens(b.content);
@@ -2026,8 +2199,14 @@ var HybridCompactor = class {
         };
         return elided;
       });
-      messages[i] = { ...msg, content: newContent };
+      if (newContent.length === msg.content.length && newContent.every((b, idx) => b === msg.content[idx])) {
+        nextMessages[i] = msg;
+      } else {
+        nextMessages[i] = { ...msg, content: newContent };
+        changed = true;
+      }
     }
+    if (changed) ctx.state.replaceMessages(nextMessages);
     return saved;
   }
   collapseAncientTurns(ctx) {
@@ -2061,10 +2240,10 @@ var HybridCompactor = class {
     let total = 0;
     for (const m of messages) {
       if (typeof m.content === "string") {
-        total += estimateTextTokens(m.content);
+        total += this.estimator(m.content);
       } else {
         for (const b of m.content) {
-          if (b.type === "text") total += estimateTextTokens(b.text);
+          if (b.type === "text") total += this.estimator(b.text);
           else if (b.type === "tool_use") total += estimateToolInputTokens(b.input);
           else if (b.type === "tool_result") total += estimateToolResultTokens(b.content);
         }
@@ -2109,7 +2288,7 @@ var IntelligentCompactor = class {
     const beforeTokens = this.estimateTokens(ctx.messages);
     const reductions = [];
     const load = beforeTokens / this.maxContext;
-    const aggressive = opts.aggressive ?? load >= this.softThreshold;
+    const aggressive = load >= this.hardThreshold ? true : opts.aggressive ?? load >= this.softThreshold;
     const saved1 = this.eliseOldToolResults(ctx);
     if (saved1 > 0) reductions.push({ phase: "elision", saved: saved1 });
     if (aggressive) {
@@ -2218,9 +2397,18 @@ var IntelligentCompactor = class {
       }
     }
     let saved = 0;
-    for (let i = 0; i < preserveStart; i++) {
+    let changed = false;
+    const nextMessages = new Array(messages.length);
+    for (let i = 0; i < messages.length; i++) {
       const msg = messages[i];
-      if (!msg || !Array.isArray(msg.content)) continue;
+      if (i >= preserveStart) {
+        nextMessages[i] = msg;
+        continue;
+      }
+      if (!msg || !Array.isArray(msg.content)) {
+        nextMessages[i] = msg;
+        continue;
+      }
       const newContent = msg.content.map((b) => {
         if (b.type !== "tool_result") return b;
         const tokens = estimateToolResultTokens(b.content);
@@ -2233,8 +2421,14 @@ var IntelligentCompactor = class {
           is_error: b.is_error
         };
       });
-      messages[i] = { ...msg, content: newContent };
+      if (newContent.length === msg.content.length && newContent.every((b, idx) => b === msg.content[idx])) {
+        nextMessages[i] = msg;
+      } else {
+        nextMessages[i] = { ...msg, content: newContent };
+        changed = true;
+      }
     }
+    if (changed) ctx.state.replaceMessages(nextMessages);
     return saved;
   }
   hasTextContent(m) {
@@ -2387,7 +2581,7 @@ IMPORTANT: Total conversation (${totalTokens} tokens) exceeds budget (${effectiv
     const jsonEnd = raw.lastIndexOf("}");
     if (jsonStart === -1 || jsonEnd === -1) {
       return this.fallbackSelect(
-        Array.from({ length: messageCount }, (_, i) => ({ role: "user", content: "" })),
+        Array.from({ length: messageCount }, () => ({ role: "user", content: "" })),
         this.maxContextTokens
       );
     }
@@ -2396,7 +2590,7 @@ IMPORTANT: Total conversation (${totalTokens} tokens) exceeds budget (${effectiv
       parsed = JSON.parse(raw.slice(jsonStart, jsonEnd + 1));
     } catch {
       return this.fallbackSelect(
-        Array.from({ length: messageCount }, (_, i) => ({ role: "user", content: "" })),
+        Array.from({ length: messageCount }, () => ({ role: "user", content: "" })),
         this.maxContextTokens
       );
     }
@@ -2449,7 +2643,7 @@ var SelectiveCompactor = class {
     const savedElision = this.eliseOldToolResults(ctx);
     if (savedElision > 0) reductions.push({ phase: "elision", saved: savedElision });
     const afterPhase1 = this.estimateTokens(ctx.messages);
-    const targetBudget = this.computeTargetBudget(load, opts.aggressive ?? false);
+    const targetBudget = this.computeTargetBudget(load);
     if (afterPhase1 > targetBudget) {
       const savedSelective = await this.runSelector(ctx, targetBudget);
       if (savedSelective > 0) reductions.push({ phase: "selective", saved: savedSelective });
@@ -2467,7 +2661,7 @@ var SelectiveCompactor = class {
     try {
       result = await this.selector.select(ctx.messages, targetBudget);
     } catch {
-      return this.aggressiveRecencyTrim(ctx, targetBudget);
+      return this.aggressiveRecencyTrim(ctx);
     }
     await this.executePlan(ctx, result);
     const after = this.estimateTokens(ctx.messages);
@@ -2522,9 +2716,8 @@ Summarize the following message range:`;
    * Fallback when selector fails: aggressively trim from the oldest end
    * until we hit targetBudget.
    */
-  aggressiveRecencyTrim(ctx, targetBudget) {
+  aggressiveRecencyTrim(ctx) {
     const messages = ctx.messages;
-    this.estimateTokens(messages);
     const preserveIdx = Math.max(0, messages.length - this.preserveK * 2);
     if (preserveIdx <= 0) return 0;
     let boundary = preserveIdx;
@@ -2545,7 +2738,7 @@ Summarize the following message range:`;
     ctx.state.replaceMessages([summaryMsg, ...tail]);
     return Math.max(0, removedTokens - this.estimateTokens([summaryMsg]));
   }
-  computeTargetBudget(load, aggressive) {
+  computeTargetBudget(load) {
     if (load >= this.hardThreshold) {
       return Math.floor(this.maxContext * 0.5);
     }
@@ -2567,9 +2760,18 @@ Summarize the following message range:`;
       }
     }
     let saved = 0;
-    for (let i = 0; i < preserveStart; i++) {
+    let changed = false;
+    const nextMessages = new Array(messages.length);
+    for (let i = 0; i < messages.length; i++) {
       const msg = messages[i];
-      if (!msg || !Array.isArray(msg.content)) continue;
+      if (i >= preserveStart) {
+        nextMessages[i] = msg;
+        continue;
+      }
+      if (!msg || !Array.isArray(msg.content)) {
+        nextMessages[i] = msg;
+        continue;
+      }
       const newContent = msg.content.map((b) => {
         if (b.type !== "tool_result") return b;
         const text = typeof b.content === "string" ? b.content : JSON.stringify(b.content);
@@ -2583,8 +2785,14 @@ Summarize the following message range:`;
           is_error: b.is_error
         };
       });
-      messages[i] = { ...msg, content: newContent };
+      if (newContent.every((b, idx) => b === msg.content[idx])) {
+        nextMessages[i] = msg;
+      } else {
+        nextMessages[i] = { ...msg, content: newContent };
+        changed = true;
+      }
     }
+    if (changed) ctx.state.replaceMessages(nextMessages);
     return saved;
   }
   hasTextContent(m) {
@@ -2620,46 +2828,78 @@ var AutoCompactionMiddleware = class {
   name = "AutoCompaction";
   compactor;
   warnThreshold;
-  // fraction of maxContext (0-1)
   softThreshold;
   hardThreshold;
   maxContext;
   estimator;
   aggressiveOn;
+  events;
+  failureMode;
   /**
-   * @param compactor        Compactor to use for compaction
-   * @param maxContext       Provider's max context window in tokens
-   * @param estimator        Token estimation function (ctx → token count)
-   * @param thresholds      Threshold fractions (0-1) of maxContext
-   * @param aggressiveOn    Which threshold triggers aggressive (full LLM summarization)
+   * @param compactor        Compactor to use for compaction.
+   * @param maxContext       Provider's max context window in tokens.
+   * @param estimator        Token estimation function.
+   * @param thresholds       Threshold fractions (0-1) of maxContext.
+   * @param opts             Optional behavior. By default, failures at the
+   *                         hard threshold throw AGENT_CONTEXT_OVERFLOW so
+   *                         the agent does not continue into a likely
+   *                         provider context overflow. Warn/soft failures
+   *                         still emit compaction.failed and continue.
    */
-  constructor(compactor, maxContext, estimator, thresholds, aggressiveOn = "soft") {
+  constructor(compactor, maxContext, estimator, thresholds, optsOrAggressiveOn = {}, events) {
+    const opts = typeof optsOrAggressiveOn === "string" ? { aggressiveOn: optsOrAggressiveOn, events } : optsOrAggressiveOn;
     this.compactor = compactor;
     this.maxContext = maxContext;
     this.estimator = estimator;
     this.warnThreshold = thresholds.warn;
     this.softThreshold = thresholds.soft;
     this.hardThreshold = thresholds.hard;
-    this.aggressiveOn = aggressiveOn;
+    this.aggressiveOn = opts.aggressiveOn ?? "soft";
+    this.events = opts.events;
+    this.failureMode = opts.failureMode ?? "throw_on_hard";
   }
   handler() {
     return async (ctx, next) => {
       const tokens = this.estimator(ctx);
       const load = tokens / this.maxContext;
       if (load >= this.hardThreshold) {
-        await this.compact(ctx, true);
+        await this.compact(ctx, true, { level: "hard", tokens, load });
       } else if (load >= this.softThreshold) {
-        await this.compact(ctx, this.aggressiveOn !== "hard");
+        await this.compact(ctx, this.aggressiveOn !== "hard", { level: "soft", tokens, load });
       } else if (load >= this.warnThreshold) {
-        await this.compact(ctx, false);
+        await this.compact(ctx, false, { level: "warn", tokens, load });
       }
       return next(ctx);
     };
   }
-  async compact(ctx, aggressive) {
+  async compact(ctx, aggressive, pressure) {
     try {
       await this.compactor.compact(ctx, { aggressive });
-    } catch {
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      const fatal = this.failureMode === "throw" || this.failureMode === "throw_on_hard" && pressure.level === "hard";
+      this.events?.emit("compaction.failed", {
+        err: error,
+        aggressive,
+        level: pressure.level,
+        tokens: pressure.tokens,
+        maxContext: this.maxContext,
+        load: pressure.load,
+        fatal
+      });
+      if (fatal) {
+        throw new AgentError({
+          message: `Auto-compaction failed at ${pressure.level} threshold`,
+          code: "AGENT_CONTEXT_OVERFLOW",
+          recoverable: true,
+          context: {
+            level: pressure.level,
+            tokens: pressure.tokens,
+            maxContext: this.maxContext
+          },
+          cause: err
+        });
+      }
     }
   }
 };
@@ -3173,8 +3413,9 @@ var DefaultMultiAgentCoordinator = class extends EventEmitter {
     const context = {
       subagentId: id,
       tasks: [],
-      // parentBridge: wired by the caller via setSubagentBridge() once the
-      // bidirectional bridge is created. Reads gated by hasParentBridge().
+      // Wired later by the caller via setSubagentBridge() once the
+      // bidirectional bridge is created. Readers must null-check / use
+      // hasParentBridge() — the type now reflects this.
       parentBridge: null,
       doneCondition: this.config.doneCondition,
       maxConcurrent: this.config.maxConcurrent ?? 4
@@ -3219,9 +3460,7 @@ var DefaultMultiAgentCoordinator = class extends EventEmitter {
     this.emit("subagent.stopped", { subagentId, reason: "stopped by coordinator" });
   }
   async stopAll() {
-    for (const id of this.subagents.keys()) {
-      await this.stop(id);
-    }
+    await Promise.allSettled([...this.subagents.keys()].map((id) => this.stop(id)));
   }
   getStatus() {
     return {
@@ -3257,7 +3496,17 @@ var DefaultMultiAgentCoordinator = class extends EventEmitter {
       if (!subagentId) return;
       const task = this.pendingTasks.shift();
       if (!task) return;
-      void this.runDispatched(subagentId, task);
+      this.runDispatched(subagentId, task).catch((err) => {
+        this.recordCompletion({
+          subagentId,
+          taskId: task.id,
+          status: "failed",
+          error: err instanceof Error ? err.message : String(err),
+          iterations: 0,
+          toolCalls: 0,
+          durationMs: 0
+        });
+      });
     }
   }
   canDispatch() {
@@ -3277,7 +3526,6 @@ var DefaultMultiAgentCoordinator = class extends EventEmitter {
     subagent.currentTask = task.id;
     task.subagentId = subagentId;
     subagent.context.tasks.push(task);
-    this.inFlight++;
     this.emit("task.assigned", { task, subagentId });
     const budget = new SubagentBudget({
       maxIterations: subagent.config.maxIterations ?? this.config.defaultBudget?.maxIterations,
@@ -3287,6 +3535,10 @@ var DefaultMultiAgentCoordinator = class extends EventEmitter {
       timeoutMs: task.timeoutMs ?? subagent.config.timeoutMs ?? this.config.defaultBudget?.timeoutMs
     });
     subagent.activeBudget = budget;
+    if (!this.runner) {
+      return;
+    }
+    this.inFlight++;
     const startTime = Date.now();
     const runCtx = {
       subagentId,
@@ -3296,9 +3548,6 @@ var DefaultMultiAgentCoordinator = class extends EventEmitter {
       bridge: subagent.context.parentBridge || null
     };
     let result;
-    if (!this.runner) {
-      return;
-    }
     budget.start();
     try {
       const outcome = await this.executeWithTimeout(this.runner, task, runCtx, budget);
@@ -3313,13 +3562,14 @@ var DefaultMultiAgentCoordinator = class extends EventEmitter {
       };
     } catch (err) {
       const status = err instanceof BudgetExceededError && err.kind === "timeout" ? "timeout" : subagent.abortController.signal.aborted ? "stopped" : "failed";
+      const usage = budget.usage();
       result = {
         subagentId,
         taskId: task.id,
         status,
         error: err instanceof Error ? err.message : String(err),
-        iterations: budget.usage().iterations,
-        toolCalls: budget.usage().toolCalls,
+        iterations: usage.iterations,
+        toolCalls: usage.toolCalls,
         durationMs: Date.now() - startTime
       };
     }
@@ -3344,11 +3594,24 @@ var DefaultMultiAgentCoordinator = class extends EventEmitter {
   recordCompletion(result) {
     this.completedResults.push(result);
     this.totalIterations += result.iterations;
-    this.inFlight = Math.max(0, this.inFlight - 1);
+    if (this.inFlight > 0) {
+      this.inFlight--;
+    } else if (this.runner) {
+      this.emit("warning", {
+        type: "inFlight_underflow",
+        taskId: result.taskId,
+        subagentId: result.subagentId
+      });
+      return;
+    }
     const subagent = this.subagents.get(result.subagentId);
     if (subagent && subagent.status !== "stopped") {
-      subagent.status = result.status === "failed" || result.status === "timeout" ? "error" : "idle";
+      const failed = result.status === "failed" || result.status === "timeout";
+      subagent.status = failed ? "error" : "idle";
       subagent.currentTask = void 0;
+      if (subagent.abortController.signal.aborted) {
+        subagent.abortController = new AbortController();
+      }
       if (subagent.status === "error") {
         queueMicrotask(() => {
           if (subagent.status === "error") subagent.status = "idle";
@@ -3536,6 +3799,11 @@ var InMemoryAgentBridge = class {
     if (this.stopped) throw new Error("Bridge is stopped");
     const timeout = timeoutMs ?? this.timeoutMs;
     const correlationId = msg.id;
+    if (this.pendingRequests.has(correlationId)) {
+      throw new Error(
+        `Bridge request id "${correlationId}" collides with an in-flight request \u2014 caller is reusing message ids`
+      );
+    }
     return new Promise((resolve3, reject) => {
       const timer = setTimeout(() => {
         this.pendingRequests.delete(correlationId);
@@ -3576,8 +3844,10 @@ function createMessage(type, from, payload, to) {
 var DoneConditionChecker = class {
   constructor(condition) {
     this.condition = condition;
+    this.compiledRegex = condition.type === "output_match" && condition.pattern ? new RegExp(condition.pattern) : null;
   }
   condition;
+  compiledRegex;
   check(state) {
     switch (this.condition.type) {
       case "iterations":
@@ -3591,11 +3861,8 @@ var DoneConditionChecker = class {
         }
         break;
       case "output_match":
-        if (this.condition.pattern && state.lastOutput) {
-          const regex = new RegExp(this.condition.pattern);
-          if (regex.test(state.lastOutput)) {
-            return { done: true, reason: `output matched pattern "${this.condition.pattern}"`, ...state };
-          }
+        if (this.compiledRegex && state.lastOutput && this.compiledRegex.test(state.lastOutput)) {
+          return { done: true, reason: `output matched pattern "${this.condition.pattern}"`, ...state };
         }
         break;
     }
@@ -3652,7 +3919,8 @@ var AutonomousRunner = class {
           return failedResult;
         }
       } catch (e) {
-        if (e.message.includes("timeout")) {
+        const msg = e instanceof Error ? e.message : String(e);
+        if (msg.includes("timeout")) {
           const timeoutResult = {
             status: "failed",
             error: toWrongStackError(e),
@@ -3681,14 +3949,11 @@ var AutonomousRunner = class {
 
 // src/defaults/spec-parser.ts
 var SpecParser = class {
-  constructor(opts = {}) {
-    this.opts = opts;
-  }
-  opts;
   parse(content) {
     const lines = content.split("\n");
     const sections = this.extractSections(lines);
     const requirements = this.extractRequirements(lines);
+    const now = Date.now();
     return {
       id: crypto.randomUUID(),
       title: this.extractTitle(lines),
@@ -3697,8 +3962,8 @@ var SpecParser = class {
       overview: this.extractOverview(lines),
       sections,
       requirements,
-      createdAt: Date.now(),
-      updatedAt: Date.now()
+      createdAt: now,
+      updatedAt: now
     };
   }
   extractTitle(lines) {
@@ -3790,20 +4055,13 @@ var SpecParser = class {
   parseRequirementLine(line, id) {
     const trimmed = line.trim();
     if (!trimmed || trimmed.startsWith("#")) return null;
-    const typeMap = {
-      "functional": "functional",
-      "non-functional": "non-functional",
-      "security": "security",
-      "performance": "performance",
-      "ux": "ux"
-    };
+    const lower = trimmed.toLowerCase();
+    const types = ["functional", "non-functional", "security", "performance", "ux"];
     let type = "functional";
-    let priority = "medium";
-    for (const [key, val] of Object.entries(typeMap)) {
-      if (trimmed.toLowerCase().includes(`[${key}]`)) {
-        type = val;
-      }
+    for (const t of types) {
+      if (lower.includes(`[${t}]`)) type = t;
     }
+    let priority = "medium";
     if (trimmed.includes("[critical]") || trimmed.includes("[prio:high]")) {
       priority = "critical";
     } else if (trimmed.includes("[high]")) {
@@ -3893,9 +4151,10 @@ var SpecParser = class {
         warnings.push({ path: `requirement.${req.id}`, message: "No acceptance criteria defined" });
       }
     }
+    const reqIds = new Set(spec.requirements.map((r) => r.id));
     const blockedByIds = new Set(spec.requirements.flatMap((r) => r.blockedBy ?? []));
     for (const id of blockedByIds) {
-      if (!spec.requirements.find((r) => r.id === id)) {
+      if (!reqIds.has(id)) {
         errors.push({ path: "requirements", message: `BlockedBy references non-existent requirement: ${id}` });
       }
     }
@@ -3925,25 +4184,21 @@ var TaskGenerator = class {
         status: "pending"
       });
     }
-    const criticalReqs = spec.requirements.filter((r) => r.priority === "critical");
-    const highReqs = spec.requirements.filter((r) => r.priority === "high");
-    const mediumReqs = spec.requirements.filter((r) => r.priority === "medium");
-    const lowReqs = spec.requirements.filter((r) => r.priority === "low");
-    for (const req of criticalReqs) {
-      const task = this.createTaskFromRequirement(req, spec.title);
-      this.opts.taskTracker.addNode(task);
-    }
-    for (const req of highReqs) {
-      const task = this.createTaskFromRequirement(req, spec.title);
-      this.opts.taskTracker.addNode(task);
-    }
-    for (const req of mediumReqs) {
-      const task = this.createTaskFromRequirement(req, spec.title);
-      this.opts.taskTracker.addNode(task);
+    const byPriority = {
+      critical: [],
+      high: [],
+      medium: [],
+      low: []
+    };
+    for (const req of spec.requirements) {
+      const bucket = byPriority[req.priority] ?? byPriority.medium;
+      bucket.push(req);
     }
-    for (const req of lowReqs) {
-      const task = this.createTaskFromRequirement(req, spec.title);
-      this.opts.taskTracker.addNode(task);
+    const order = ["critical", "high", "medium", "low"];
+    for (const p of order) {
+      for (const req of byPriority[p]) {
+        this.opts.taskTracker.addNode(this.createTaskFromRequirement(req));
+      }
     }
     if (spec.apiEndpoints && spec.apiEndpoints.length > 0) {
       const apiParent = this.opts.taskTracker.addNode({
@@ -3977,17 +4232,15 @@ var TaskGenerator = class {
     });
     return graph;
   }
-  createTaskFromRequirement(req, specTitle) {
-    const type = this.mapRequirementType(req.type);
-    const tags = [req.type, req.priority];
+  createTaskFromRequirement(req) {
     return {
       title: req.description,
-      description: this.buildDescription(req, specTitle),
-      type,
-      priority: this.mapPriority(req.priority),
+      description: this.buildDescription(req),
+      type: this.mapRequirementType(req.type),
+      priority: req.priority,
       status: "pending",
       specRequirementId: req.id,
-      tags,
+      tags: [req.type, req.priority],
       estimateHours: this.estimateHours(req)
     };
   }
@@ -4002,7 +4255,7 @@ var TaskGenerator = class {
       estimateHours: this.estimateForEndpoint(endpoint)
     };
   }
-  buildDescription(req, specTitle) {
+  buildDescription(req) {
     const lines = [
       req.description,
       "",
@@ -4036,20 +4289,6 @@ var TaskGenerator = class {
         return "feature";
     }
   }
-  mapPriority(priority) {
-    switch (priority) {
-      case "critical":
-        return "critical";
-      case "high":
-        return "high";
-      case "medium":
-        return "medium";
-      case "low":
-        return "low";
-      default:
-        return "medium";
-    }
-  }
   estimateHours(req) {
     switch (req.priority) {
       case "critical":
@@ -4120,16 +4359,33 @@ var DefaultTaskStore = class {
 
 // src/types/task-graph.ts
 function computeTaskProgress(graph) {
-  const nodes = Array.from(graph.nodes.values());
-  const total = nodes.length;
-  const completed = nodes.filter((n) => n.status === "completed").length;
-  const pending = nodes.filter((n) => n.status === "pending").length;
-  const inProgress = nodes.filter((n) => n.status === "in_progress").length;
-  const blocked = nodes.filter((n) => n.status === "blocked").length;
-  const failed = nodes.filter((n) => n.status === "failed").length;
-  const review = nodes.filter((n) => n.status === "review").length;
-  const estimatedHours = nodes.reduce((sum, n) => sum + (n.estimateHours ?? 0), 0);
-  const actualHours = nodes.reduce((sum, n) => sum + (n.actualHours ?? 0), 0);
+  let completed = 0, pending = 0, inProgress = 0, blocked = 0, failed = 0, review = 0;
+  let estimatedHours = 0, actualHours = 0;
+  for (const n of graph.nodes.values()) {
+    switch (n.status) {
+      case "completed":
+        completed++;
+        break;
+      case "pending":
+        pending++;
+        break;
+      case "in_progress":
+        inProgress++;
+        break;
+      case "blocked":
+        blocked++;
+        break;
+      case "failed":
+        failed++;
+        break;
+      case "review":
+        review++;
+        break;
+    }
+    estimatedHours += n.estimateHours ?? 0;
+    actualHours += n.actualHours ?? 0;
+  }
+  const total = graph.nodes.size;
   return {
     total,
     pending,
@@ -4185,40 +4441,40 @@ var TaskTracker = class {
       this.graph.rootNodes.push(newNode.id);
     }
     this.graph.updatedAt = now;
-    this.opts.store.saveGraph(this.graph);
+    this.persist();
     return newNode;
   }
   addEdge(from, to, type = "depends_on") {
     if (!this.graph) throw new Error("No graph loaded");
-    const edge = {
+    this.graph.edges.push({
       id: crypto.randomUUID(),
       from,
       to,
       type
-    };
-    this.graph.edges.push(edge);
+    });
     this.graph.updatedAt = Date.now();
-    this.opts.store.saveGraph(this.graph);
+    this.persist();
   }
   updateNodeStatus(id, status, reason) {
     if (!this.graph) throw new Error("No graph loaded");
     const node = this.graph.nodes.get(id);
     if (!node) throw new Error(`Node ${id} not found`);
     const from = node.status;
+    const now = Date.now();
     node.status = status;
-    node.updatedAt = Date.now();
+    node.updatedAt = now;
     if (status === "completed") {
-      node.completedAt = Date.now();
+      node.completedAt = now;
     }
-    this.transitions.push({ from, to: status, timestamp: Date.now(), reason });
+    this.transitions.push({ from, to: status, timestamp: now, reason });
     if (status === "completed") {
       this.unblockDependents(id);
     }
     if (status === "in_progress") {
       this.checkAndBlockIfNeeded(id);
     }
-    this.graph.updatedAt = Date.now();
-    this.opts.store.saveGraph(this.graph);
+    this.graph.updatedAt = now;
+    this.persist();
   }
   getNode(id) {
     return this.graph?.nodes.get(id);
@@ -4239,9 +4495,7 @@ var TaskTracker = class {
     }
     if (sort) {
       nodes.sort((a, b) => {
-        const aVal = a[sort.field] ?? "";
-        const bVal = b[sort.field] ?? "";
-        const cmp = aVal < bVal ? -1 : aVal > bVal ? 1 : 0;
+        const cmp = compareByField(a, b, sort.field);
         return sort.direction === "asc" ? cmp : -cmp;
       });
     }
@@ -4320,7 +4574,47 @@ var TaskTracker = class {
       }
     }
   }
+  /**
+   * Fire-and-forget persistence with attached error handler.
+   * Synchronous mutators (addNode/addEdge/updateNodeStatus) use this to
+   * avoid forcing an async cascade through every caller; if the store
+   * rejects, the configured `onPersistError` is invoked so failures are
+   * surfaced instead of swallowed by an unhandled promise rejection.
+   */
+  persist() {
+    if (!this.graph) return;
+    this.opts.store.saveGraph(this.graph).catch((err) => {
+      if (this.opts.onPersistError) this.opts.onPersistError(err);
+      else console.warn("[task-tracker] saveGraph failed:", err instanceof Error ? err.message : String(err));
+    });
+  }
+};
+var PRIORITY_RANK = {
+  critical: 0,
+  high: 1,
+  medium: 2,
+  low: 3
+};
+var STATUS_RANK = {
+  in_progress: 0,
+  pending: 1,
+  review: 2,
+  blocked: 3,
+  failed: 4,
+  completed: 5
 };
+function compareByField(a, b, field) {
+  switch (field) {
+    case "priority":
+      return PRIORITY_RANK[a.priority] - PRIORITY_RANK[b.priority];
+    case "status":
+      return STATUS_RANK[a.status] - STATUS_RANK[b.status];
+    case "createdAt":
+      return a.createdAt - b.createdAt;
+    case "updatedAt":
+      return a.updatedAt - b.updatedAt;
+  }
+}
 
 // src/defaults/task-flow.ts
 var TaskFlow = class {
@@ -4372,9 +4666,10 @@ var TaskFlow = class {
         const task = batch[i];
         if (!result || !task) continue;
         if (result.status === "rejected") {
-          this.opts.tracker.updateNodeStatus(task.id, "failed", result.reason?.message);
-          this.emit("task.failed", { taskId: task.id, error: result.reason?.message ?? "unknown" });
-          ctx.onTaskFail?.(task, result.reason);
+          const reason = result.reason;
+          this.opts.tracker.updateNodeStatus(task.id, "failed", reason?.message);
+          this.emit("task.failed", { taskId: task.id, error: reason?.message ?? "unknown" });
+          ctx.onTaskFail?.(task, reason);
         } else {
           this.opts.tracker.updateNodeStatus(task.id, "completed");
           this.emit("task.completed", { taskId: task.id, result: result.value });
@@ -4657,7 +4952,6 @@ function createToolOutputSerializer(opts = {}) {
     }
     const half = Math.floor(available / 2);
     const first = text.slice(0, half);
-    Buffer.byteLength(first, "utf8");
     const second = text.slice(text.length - half);
     return { text: `${first}${marker}${second}`, newBudget: 0 };
   }
@@ -4707,7 +5001,7 @@ var ToolExecutor = class {
             return { result, tool, durationMs: Date.now() - start };
           }
         } else {
-          const suggestedPattern = this.subjectFor(tool.name, use.input) ?? tool.name;
+          const suggestedPattern = this.subjectFor(tool.name, use.input, tool.subjectKey) ?? tool.name;
           const pending = { type: "tool_confirm_pending", toolUseId: use.id, toolName: tool.name, input: use.input, suggestedPattern };
           return { result: pending, tool, durationMs: Date.now() - start };
         }
@@ -4739,15 +5033,31 @@ var ToolExecutor = class {
         span?.end();
       }
     };
+    const safeRun = async (use) => {
+      try {
+        return await runOne(use);
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        const scrubbed = this.opts.secretScrubber.scrub(msg);
+        const result = {
+          type: "tool_result",
+          tool_use_id: use.id,
+          content: `Tool "${use.name}" execution failed: ${scrubbed}`,
+          is_error: true
+        };
+        budget = this.decrementBudget(result, budget);
+        return { result, tool: this.registry.get(use.name), durationMs: 0 };
+      }
+    };
     if (strategy === "sequential") {
       const outputs = [];
       for (const use of toolUses) {
-        if (use) outputs.push(await runOne(use));
+        if (use) outputs.push(await safeRun(use));
       }
       return { outputs, remainingBudget: budget };
     }
     if (strategy === "parallel") {
-      const outputs = await Promise.all(toolUses.map((use) => runOne(use)));
+      const outputs = await Promise.all(toolUses.map((use) => safeRun(use)));
       return { outputs, remainingBudget: budget };
     }
     const nonMutating = [];
@@ -4758,10 +5068,10 @@ var ToolExecutor = class {
       if (tool?.mutating) mutating.push(use);
       else nonMutating.push(use);
     }
-    const firstPass = await Promise.all(nonMutating.map((use) => runOne(use)));
+    const firstPass = await Promise.all(nonMutating.map((use) => safeRun(use)));
     const secondPass = [];
     for (const use of mutating) {
-      secondPass.push(await runOne(use));
+      secondPass.push(await safeRun(use));
     }
     return {
       outputs: [...firstPass, ...secondPass],
@@ -4796,7 +5106,8 @@ var ToolExecutor = class {
   }
   async runWithTimeout(tool, input, parentSignal, ctx, toolUseId) {
     if (parentSignal.aborted) {
-      throw parentSignal.reason instanceof Error ? parentSignal.reason : new Error(typeof parentSignal.reason === "string" ? parentSignal.reason : "aborted");
+      if (parentSignal.reason instanceof Error) throw parentSignal.reason;
+      throw new Error(typeof parentSignal.reason === "string" ? parentSignal.reason : "aborted");
     }
     const timeoutMs = tool.timeoutMs ?? this.iterationTimeoutMs;
     const ctrl = new AbortController();
@@ -4865,16 +5176,23 @@ var ToolExecutor = class {
    * Matches the logic in DefaultPermissionPolicy so the TUI shows the
    * same subject that the trust file would use.
    */
-  subjectFor(toolName, input) {
+  subjectFor(toolName, input, subjectKey) {
     if (!input || typeof input !== "object") return void 0;
     const obj = input;
     const globChars = /[*?\[\]]/g;
     const escapeGlob = (s) => s.replace(globChars, (c) => `\\${c}`);
+    const normalizePath = (s) => escapeGlob(s.replace(/\\/g, "/"));
+    if (subjectKey) {
+      const v = obj[subjectKey];
+      if (typeof v === "string") {
+        return subjectKey === "path" || subjectKey === "file" || subjectKey === "files" ? normalizePath(v) : escapeGlob(v);
+      }
+    }
     if (toolName === "bash" && typeof obj.command === "string") {
       return escapeGlob(obj.command);
     }
     if (typeof obj.path === "string") {
-      return escapeGlob(obj.path.replace(/\\/g, "/"));
+      return normalizePath(obj.path);
     }
     if (typeof obj.url === "string") {
       return escapeGlob(obj.url);
@@ -5298,8 +5616,9 @@ var DefaultHealthRegistry = class {
     return { status, timestamp: Date.now(), checks: results };
   }
   async runOne(check) {
+    let timer = null;
     const timeout = new Promise((resolve3) => {
-      setTimeout(
+      timer = setTimeout(
         () => resolve3({ status: "unhealthy", detail: `timeout after ${this.timeoutMs}ms` }),
         this.timeoutMs
       );
@@ -5308,6 +5627,8 @@ var DefaultHealthRegistry = class {
       return await Promise.race([check.check(), timeout]);
     } catch (err) {
       return { status: "unhealthy", detail: err instanceof Error ? err.message : String(err) };
+    } finally {
+      if (timer) clearTimeout(timer);
     }
   }
 };
@@ -5946,7 +6267,6 @@ function createContextManagerTool(opts = {}) {
               notes: `Invalid range [${from}, ${to}] for ${messages.length} messages.`
             };
           }
-          messages.slice(from, to + 1);
           const summaryText = input.text ?? '[summary placeholder \u2014 provide "text" to record the summary]';
           const summaryMsg = {
             role: "system",