@hyperfixi/mcp-server 2.7.1 → 2.8.0

package/README.md

@@ -1,6 +1,6 @@
 # @hyperfixi/mcp-server
 
-MCP (Model Context Protocol) server for hyperscript and multilingual DSL development. Provides **80 tools**, 5 resources, and 3 prompts across 11 categories: validation, compilation, analysis, patterns, LSP bridge, language profiles, code generation, route extraction, 8 domain DSLs, IR conversion, and MCP sampling.
+MCP (Model Context Protocol) server for hyperscript and multilingual DSL development. Provides **107 tools**, **9 resources**, and **9 prompts** spanning: GRAIL workflow orchestration, validation, compilation, analysis, patterns, LSP bridge, language profiles, code generation, route extraction, 9 domain DSLs, IR conversion, cross-domain dispatch, MCP sampling, AI-assisted debugging, template inventory, and the LSE round-trip pipeline.
 
 ## Installation
 
@@ -59,7 +59,9 @@ Or if installed globally:
 
 See **[GRAIL.md](GRAIL.md)** for full documentation, schema reference, and examples.
 
-## Available Tools (80)
+## Available Tools
+
+The **102** tools below, plus the **5** GRAIL tools above, total **107**.
 
 ### Validation & Semantic Tools (8)
 
@@ -131,12 +133,15 @@ See **[GRAIL.md](GRAIL.md)** for full documentation, schema reference, and examp
 | `get_role_markers`          | Role markers (destination, source, patient, etc.) |
 | `compare_language_profiles` | Find translation gaps between languages           |
 
-### IR Conversion (2)
+### IR Conversion (5)
 
 | Tool                | Description                                          |
 | ------------------- | ---------------------------------------------------- |
 | `convert_format`    | Convert between explicit bracket syntax and LLM JSON |
 | `validate_explicit` | Validate bracket syntax without compilation (fast)   |
+| `validate_protocol` | Validate protocol JSON against the LSE 2.0 schema    |
+| `to_envelope`       | Wrap a node/protocol in a transport envelope         |
+| `from_envelope`     | Unwrap an envelope back to a node/protocol           |
 
 ### Route Extraction (2)
 
@@ -164,20 +169,70 @@ See **[GRAIL.md](GRAIL.md)** for full documentation, schema reference, and examp
 | `translate_content` | Translate text between natural languages               |
 | `execute_llm`       | Execute LLM command in natural language (8 languages)  |
 
-### Domain DSL Tools (32)
+### AI-Assisted Debugging (4)
+
+| Tool                     | Description                                                           |
+| ------------------------ | --------------------------------------------------------------------- |
+| `debug_analyze_snapshot` | Explain the current paused debugger state and predict the next step   |
+| `debug_explain_handler`  | Break down an event handler step-by-step; flag issues and breakpoints |
+| `debug_suggest_fix`      | Analyze a snapshot where something went wrong; suggest causes + fixes |
+| `debug_trace_variable`   | Trace how a variable changed across an execution-history snapshot set |
+
+### Template Inventory (2)
+
+| Tool              | Description                                                           |
+| ----------------- | --------------------------------------------------------------------- |
+| `scan_inventory`  | Scan a directory for hyperscript (`_=`), htmx (`hx-*`), fixi (`fx-*`) |
+| `query_inventory` | Search and filter within previously scanned inventory results         |
+
+### Training Data (1)
+
+| Tool                     | Description                                                    |
+| ------------------------ | -------------------------------------------------------------- |
+| `generate_training_data` | Synthesize (natural language, LSE) pairs from schemas as JSONL |
+
+### Feedback Loop (2)
+
+| Tool                        | Description                                                       |
+| --------------------------- | ----------------------------------------------------------------- |
+| `lse_validate_and_feedback` | Validate LSE and return machine-actionable correction hints       |
+| `lse_pattern_stats`         | Pattern hit-rate stats: success by command/language, top failures |
+
+### LSE Pipeline (5)
+
+| Tool                   | Description                                                     |
+| ---------------------- | --------------------------------------------------------------- |
+| `lse_from_hyperscript` | Parse hyperscript (24 languages) to LSE bracket + protocol JSON |
+| `lse_to_hyperscript`   | Validate/compile LSE or protocol JSON returned by an LLM        |
+| `execute_lse`          | Parse LSE, compile to JS, and return the execution result       |
+| `validate_lse`         | Validate LSE or protocol JSON without executing (pre-flight)    |
+| `translate_lse`        | Translate LSE bracket syntax to natural language (24 languages) |
+
+### LSE Correction (1)
+
+| Tool                           | Description                                                     |
+| ------------------------------ | --------------------------------------------------------------- |
+| `lse_generate_with_correction` | Stateless LSE generation + self-correction loop (prompt/schema) |
+
+### Domain DSL Tools (36)
+
+Each of the 9 domains exposes `parse_`, `compile_`, `validate_`, and `translate_` tools (9 × 4 = 36). Language coverage comes in three tiers:
 
-8 domains, each with `parse_`, `compile_`, `validate_`, `translate_` tools:
+- **Bridge (11):** en, es, ja, ar, ko, zh, tr, fr, de, pt, ru
+- **Classic (8):** en, es, ja, ar, ko, zh, tr, fr
+- **Learn (10):** Bridge minus ru
 
-| Domain         | Languages                      | compile Output                    |
-| -------------- | ------------------------------ | --------------------------------- |
-| `sql`          | en, es, ja, ar, ko, zh, tr, fr | SQL query string                  |
-| `bdd`          | en, es, ja, ar                 | Playwright test (Given/When/Then) |
-| `jsx`          | en, es, ja, ar, ko, zh, tr, fr | JSX/React markup                  |
-| `todo`         | en, es, ja, ar, ko, zh, tr, fr | Structured operation object       |
-| `behaviorspec` | en, es, ja, ar, ko, zh, tr, fr | Playwright interaction test       |
-| `llm`          | en, es, ja, ar, ko, zh, tr, fr | LLMPromptSpec JSON                |
-| `flow`         | en, es, ja, ar, ko, zh, tr, fr | Reactive data flow JS             |
-| `voice`        | en, es, ja, ar, ko, zh, tr, fr | DOM interaction command           |
+| Domain         | Languages   | compile Output                    |
+| -------------- | ----------- | --------------------------------- |
+| `sql`          | Bridge (11) | SQL query string                  |
+| `bdd`          | Classic (8) | Playwright test (Given/When/Then) |
+| `jsx`          | Bridge (11) | JSX/React markup                  |
+| `todo`         | Bridge (11) | Structured operation object       |
+| `behaviorspec` | Classic (8) | Playwright interaction test       |
+| `llm`          | Bridge (11) | LLMPromptSpec JSON                |
+| `flow`         | Bridge (11) | Reactive data flow JS             |
+| `voice`        | Bridge (11) | DOM interaction command           |
+| `learn`        | Learn (10)  | Rendered sentence w/ morphology   |
 
 ## Available Resources (5)
 
@@ -209,7 +264,7 @@ See **[GRAIL.md](GRAIL.md)** for full documentation, schema reference, and examp
 
 ```bash
 npm run dev        # Development mode
-npm test           # Run tests (375 tests)
+npm test           # Run tests (420 tests)
 npm run typecheck  # TypeScript validation
 npm run build      # Build
 ```

package/dist/{esm-YPGJSQ36.js → esm-65HZKQ6R.js}

@@ -129,8 +129,8 @@ function expand_(str, max, isTop) {
     const pre = m.pre;
     if (/\$$/.test(m.pre)) {
       const post2 = m.post.length ? expand_(m.post, max, false) : [""];
-      for (let k2 = 0; k2 < post2.length && k2 < max; k2++) {
-        const expansion = pre + "{" + m.body + "}" + post2[k2];
+      for (let k = 0; k < post2.length && k < max; k++) {
+        const expansion = pre + "{" + m.body + "}" + post2[k];
         expansions.push(expansion);
       }
       return expansions;
@@ -162,19 +162,19 @@ function expand_(str, max, isTop) {
     }
     let N;
     if (isSequence && n[0] !== void 0 && n[1] !== void 0) {
-      const x2 = numeric(n[0]);
+      const x = numeric(n[0]);
       const y = numeric(n[1]);
       const width = Math.max(n[0].length, n[1].length);
       let incr = n.length === 3 && n[2] !== void 0 ? Math.max(Math.abs(numeric(n[2])), 1) : 1;
       let test = lte;
-      const reverse = y < x2;
+      const reverse = y < x;
       if (reverse) {
         incr *= -1;
         test = gte;
       }
       const pad = n.some(isPadded);
       N = [];
-      for (let i = x2; test(i, y) && N.length < max; i += incr) {
+      for (let i = x; test(i, y) && N.length < max; i += incr) {
         let c;
         if (isAlphaSequence) {
           c = String.fromCharCode(i);
@@ -204,8 +204,8 @@ function expand_(str, max, isTop) {
       }
     }
     for (let j2 = 0; j2 < N.length; j2++) {
-      for (let k2 = 0; k2 < post.length && expansions.length < max; k2++) {
-        const expansion = pre + N[j2] + post[k2];
+      for (let k = 0; k < post.length && expansions.length < max; k++) {
+        const expansion = pre + N[j2] + post[k];
         if (!isTop || isSequence || expansion) {
           expansions.push(expansion);
         }
@@ -280,7 +280,7 @@ var parseClass = (glob2, position) => {
       }
     }
     if (c === "[" && !escaping) {
-      for (const [cls, [unip, u, neg]] of Object.entries(posixClasses)) {
+      for (const [cls, [unip, u3, neg]] of Object.entries(posixClasses)) {
         if (glob2.startsWith(cls, i)) {
           if (rangeStart) {
             return ["$.", false, glob2.length - pos, true];
@@ -290,7 +290,7 @@ var parseClass = (glob2, position) => {
             negs.push(unip);
           else
             ranges.push(unip);
-          uflag = uflag || u;
+          uflag = uflag || u3;
           continue WHILE;
         }
       }
@@ -1808,37 +1808,38 @@ minimatch.unescape = unescape;
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // ../../node_modules/lru-cache/dist/esm/node/index.min.js
-import { tracingChannel as G, channel as P } from "diagnostics_channel";
-var S = P("lru-cache:metrics");
-var W = G("lru-cache");
-var L = typeof performance == "object" && performance && typeof performance.now == "function" ? performance : Date;
-var R = () => S.hasSubscribers || W.hasSubscribers;
+import { tracingChannel as I, channel as G } from "diagnostics_channel";
+var S = G("lru-cache:metrics");
+var W = I("lru-cache");
+var C = typeof performance == "object" && performance && typeof performance.now == "function" ? performance : Date;
+var D = () => S.hasSubscribers || W.hasSubscribers;
 var U = /* @__PURE__ */ new Set();
-var M = typeof process == "object" && process ? process : {};
-var k = (d3, e, t, i) => {
-  typeof M.emitWarning == "function" ? M.emitWarning(d3, e, t, i) : console.error(`[${t}] ${e}: ${d3}`);
+var L = typeof process == "object" && process ? process : {};
+var P = (u3, e, t, i) => {
+  typeof L.emitWarning == "function" ? L.emitWarning(u3, e, t, i) : console.error(`[${t}] ${e}: ${u3}`);
 };
-var H = (d3) => !U.has(d3);
-var T = (d3) => !!d3 && d3 === Math.floor(d3) && d3 > 0 && isFinite(d3);
-var j = (d3) => T(d3) ? d3 <= Math.pow(2, 8) ? Uint8Array : d3 <= Math.pow(2, 16) ? Uint16Array : d3 <= Math.pow(2, 32) ? Uint32Array : d3 <= Number.MAX_SAFE_INTEGER ? O : null : null;
+var H = (u3) => !U.has(u3);
+var X = Symbol("type");
+var F = (u3) => !!u3 && u3 === Math.floor(u3) && u3 > 0 && isFinite(u3);
+var j = (u3) => F(u3) ? u3 <= Math.pow(2, 8) ? Uint8Array : u3 <= Math.pow(2, 16) ? Uint16Array : u3 <= Math.pow(2, 32) ? Uint32Array : u3 <= Number.MAX_SAFE_INTEGER ? O : null : null;
 var O = class extends Array {
   constructor(e) {
     super(e), this.fill(0);
   }
 };
-var x = class d {
+var R = class u {
   heap;
   length;
   static #o = false;
   static create(e) {
     let t = j(e);
     if (!t) return [];
-    d.#o = true;
-    let i = new d(e, t);
-    return d.#o = false, i;
+    u.#o = true;
+    let i = new u(e, t);
+    return u.#o = false, i;
   }
   constructor(e, t) {
-    if (!d.#o) throw new TypeError("instantiate Stack using Stack.create(n)");
+    if (!u.#o) throw new TypeError("instantiate Stack using Stack.create(n)");
     this.heap = new t(e), this.length = 0;
   }
   push(e) {
@@ -1848,14 +1849,14 @@ var x = class d {
     return this.heap[--this.length];
   }
 };
-var I = class d2 {
+var M = class u2 {
   #o;
-  #c;
-  #S;
-  #O;
+  #u;
   #w;
+  #x;
+  #S;
   #M;
-  #I;
+  #U;
   #m;
   get perf() {
     return this.#m;
@@ -1875,15 +1876,14 @@ var I = class d2 {
   allowStaleOnFetchAbort;
   allowStaleOnFetchRejection;
   ignoreFetchAbort;
-  backgroundFetchSize;
   #n;
   #b;
   #s;
   #i;
   #t;
-  #l;
-  #u;
   #a;
+  #c;
+  #l;
   #h;
   #y;
   #r;
@@ -1892,12 +1892,12 @@ var I = class d2 {
   #d;
   #g;
   #T;
-  #U;
+  #W;
   #f;
-  #D;
+  #j;
   static unsafeExposeInternals(e) {
-    return { starts: e.#F, ttls: e.#d, autopurgeTimers: e.#g, sizes: e.#_, keyMap: e.#s, keyList: e.#i, valList: e.#t, next: e.#l, prev: e.#u, get head() {
-      return e.#a;
+    return { starts: e.#F, ttls: e.#d, autopurgeTimers: e.#g, sizes: e.#_, keyMap: e.#s, keyList: e.#i, valList: e.#t, next: e.#a, prev: e.#c, get head() {
+      return e.#l;
     }, get tail() {
       return e.#h;
     }, free: e.#y, isBackgroundFetch: (t) => e.#e(t), backgroundFetch: (t, i, s, n) => e.#P(t, i, s, n), moveToTail: (t) => e.#L(t), indexes: (t) => e.#A(t), rindexes: (t) => e.#z(t), isStale: (t) => e.#p(t) };
@@ -1906,7 +1906,7 @@ var I = class d2 {
     return this.#o;
   }
   get maxSize() {
-    return this.#c;
+    return this.#u;
   }
   get calculatedSize() {
     return this.#b;
@@ -1918,139 +1918,134 @@ var I = class d2 {
     return this.#M;
   }
   get memoMethod() {
-    return this.#I;
+    return this.#U;
   }
   get dispose() {
-    return this.#S;
+    return this.#w;
   }
   get onInsert() {
-    return this.#O;
+    return this.#x;
   }
   get disposeAfter() {
-    return this.#w;
+    return this.#S;
   }
   constructor(e) {
-    let { max: t = 0, ttl: i, ttlResolution: s = 1, ttlAutopurge: n, updateAgeOnGet: o, updateAgeOnHas: l, allowStale: h, dispose: r, onInsert: c, disposeAfter: m, noDisposeOnSet: _, noUpdateTTL: u, maxSize: g = 0, maxEntrySize: f = 0, sizeCalculation: y, fetchMethod: a, memoMethod: w, noDeleteOnFetchRejection: F, noDeleteOnStaleGet: b, allowStaleOnFetchRejection: p, allowStaleOnFetchAbort: A, ignoreFetchAbort: z, backgroundFetchSize: C = 1, perf: E } = e;
-    if (this.backgroundFetchSize = C, E !== void 0 && typeof E?.now != "function") throw new TypeError("perf option must have a now() method if specified");
-    if (this.#m = E ?? L, t !== 0 && !T(t)) throw new TypeError("max option must be a nonnegative integer");
+    let { max: t = 0, ttl: i, ttlResolution: s = 1, ttlAutopurge: n, updateAgeOnGet: o, updateAgeOnHas: r, allowStale: h, dispose: l, onInsert: c, disposeAfter: f, noDisposeOnSet: g, noUpdateTTL: p, maxSize: T = 0, maxEntrySize: w = 0, sizeCalculation: y, fetchMethod: a, memoMethod: m, noDeleteOnFetchRejection: _, noDeleteOnStaleGet: b, allowStaleOnFetchRejection: d, allowStaleOnFetchAbort: A, ignoreFetchAbort: z, perf: x } = e;
+    if (x !== void 0 && typeof x?.now != "function") throw new TypeError("perf option must have a now() method if specified");
+    if (this.#m = x ?? C, t !== 0 && !F(t)) throw new TypeError("max option must be a nonnegative integer");
     let v = t ? j(t) : Array;
     if (!v) throw new Error("invalid max value: " + t);
-    if (this.#o = t, this.#c = g, this.maxEntrySize = f || this.#c, this.sizeCalculation = y, this.sizeCalculation) {
-      if (!this.#c && !this.maxEntrySize) throw new TypeError("cannot set sizeCalculation without setting maxSize or maxEntrySize");
+    if (this.#o = t, this.#u = T, this.maxEntrySize = w || this.#u, this.sizeCalculation = y, this.sizeCalculation) {
+      if (!this.#u && !this.maxEntrySize) throw new TypeError("cannot set sizeCalculation without setting maxSize or maxEntrySize");
       if (typeof this.sizeCalculation != "function") throw new TypeError("sizeCalculation set to non-function");
     }
-    if (w !== void 0 && typeof w != "function") throw new TypeError("memoMethod must be a function if defined");
-    if (this.#I = w, a !== void 0 && typeof a != "function") throw new TypeError("fetchMethod must be a function if specified");
-    if (this.#M = a, this.#U = !!a, this.#s = /* @__PURE__ */ new Map(), this.#i = Array.from({ length: t }).fill(void 0), this.#t = Array.from({ length: t }).fill(void 0), this.#l = new v(t), this.#u = new v(t), this.#a = 0, this.#h = 0, this.#y = x.create(t), this.#n = 0, this.#b = 0, typeof r == "function" && (this.#S = r), typeof c == "function" && (this.#O = c), typeof m == "function" ? (this.#w = m, this.#r = []) : (this.#w = void 0, this.#r = void 0), this.#T = !!this.#S, this.#D = !!this.#O, this.#f = !!this.#w, this.noDisposeOnSet = !!_, this.noUpdateTTL = !!u, this.noDeleteOnFetchRejection = !!F, this.allowStaleOnFetchRejection = !!p, this.allowStaleOnFetchAbort = !!A, this.ignoreFetchAbort = !!z, this.maxEntrySize !== 0) {
-      if (this.#c !== 0 && !T(this.#c)) throw new TypeError("maxSize must be a positive integer if specified");
-      if (!T(this.maxEntrySize)) throw new TypeError("maxEntrySize must be a positive integer if specified");
+    if (m !== void 0 && typeof m != "function") throw new TypeError("memoMethod must be a function if defined");
+    if (this.#U = m, a !== void 0 && typeof a != "function") throw new TypeError("fetchMethod must be a function if specified");
+    if (this.#M = a, this.#W = !!a, this.#s = /* @__PURE__ */ new Map(), this.#i = Array.from({ length: t }).fill(void 0), this.#t = Array.from({ length: t }).fill(void 0), this.#a = new v(t), this.#c = new v(t), this.#l = 0, this.#h = 0, this.#y = R.create(t), this.#n = 0, this.#b = 0, typeof l == "function" && (this.#w = l), typeof c == "function" && (this.#x = c), typeof f == "function" ? (this.#S = f, this.#r = []) : (this.#S = void 0, this.#r = void 0), this.#T = !!this.#w, this.#j = !!this.#x, this.#f = !!this.#S, this.noDisposeOnSet = !!g, this.noUpdateTTL = !!p, this.noDeleteOnFetchRejection = !!_, this.allowStaleOnFetchRejection = !!d, this.allowStaleOnFetchAbort = !!A, this.ignoreFetchAbort = !!z, this.maxEntrySize !== 0) {
+      if (this.#u !== 0 && !F(this.#u)) throw new TypeError("maxSize must be a positive integer if specified");
+      if (!F(this.maxEntrySize)) throw new TypeError("maxEntrySize must be a positive integer if specified");
       this.#X();
     }
-    if (this.allowStale = !!h, this.noDeleteOnStaleGet = !!b, this.updateAgeOnGet = !!o, this.updateAgeOnHas = !!l, this.ttlResolution = T(s) || s === 0 ? s : 1, this.ttlAutopurge = !!n, this.ttl = i || 0, this.ttl) {
-      if (!T(this.ttl)) throw new TypeError("ttl must be a positive integer if specified");
-      this.#k();
+    if (this.allowStale = !!h, this.noDeleteOnStaleGet = !!b, this.updateAgeOnGet = !!o, this.updateAgeOnHas = !!r, this.ttlResolution = F(s) || s === 0 ? s : 1, this.ttlAutopurge = !!n, this.ttl = i || 0, this.ttl) {
+      if (!F(this.ttl)) throw new TypeError("ttl must be a positive integer if specified");
+      this.#H();
     }
-    if (this.#o === 0 && this.ttl === 0 && this.#c === 0) throw new TypeError("At least one of max, maxSize, or ttl is required");
-    if (!this.ttlAutopurge && !this.#o && !this.#c) {
-      let D = "LRU_CACHE_UNBOUNDED";
-      H(D) && (U.add(D), k("TTL caching without ttlAutopurge, max, or maxSize can result in unbounded memory consumption.", "UnboundedCacheWarning", D, d2));
+    if (this.#o === 0 && this.ttl === 0 && this.#u === 0) throw new TypeError("At least one of max, maxSize, or ttl is required");
+    if (!this.ttlAutopurge && !this.#o && !this.#u) {
+      let E = "LRU_CACHE_UNBOUNDED";
+      H(E) && (U.add(E), P("TTL caching without ttlAutopurge, max, or maxSize can result in unbounded memory consumption.", "UnboundedCacheWarning", E, u2));
     }
   }
   getRemainingTTL(e) {
     return this.#s.has(e) ? 1 / 0 : 0;
   }
-  #k() {
+  #H() {
     let e = new O(this.#o), t = new O(this.#o);
     this.#d = e, this.#F = t;
     let i = this.ttlAutopurge ? Array.from({ length: this.#o }) : void 0;
-    this.#g = i, this.#H = (h, r, c = this.#m.now()) => {
-      t[h] = r !== 0 ? c : 0, e[h] = r, s(h, r);
-    }, this.#R = (h) => {
-      t[h] = e[h] !== 0 ? this.#m.now() : 0, s(h, e[h]);
+    this.#g = i, this.#N = (r, h, l = this.#m.now()) => {
+      t[r] = h !== 0 ? l : 0, e[r] = h, s(r, h);
+    }, this.#D = (r) => {
+      t[r] = e[r] !== 0 ? this.#m.now() : 0, s(r, e[r]);
     };
-    let s = this.ttlAutopurge ? (h, r) => {
-      if (i?.[h] && (clearTimeout(i[h]), i[h] = void 0), r && r !== 0 && i) {
-        let c = setTimeout(() => {
-          this.#p(h) ? (this.#E(this.#i[h], "expire"), i[h] = void 0) : s(h, l(h));
-        }, r + 1);
-        c.unref && c.unref(), i[h] = c;
+    let s = this.ttlAutopurge ? (r, h) => {
+      if (i?.[r] && (clearTimeout(i[r]), i[r] = void 0), h && h !== 0 && i) {
+        let l = setTimeout(() => {
+          this.#p(r) && this.#v(this.#i[r], "expire");
+        }, h + 1);
+        l.unref && l.unref(), i[r] = l;
       }
     } : () => {
     };
-    this.#v = (h, r) => {
-      if (e[r]) {
-        let c = e[r], m = t[r];
-        if (!c || !m) return;
-        h.ttl = c, h.start = m, h.now = n || o();
-        let _ = h.now - m;
-        h.remainingTTL = c - _;
+    this.#E = (r, h) => {
+      if (e[h]) {
+        let l = e[h], c = t[h];
+        if (!l || !c) return;
+        r.ttl = l, r.start = c, r.now = n || o();
+        let f = r.now - c;
+        r.remainingTTL = l - f;
       }
     };
     let n = 0, o = () => {
-      let h = this.#m.now();
+      let r = this.#m.now();
       if (this.ttlResolution > 0) {
-        n = h;
-        let r = setTimeout(() => n = 0, this.ttlResolution);
-        r.unref && r.unref();
+        n = r;
+        let h = setTimeout(() => n = 0, this.ttlResolution);
+        h.unref && h.unref();
       }
-      return h;
+      return r;
     };
-    this.getRemainingTTL = (h) => {
-      let r = this.#s.get(h);
-      return r === void 0 ? 0 : l(r);
-    };
-    let l = (h) => {
-      let r = e[h], c = t[h];
-      if (!r || !c) return 1 / 0;
-      let m = (n || o()) - c;
-      return r - m;
-    };
-    this.#p = (h) => {
-      let r = t[h], c = e[h];
-      return !!c && !!r && (n || o()) - r > c;
+    this.getRemainingTTL = (r) => {
+      let h = this.#s.get(r);
+      if (h === void 0) return 0;
+      let l = e[h], c = t[h];
+      if (!l || !c) return 1 / 0;
+      let f = (n || o()) - c;
+      return l - f;
+    }, this.#p = (r) => {
+      let h = t[r], l = e[r];
+      return !!l && !!h && (n || o()) - h > l;
     };
   }
-  #R = () => {
+  #D = () => {
   };
-  #v = () => {
+  #E = () => {
   };
-  #H = () => {
+  #N = () => {
   };
   #p = () => false;
   #X() {
     let e = new O(this.#o);
-    this.#b = 0, this.#_ = e, this.#x = (t) => {
+    this.#b = 0, this.#_ = e, this.#R = (t) => {
       this.#b -= e[t], e[t] = 0;
-    }, this.#N = (t, i, s, n) => {
-      if (!T(s)) {
-        if (this.#e(i)) return this.backgroundFetchSize;
-        if (n) {
-          if (typeof n != "function") throw new TypeError("sizeCalculation must be a function");
-          if (s = n(i, t), !T(s)) throw new TypeError("sizeCalculation return invalid (expect positive integer)");
-        } else throw new TypeError("invalid size value (must be positive integer). When maxSize or maxEntrySize is used, sizeCalculation or size must be set.");
-      }
+    }, this.#k = (t, i, s, n) => {
+      if (this.#e(i)) return 0;
+      if (!F(s)) if (n) {
+        if (typeof n != "function") throw new TypeError("sizeCalculation must be a function");
+        if (s = n(i, t), !F(s)) throw new TypeError("sizeCalculation return invalid (expect positive integer)");
+      } else throw new TypeError("invalid size value (must be positive integer). When maxSize or maxEntrySize is used, sizeCalculation or size must be set.");
       return s;
-    }, this.#j = (t, i, s) => {
-      if (e[t] = i, this.#c) {
-        let n = this.#c - e[t];
+    }, this.#I = (t, i, s) => {
+      if (e[t] = i, this.#u) {
+        let n = this.#u - e[t];
         for (; this.#b > n; ) this.#G(true);
       }
       this.#b += e[t], s && (s.entrySize = i, s.totalCalculatedSize = this.#b);
     };
   }
-  #x = (e) => {
+  #R = (e) => {
   };
-  #j = (e, t, i) => {
+  #I = (e, t, i) => {
   };
-  #N = (e, t, i, s) => {
+  #k = (e, t, i, s) => {
     if (i || s) throw new TypeError("cannot set size without setting maxSize or maxEntrySize on cache");
     return 0;
   };
   *#A({ allowStale: e = this.allowStale } = {}) {
-    if (this.#n) for (let t = this.#h; this.#V(t) && ((e || !this.#p(t)) && (yield t), t !== this.#a); ) t = this.#u[t];
+    if (this.#n) for (let t = this.#h; this.#V(t) && ((e || !this.#p(t)) && (yield t), t !== this.#l); ) t = this.#c[t];
   }
   *#z({ allowStale: e = this.allowStale } = {}) {
-    if (this.#n) for (let t = this.#a; this.#V(t) && ((e || !this.#p(t)) && (yield t), t !== this.#h); ) t = this.#l[t];
+    if (this.#n) for (let t = this.#l; this.#V(t) && ((e || !this.#p(t)) && (yield t), t !== this.#h); ) t = this.#a[t];
   }
   #V(e) {
     return e !== void 0 && this.#s.get(this.#i[e]) === e;
@@ -2103,7 +2098,7 @@ var I = class d2 {
   }
   purgeStale() {
     let e = false;
-    for (let t of this.#z({ allowStale: true })) this.#p(t) && (this.#E(this.#i[t], "expire"), e = true);
+    for (let t of this.#z({ allowStale: true })) this.#p(t) && (this.#v(this.#i[t], "expire"), e = true);
     return e;
   }
   info(e) {
@@ -2113,9 +2108,9 @@ var I = class d2 {
     if (s === void 0) return;
     let n = { value: s };
     if (this.#d && this.#F) {
-      let o = this.#d[t], l = this.#F[t];
-      if (o && l) {
-        let h = o - (this.#m.now() - l);
+      let o = this.#d[t], r = this.#F[t];
+      if (o && r) {
+        let h = o - (this.#m.now() - r);
         n.ttl = h, n.start = Date.now();
       }
     }
@@ -2129,8 +2124,8 @@ var I = class d2 {
       let o = { value: n };
       if (this.#d && this.#F) {
         o.ttl = this.#d[t];
-        let l = this.#m.now() - this.#F[t];
-        o.start = Math.floor(Date.now() - l);
+        let r = this.#m.now() - this.#F[t];
+        o.start = Math.floor(Date.now() - r);
       }
       this.#_ && (o.size = this.#_[t]), e.unshift([i, o]);
     }
@@ -2143,49 +2138,51 @@ var I = class d2 {
         let s = Date.now() - i.start;
         i.start = this.#m.now() - s;
       }
-      this.#W(t, i.value, i);
+      this.#O(t, i.value, i);
     }
   }
   set(e, t, i = {}) {
     let { status: s = S.hasSubscribers ? {} : void 0 } = i;
-    i.status = s, s && (s.op = "set", s.key = e, t !== void 0 && (s.value = t), s.cache = this);
-    let n = this.#W(e, t, i);
+    i.status = s, s && (s.op = "set", s.key = e, t !== void 0 && (s.value = t));
+    let n = this.#O(e, t, i);
     return s && S.hasSubscribers && S.publish(s), n;
   }
-  #W(e, t, i, s) {
-    let { ttl: n = this.ttl, start: o, noDisposeOnSet: l = this.noDisposeOnSet, sizeCalculation: h = this.sizeCalculation, status: r } = i, c = this.#e(t);
-    if (t === void 0) return r && (r.set = "deleted"), this.delete(e), this;
-    let { noUpdateTTL: m = this.noUpdateTTL } = i;
-    r && !c && (r.value = t);
-    let _ = this.#N(e, t, i.size || 0, h, r);
-    if (this.maxEntrySize && _ > this.maxEntrySize) return this.#E(e, "set"), r && (r.set = "miss", r.maxEntrySizeExceeded = true), this;
-    let u = this.#n === 0 ? void 0 : this.#s.get(e);
-    if (u === void 0) u = this.#n === 0 ? this.#h : this.#y.length !== 0 ? this.#y.pop() : this.#n === this.#o ? this.#G(false) : this.#n, this.#i[u] = e, this.#t[u] = t, this.#s.set(e, u), this.#l[this.#h] = u, this.#u[u] = this.#h, this.#h = u, this.#n++, this.#j(u, _, r), r && (r.set = "add"), m = false, this.#D && !c && this.#O?.(t, e, "add");
+  #O(e, t, i = {}) {
+    let { ttl: s = this.ttl, start: n, noDisposeOnSet: o = this.noDisposeOnSet, sizeCalculation: r = this.sizeCalculation, status: h } = i;
+    if (t === void 0) return h && (h.set = "deleted"), this.delete(e), this;
+    let { noUpdateTTL: l = this.noUpdateTTL } = i;
+    h && !this.#e(t) && (h.value = t);
+    let c = this.#k(e, t, i.size || 0, r, h);
+    if (this.maxEntrySize && c > this.maxEntrySize) return this.#v(e, "set"), h && (h.set = "miss", h.maxEntrySizeExceeded = true), this;
+    let f = this.#n === 0 ? void 0 : this.#s.get(e);
+    if (f === void 0) f = this.#n === 0 ? this.#h : this.#y.length !== 0 ? this.#y.pop() : this.#n === this.#o ? this.#G(false) : this.#n, this.#i[f] = e, this.#t[f] = t, this.#s.set(e, f), this.#a[this.#h] = f, this.#c[f] = this.#h, this.#h = f, this.#n++, this.#I(f, c, h), h && (h.set = "add"), l = false, this.#j && this.#x?.(t, e, "add");
     else {
-      this.#L(u);
-      let g = this.#t[u];
+      this.#L(f);
+      let g = this.#t[f];
       if (t !== g) {
-        if (!l) if (this.#e(g)) {
-          g !== s && g.__abortController.abort(new Error("replaced"));
-          let { __staleWhileFetching: f } = g;
-          f !== void 0 && f !== t && (this.#T && this.#S?.(f, e, "set"), this.#f && this.#r?.push([f, e, "set"]));
-        } else this.#T && this.#S?.(g, e, "set"), this.#f && this.#r?.push([g, e, "set"]);
-        if (this.#x(u), this.#j(u, _, r), this.#t[u] = t, !c) {
-          let f = g && this.#e(g) ? g.__staleWhileFetching : g, y = f === void 0 ? "add" : t !== f ? "replace" : "update";
-          r && (r.set = y, f !== void 0 && (r.oldValue = f)), this.#D && this.onInsert?.(t, e, y);
+        if (this.#W && this.#e(g)) {
+          g.__abortController.abort(new Error("replaced"));
+          let { __staleWhileFetching: p } = g;
+          p !== void 0 && !o && (this.#T && this.#w?.(p, e, "set"), this.#f && this.#r?.push([p, e, "set"]));
+        } else o || (this.#T && this.#w?.(g, e, "set"), this.#f && this.#r?.push([g, e, "set"]));
+        if (this.#R(f), this.#I(f, c, h), this.#t[f] = t, h) {
+          h.set = "replace";
+          let p = g && this.#e(g) ? g.__staleWhileFetching : g;
+          p !== void 0 && (h.oldValue = p);
         }
-      } else c || (r && (r.set = "update"), this.#D && this.onInsert?.(t, e, "update"));
+      } else h && (h.set = "update");
+      this.#j && this.onInsert?.(t, e, t === g ? "update" : "replace");
     }
-    if (n !== 0 && !this.#d && this.#k(), this.#d && (m || this.#H(u, n, o), r && this.#v(r, u)), !l && this.#f && this.#r) {
-      let g = this.#r, f;
-      for (; f = g?.shift(); ) this.#w?.(...f);
+    if (s !== 0 && !this.#d && this.#H(), this.#d && (l || this.#N(f, s, n), h && this.#E(h, f)), !o && this.#f && this.#r) {
+      let g = this.#r, p;
+      for (; p = g?.shift(); ) this.#S?.(...p);
     }
     return this;
   }
   pop() {
     try {
       for (; this.#n; ) {
-        let e = this.#t[this.#a];
+        let e = this.#t[this.#l];
         if (this.#G(true), this.#e(e)) {
           if (e.__staleWhileFetching) return e.__staleWhileFetching;
         } else if (e !== void 0) return e;
@@ -2193,19 +2190,17 @@ var I = class d2 {
     } finally {
       if (this.#f && this.#r) {
         let e = this.#r, t;
-        for (; t = e?.shift(); ) this.#w?.(...t);
+        for (; t = e?.shift(); ) this.#S?.(...t);
       }
     }
   }
   #G(e) {
-    let t = this.#a, i = this.#i[t], s = this.#t[t], n = this.#e(s);
-    n && s.__abortController.abort(new Error("evicted"));
-    let o = n ? s.__staleWhileFetching : s;
-    return (this.#T || this.#f) && o !== void 0 && (this.#T && this.#S?.(o, i, "evict"), this.#f && this.#r?.push([o, i, "evict"])), this.#x(t), this.#g?.[t] && (clearTimeout(this.#g[t]), this.#g[t] = void 0), e && (this.#i[t] = void 0, this.#t[t] = void 0, this.#y.push(t)), this.#n === 1 ? (this.#a = this.#h = 0, this.#y.length = 0) : this.#a = this.#l[t], this.#s.delete(i), this.#n--, t;
+    let t = this.#l, i = this.#i[t], s = this.#t[t];
+    return this.#W && this.#e(s) ? s.__abortController.abort(new Error("evicted")) : (this.#T || this.#f) && (this.#T && this.#w?.(s, i, "evict"), this.#f && this.#r?.push([s, i, "evict"])), this.#R(t), this.#g?.[t] && (clearTimeout(this.#g[t]), this.#g[t] = void 0), e && (this.#i[t] = void 0, this.#t[t] = void 0, this.#y.push(t)), this.#n === 1 ? (this.#l = this.#h = 0, this.#y.length = 0) : this.#l = this.#a[t], this.#s.delete(i), this.#n--, t;
   }
   has(e, t = {}) {
     let { status: i = S.hasSubscribers ? {} : void 0 } = t;
-    t.status = i, i && (i.op = "has", i.key = e, i.cache = this);
+    t.status = i, i && (i.op = "has", i.key = e);
     let s = this.#Y(e, t);
     return S.hasSubscribers && S.publish(i), s;
   }
@@ -2214,14 +2209,14 @@ var I = class d2 {
     if (n !== void 0) {
       let o = this.#t[n];
       if (this.#e(o) && o.__staleWhileFetching === void 0) return false;
-      if (this.#p(n)) s && (s.has = "stale", this.#v(s, n));
-      else return i && this.#R(n), s && (s.has = "hit", this.#v(s, n)), true;
+      if (this.#p(n)) s && (s.has = "stale", this.#E(s, n));
+      else return i && this.#D(n), s && (s.has = "hit", this.#E(s, n)), true;
     } else s && (s.has = "miss");
     return false;
   }
   peek(e, t = {}) {
-    let { status: i = R() ? {} : void 0 } = t;
-    i && (i.op = "peek", i.key = e, i.cache = this), t.status = i;
+    let { status: i = D() ? {} : void 0 } = t;
+    i && (i.op = "peek", i.key = e), t.status = i;
     let s = this.#J(e, t);
     return S.hasSubscribers && S.publish(i), s;
   }
@@ -2231,67 +2226,67 @@ var I = class d2 {
       i && (i.peek = n === void 0 ? "miss" : "stale");
       return;
     }
-    let o = this.#t[n], l = this.#e(o) ? o.__staleWhileFetching : o;
-    return i && (l !== void 0 ? (i.peek = "hit", i.value = l) : i.peek = "miss"), l;
+    let o = this.#t[n], r = this.#e(o) ? o.__staleWhileFetching : o;
+    return i && (r !== void 0 ? (i.peek = "hit", i.value = r) : i.peek = "miss"), r;
   }
   #P(e, t, i, s) {
     let n = t === void 0 ? void 0 : this.#t[t];
     if (this.#e(n)) return n;
-    let o = new AbortController(), { signal: l } = i;
-    l?.addEventListener("abort", () => o.abort(l.reason), { signal: o.signal });
-    let h = { signal: o.signal, options: i, context: s }, r = (f, y = false) => {
-      let { aborted: a } = o.signal, w = i.ignoreFetchAbort && f !== void 0, F = i.ignoreFetchAbort || !!(i.allowStaleOnFetchAbort && f !== void 0);
-      if (i.status && (a && !y ? (i.status.fetchAborted = true, i.status.fetchError = o.signal.reason, w && (i.status.fetchAbortIgnored = true)) : i.status.fetchResolved = true), a && !w && !y) return m(o.signal.reason, F);
-      let b = u, p = this.#t[t];
-      return (p === u || p === void 0 && w && y) && (f === void 0 ? b.__staleWhileFetching !== void 0 ? this.#t[t] = b.__staleWhileFetching : this.#E(e, "fetch") : (i.status && (i.status.fetchUpdated = true), this.#W(e, f, h.options, b))), f;
-    }, c = (f) => (i.status && (i.status.fetchRejected = true, i.status.fetchError = f), m(f, false)), m = (f, y) => {
-      let { aborted: a } = o.signal, w = a && i.allowStaleOnFetchAbort, F = w || i.allowStaleOnFetchRejection, b = F || i.noDeleteOnFetchRejection, p = u;
-      if (this.#t[t] === u && (!b || !y && p.__staleWhileFetching === void 0 ? this.#E(e, "fetch") : w || (this.#t[t] = p.__staleWhileFetching)), F) return i.status && p.__staleWhileFetching !== void 0 && (i.status.returnedStale = true), p.__staleWhileFetching;
-      if (p.__returned === p) throw f;
-    }, _ = (f, y) => {
+    let o = new AbortController(), { signal: r } = i;
+    r?.addEventListener("abort", () => o.abort(r.reason), { signal: o.signal });
+    let h = { signal: o.signal, options: i, context: s }, l = (w, y = false) => {
+      let { aborted: a } = o.signal, m = i.ignoreFetchAbort && w !== void 0, _ = i.ignoreFetchAbort || !!(i.allowStaleOnFetchAbort && w !== void 0);
+      if (i.status && (a && !y ? (i.status.fetchAborted = true, i.status.fetchError = o.signal.reason, m && (i.status.fetchAbortIgnored = true)) : i.status.fetchResolved = true), a && !m && !y) return f(o.signal.reason, _);
+      let b = p, d = this.#t[t];
+      return (d === p || d === void 0 && m && y) && (w === void 0 ? b.__staleWhileFetching !== void 0 ? this.#t[t] = b.__staleWhileFetching : this.#v(e, "fetch") : (i.status && (i.status.fetchUpdated = true), this.#O(e, w, h.options))), w;
+    }, c = (w) => (i.status && (i.status.fetchRejected = true, i.status.fetchError = w), f(w, false)), f = (w, y) => {
+      let { aborted: a } = o.signal, m = a && i.allowStaleOnFetchAbort, _ = m || i.allowStaleOnFetchRejection, b = _ || i.noDeleteOnFetchRejection, d = p;
+      if (this.#t[t] === p && (!b || !y && d.__staleWhileFetching === void 0 ? this.#v(e, "fetch") : m || (this.#t[t] = d.__staleWhileFetching)), _) return i.status && d.__staleWhileFetching !== void 0 && (i.status.returnedStale = true), d.__staleWhileFetching;
+      if (d.__returned === d) throw w;
+    }, g = (w, y) => {
       let a = this.#M?.(e, n, h);
-      o.signal.addEventListener("abort", () => {
-        (!i.ignoreFetchAbort || i.allowStaleOnFetchAbort) && (f(void 0), i.allowStaleOnFetchAbort && (f = (w) => r(w, true)));
-      }), a && a instanceof Promise ? a.then((w) => f(w === void 0 ? void 0 : w), y) : a !== void 0 && f(a);
+      a && a instanceof Promise && a.then((m) => w(m === void 0 ? void 0 : m), y), o.signal.addEventListener("abort", () => {
+        (!i.ignoreFetchAbort || i.allowStaleOnFetchAbort) && (w(void 0), i.allowStaleOnFetchAbort && (w = (m) => l(m, true)));
+      });
     };
     i.status && (i.status.fetchDispatched = true);
-    let u = new Promise(_).then(r, c), g = Object.assign(u, { __abortController: o, __staleWhileFetching: n, __returned: void 0 });
-    return t === void 0 ? (this.#W(e, g, { ...h.options, status: void 0 }), t = this.#s.get(e)) : this.#t[t] = g, g;
+    let p = new Promise(g).then(l, c), T = Object.assign(p, { __abortController: o, __staleWhileFetching: n, __returned: void 0 });
+    return t === void 0 ? (this.#O(e, T, { ...h.options, status: void 0 }), t = this.#s.get(e)) : this.#t[t] = T, T;
   }
   #e(e) {
-    if (!this.#U) return false;
+    if (!this.#W) return false;
     let t = e;
     return !!t && t instanceof Promise && t.hasOwnProperty("__staleWhileFetching") && t.__abortController instanceof AbortController;
   }
   fetch(e, t = {}) {
-    let i = W.hasSubscribers, { status: s = R() ? {} : void 0 } = t;
+    let i = W.hasSubscribers, { status: s = D() ? {} : void 0 } = t;
     t.status = s, s && t.context && (s.context = t.context);
     let n = this.#B(e, t);
     return s && i && (s.trace = true, W.tracePromise(() => n, s).catch(() => {
     })), n;
   }
   async #B(e, t = {}) {
-    let { allowStale: i = this.allowStale, updateAgeOnGet: s = this.updateAgeOnGet, noDeleteOnStaleGet: n = this.noDeleteOnStaleGet, ttl: o = this.ttl, noDisposeOnSet: l = this.noDisposeOnSet, size: h = 0, sizeCalculation: r = this.sizeCalculation, noUpdateTTL: c = this.noUpdateTTL, noDeleteOnFetchRejection: m = this.noDeleteOnFetchRejection, allowStaleOnFetchRejection: _ = this.allowStaleOnFetchRejection, ignoreFetchAbort: u = this.ignoreFetchAbort, allowStaleOnFetchAbort: g = this.allowStaleOnFetchAbort, context: f, forceRefresh: y = false, status: a, signal: w } = t;
-    if (a && (a.op = "fetch", a.key = e, y && (a.forceRefresh = true), a.cache = this), !this.#U) return a && (a.fetch = "get"), this.#C(e, { allowStale: i, updateAgeOnGet: s, noDeleteOnStaleGet: n, status: a });
-    let F = { allowStale: i, updateAgeOnGet: s, noDeleteOnStaleGet: n, ttl: o, noDisposeOnSet: l, size: h, sizeCalculation: r, noUpdateTTL: c, noDeleteOnFetchRejection: m, allowStaleOnFetchRejection: _, allowStaleOnFetchAbort: g, ignoreFetchAbort: u, status: a, signal: w }, b = this.#s.get(e);
+    let { allowStale: i = this.allowStale, updateAgeOnGet: s = this.updateAgeOnGet, noDeleteOnStaleGet: n = this.noDeleteOnStaleGet, ttl: o = this.ttl, noDisposeOnSet: r = this.noDisposeOnSet, size: h = 0, sizeCalculation: l = this.sizeCalculation, noUpdateTTL: c = this.noUpdateTTL, noDeleteOnFetchRejection: f = this.noDeleteOnFetchRejection, allowStaleOnFetchRejection: g = this.allowStaleOnFetchRejection, ignoreFetchAbort: p = this.ignoreFetchAbort, allowStaleOnFetchAbort: T = this.allowStaleOnFetchAbort, context: w, forceRefresh: y = false, status: a, signal: m } = t;
+    if (a && (a.op = "fetch", a.key = e, y && (a.forceRefresh = true)), !this.#W) return a && (a.fetch = "get"), this.#C(e, { allowStale: i, updateAgeOnGet: s, noDeleteOnStaleGet: n, status: a });
+    let _ = { allowStale: i, updateAgeOnGet: s, noDeleteOnStaleGet: n, ttl: o, noDisposeOnSet: r, size: h, sizeCalculation: l, noUpdateTTL: c, noDeleteOnFetchRejection: f, allowStaleOnFetchRejection: g, allowStaleOnFetchAbort: T, ignoreFetchAbort: p, status: a, signal: m }, b = this.#s.get(e);
     if (b === void 0) {
       a && (a.fetch = "miss");
-      let p = this.#P(e, b, F, f);
-      return p.__returned = p;
+      let d = this.#P(e, b, _, w);
+      return d.__returned = d;
     } else {
-      let p = this.#t[b];
-      if (this.#e(p)) {
-        let v = i && p.__staleWhileFetching !== void 0;
-        return a && (a.fetch = "inflight", v && (a.returnedStale = true)), v ? p.__staleWhileFetching : p.__returned = p;
+      let d = this.#t[b];
+      if (this.#e(d)) {
+        let E = i && d.__staleWhileFetching !== void 0;
+        return a && (a.fetch = "inflight", E && (a.returnedStale = true)), E ? d.__staleWhileFetching : d.__returned = d;
       }
       let A = this.#p(b);
-      if (!y && !A) return a && (a.fetch = "hit"), this.#L(b), s && this.#R(b), a && this.#v(a, b), p;
-      let z = this.#P(e, b, F, f), E = z.__staleWhileFetching !== void 0 && i;
-      return a && (a.fetch = A ? "stale" : "refresh", E && A && (a.returnedStale = true)), E ? z.__staleWhileFetching : z.__returned = z;
+      if (!y && !A) return a && (a.fetch = "hit"), this.#L(b), s && this.#D(b), a && this.#E(a, b), d;
+      let z = this.#P(e, b, _, w), v = z.__staleWhileFetching !== void 0 && i;
+      return a && (a.fetch = A ? "stale" : "refresh", v && A && (a.returnedStale = true)), v ? z.__staleWhileFetching : z.__returned = z;
     }
   }
   forceFetch(e, t = {}) {
-    let i = W.hasSubscribers, { status: s = R() ? {} : void 0 } = t;
+    let i = W.hasSubscribers, { status: s = D() ? {} : void 0 } = t;
     t.status = s, s && t.context && (s.context = t.context);
     let n = this.#K(e, t);
     return s && i && (s.trace = true, W.tracePromise(() => n, s).catch(() => {
@@ -2304,67 +2299,67 @@ var I = class d2 {
   }
   memo(e, t = {}) {
     let { status: i = S.hasSubscribers ? {} : void 0 } = t;
-    t.status = i, i && (i.op = "memo", i.key = e, t.context && (i.context = t.context), i.cache = this);
+    t.status = i, i && (i.op = "memo", i.key = e, t.context && (i.context = t.context));
     let s = this.#Q(e, t);
     return i && (i.value = s), S.hasSubscribers && S.publish(i), s;
   }
   #Q(e, t = {}) {
-    let i = this.#I;
+    let i = this.#U;
     if (!i) throw new Error("no memoMethod provided to constructor");
-    let { context: s, status: n, forceRefresh: o, ...l } = t;
+    let { context: s, status: n, forceRefresh: o, ...r } = t;
     n && o && (n.forceRefresh = true);
-    let h = this.#C(e, l), r = o || h === void 0;
-    if (n && (n.memo = r ? "miss" : "hit", r || (n.value = h)), !r) return h;
-    let c = i(e, h, { options: l, context: s });
-    return n && (n.value = c), this.#W(e, c, l), c;
+    let h = this.#C(e, r), l = o || h === void 0;
+    if (n && (n.memo = l ? "miss" : "hit", l || (n.value = h)), !l) return h;
+    let c = i(e, h, { options: r, context: s });
+    return n && (n.value = c), this.#O(e, c, r), c;
   }
   get(e, t = {}) {
     let { status: i = S.hasSubscribers ? {} : void 0 } = t;
-    t.status = i, i && (i.op = "get", i.key = e, i.cache = this);
+    t.status = i, i && (i.op = "get", i.key = e);
     let s = this.#C(e, t);
     return i && (s !== void 0 && (i.value = s), S.hasSubscribers && S.publish(i)), s;
   }
   #C(e, t = {}) {
-    let { allowStale: i = this.allowStale, updateAgeOnGet: s = this.updateAgeOnGet, noDeleteOnStaleGet: n = this.noDeleteOnStaleGet, status: o } = t, l = this.#s.get(e);
-    if (l === void 0) {
+    let { allowStale: i = this.allowStale, updateAgeOnGet: s = this.updateAgeOnGet, noDeleteOnStaleGet: n = this.noDeleteOnStaleGet, status: o } = t, r = this.#s.get(e);
+    if (r === void 0) {
       o && (o.get = "miss");
       return;
     }
-    let h = this.#t[l], r = this.#e(h);
-    return o && this.#v(o, l), this.#p(l) ? r ? (o && (o.get = "stale-fetching"), i && h.__staleWhileFetching !== void 0 ? (o && (o.returnedStale = true), h.__staleWhileFetching) : void 0) : (n || this.#E(e, "expire"), o && (o.get = "stale"), i ? (o && (o.returnedStale = true), h) : void 0) : (o && (o.get = r ? "fetching" : "hit"), this.#L(l), s && this.#R(l), r ? h.__staleWhileFetching : h);
+    let h = this.#t[r], l = this.#e(h);
+    return o && this.#E(o, r), this.#p(r) ? l ? (o && (o.get = "stale-fetching"), i && h.__staleWhileFetching !== void 0 ? (o && (o.returnedStale = true), h.__staleWhileFetching) : void 0) : (n || this.#v(e, "expire"), o && (o.get = "stale"), i ? (o && (o.returnedStale = true), h) : void 0) : (o && (o.get = l ? "fetching" : "hit"), this.#L(r), s && this.#D(r), l ? h.__staleWhileFetching : h);
   }
   #$(e, t) {
-    this.#u[t] = e, this.#l[e] = t;
+    this.#c[t] = e, this.#a[e] = t;
   }
   #L(e) {
-    e !== this.#h && (e === this.#a ? this.#a = this.#l[e] : this.#$(this.#u[e], this.#l[e]), this.#$(this.#h, e), this.#h = e);
+    e !== this.#h && (e === this.#l ? this.#l = this.#a[e] : this.#$(this.#c[e], this.#a[e]), this.#$(this.#h, e), this.#h = e);
   }
   delete(e) {
-    return this.#E(e, "delete");
+    return this.#v(e, "delete");
   }
-  #E(e, t) {
-    S.hasSubscribers && S.publish({ op: "delete", delete: t, key: e, cache: this });
+  #v(e, t) {
+    S.hasSubscribers && S.publish({ op: "delete", delete: t, key: e });
     let i = false;
     if (this.#n !== 0) {
       let s = this.#s.get(e);
-      if (s !== void 0) if (this.#g?.[s] && (clearTimeout(this.#g[s]), this.#g[s] = void 0), i = true, this.#n === 1) this.#q(t);
+      if (s !== void 0) if (this.#g?.[s] && (clearTimeout(this.#g?.[s]), this.#g[s] = void 0), i = true, this.#n === 1) this.#q(t);
       else {
-        this.#x(s);
+        this.#R(s);
         let n = this.#t[s];
-        if (this.#e(n) ? n.__abortController.abort(new Error("deleted")) : (this.#T || this.#f) && (this.#T && this.#S?.(n, e, t), this.#f && this.#r?.push([n, e, t])), this.#s.delete(e), this.#i[s] = void 0, this.#t[s] = void 0, s === this.#h) this.#h = this.#u[s];
-        else if (s === this.#a) this.#a = this.#l[s];
+        if (this.#e(n) ? n.__abortController.abort(new Error("deleted")) : (this.#T || this.#f) && (this.#T && this.#w?.(n, e, t), this.#f && this.#r?.push([n, e, t])), this.#s.delete(e), this.#i[s] = void 0, this.#t[s] = void 0, s === this.#h) this.#h = this.#c[s];
+        else if (s === this.#l) this.#l = this.#a[s];
         else {
-          let o = this.#u[s];
-          this.#l[o] = this.#l[s];
-          let l = this.#l[s];
-          this.#u[l] = this.#u[s];
+          let o = this.#c[s];
+          this.#a[o] = this.#a[s];
+          let r = this.#a[s];
+          this.#c[r] = this.#c[s];
         }
         this.#n--, this.#y.push(s);
       }
     }
     if (this.#f && this.#r?.length) {
       let s = this.#r, n;
-      for (; n = s?.shift(); ) this.#w?.(...n);
+      for (; n = s?.shift(); ) this.#S?.(...n);
     }
     return i;
   }
@@ -2377,7 +2372,7 @@ var I = class d2 {
       if (this.#e(i)) i.__abortController.abort(new Error("deleted"));
       else {
         let s = this.#i[t];
-        this.#T && this.#S?.(i, s, e), this.#f && this.#r?.push([i, s, e]);
+        this.#T && this.#w?.(i, s, e), this.#f && this.#r?.push([i, s, e]);
       }
     }
     if (this.#s.clear(), this.#t.fill(void 0), this.#i.fill(void 0), this.#d && this.#F) {
@@ -2385,9 +2380,9 @@ var I = class d2 {
       for (let t of this.#g ?? []) t !== void 0 && clearTimeout(t);
       this.#g?.fill(void 0);
     }
-    if (this.#_ && this.#_.fill(0), this.#a = 0, this.#h = 0, this.#y.length = 0, this.#b = 0, this.#n = 0, this.#f && this.#r) {
+    if (this.#_ && this.#_.fill(0), this.#l = 0, this.#h = 0, this.#y.length = 0, this.#b = 0, this.#n = 0, this.#f && this.#r) {
       let t = this.#r, i;
-      for (; i = t?.shift(); ) this.#w?.(...i);
+      for (; i = t?.shift(); ) this.#S?.(...i);
     }
   }
 };
@@ -3326,7 +3321,7 @@ var ENOREALPATH = 512;
 var ENOCHILD = ENOTDIR | ENOENT | ENOREALPATH;
 var TYPEMASK = 1023;
 var entToType = (s) => s.isFile() ? IFREG : s.isDirectory() ? IFDIR : s.isSymbolicLink() ? IFLNK : s.isCharacterDevice() ? IFCHR : s.isBlockDevice() ? IFBLK : s.isSocket() ? IFSOCK : s.isFIFO() ? IFIFO : UNKNOWN;
-var normalizeCache = new I({ max: 2 ** 12 });
+var normalizeCache = new M({ max: 2 ** 12 });
 var normalize = (s) => {
   const c = normalizeCache.get(s);
   if (c)
@@ -3335,7 +3330,7 @@ var normalize = (s) => {
   normalizeCache.set(s, n);
   return n;
 };
-var normalizeNocaseCache = new I({ max: 2 ** 12 });
+var normalizeNocaseCache = new M({ max: 2 ** 12 });
 var normalizeNocase = (s) => {
   const c = normalizeNocaseCache.get(s);
   if (c)
@@ -3344,12 +3339,12 @@ var normalizeNocase = (s) => {
   normalizeNocaseCache.set(s, n);
   return n;
 };
-var ResolveCache = class extends I {
+var ResolveCache = class extends M {
   constructor() {
     super({ max: 256 });
   }
 };
-var ChildrenCache = class extends I {
+var ChildrenCache = class extends M {
   constructor(maxSize = 16 * 1024) {
     super({
       maxSize,
@@ -5320,7 +5315,7 @@ var SubWalks = class {
     return subs;
   }
   entries() {
-    return this.keys().map((k2) => [k2, this.store.get(k2)]);
+    return this.keys().map((k) => [k, this.store.get(k)]);
   }
   keys() {
     return [...this.store.keys()].filter((t) => t.canReaddir());

package/dist/index.js

@@ -5,8 +5,109 @@ import {
 } from "./chunk-P76KH42G.js";
 
 // src/index.ts
+import { createRequire as createRequire2 } from "module";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+// src/freshness.ts
+import { createRequire } from "module";
+import { statSync, existsSync, readdirSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+var require_ = createRequire(import.meta.url);
+var WORKSPACE_SCOPES = ["@lokascript/", "@hyperfixi/"];
+var PROBE_TTL_MS = 1e3;
+var watched = [];
+var lastProbeAt = 0;
+var lastResult = [];
+function watchedPackages() {
+  const pkg = require_("../package.json");
+  const names = /* @__PURE__ */ new Set([
+    ...Object.keys(pkg.dependencies ?? {}),
+    ...Object.keys(pkg.peerDependencies ?? {})
+  ]);
+  return [...names].filter((n) => WORKSPACE_SCOPES.some((s) => n.startsWith(s))).sort();
+}
+function resolveMarker(name) {
+  try {
+    const url = import.meta.resolve(name);
+    const path = fileURLToPath(url);
+    return existsSync(path) ? path : null;
+  } catch {
+    return null;
+  }
+}
+function captureFreshnessBaseline() {
+  watched = watchedPackages().flatMap((pkg) => {
+    const marker = resolveMarker(pkg);
+    if (!marker) return [];
+    return [{ pkg, marker, loadedMtimeMs: statSync(marker).mtimeMs }];
+  });
+  lastProbeAt = 0;
+  lastResult = [];
+}
+function staleSinceStartup(now = Date.now()) {
+  if (now - lastProbeAt < PROBE_TTL_MS) return lastResult;
+  lastProbeAt = now;
+  lastResult = watched.filter((w) => {
+    try {
+      return statSync(w.marker).mtimeMs !== w.loadedMtimeMs;
+    } catch {
+      return true;
+    }
+  }).map((w) => w.pkg);
+  return lastResult;
+}
+function hasNewerTs(dir, builtAt) {
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const p = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (hasNewerTs(p, builtAt)) return true;
+    } else if (entry.name.endsWith(".ts") && statSync(p).mtimeMs > builtAt) {
+      return true;
+    }
+  }
+  return false;
+}
+function staleAtStartup() {
+  return watched.filter((w) => {
+    const srcDir = join(dirname(dirname(w.marker)), "src");
+    if (!existsSync(srcDir)) return false;
+    try {
+      return hasNewerTs(srcDir, statSync(w.marker).mtimeMs);
+    } catch {
+      return false;
+    }
+  }).map((w) => ({ pkg: w.pkg, dir: dirname(dirname(w.marker)) }));
+}
+function staleToolError(stale) {
+  return {
+    content: [
+      {
+        type: "text",
+        text: `\u2717 This MCP server is serving STALE code and refused the call.
+
+  Rebuilt since the server started: ${stale.join(", ")}
+
+  The server resolves these packages' dist/ at startup and Node caches the module
+  graph, so it cannot pick up a rebuild without restarting. Any answer it gave now
+  would reflect the code as it was BEFORE the rebuild \u2014 silently.
+
+  Fix: restart the MCP server (in Claude Code: /mcp, then reconnect "lokascript").
+
+  If you are mid-arc and only need to probe the parser, prefer a direct tsx probe
+  (which imports fresh each run) over this server \u2014 see the probe recipe in
+  docs-internal/HANDOFF_foreign-validity-burndown.md.`
+      }
+    ],
+    isError: true
+  };
+}
+function freshnessSummary() {
+  return `watching ${watched.length} workspace dist entries`;
+}
+
+// src/index.ts
 import {
   CallToolRequestSchema,
   GetPromptRequestSchema,
@@ -7977,7 +8078,7 @@ function createInlineExtractor() {
     const fs = await import("fs");
     const path = await import("path");
     const crypto = await import("crypto");
-    const { glob } = await import("./esm-YPGJSQ36.js");
+    const { glob } = await import("./esm-65HZKQ6R.js");
     const globs = [
       "**/*.html",
       "**/*.htm",
@@ -10134,6 +10235,7 @@ function getLSEProtocolSpec() {
 | Disabled flag | \`~name\` | \`~nullable\` |
 | String literal | \`"..."\` or \`'...'\` | \`patient:"hello world"\` |
 | Selector | \`#id\` \`.class\` \`[attr]\` \`@aria\` \`*wild\` | \`destination:#button\` |
+| Selector literal | \`<...selector.../>\` | \`patient:<ul > li/>\`, \`patient:<.a, .b/>\` |
 | Boolean | \`true\` / \`false\` | \`goal:true\` |
 | Number | digits with optional decimal | \`quantity:5\` |
 | Duration | number + suffix | \`delay:500ms\`, \`timeout:2s\` |
@@ -10141,15 +10243,22 @@ function getLSEProtocolSpec() {
 | Nested body | bracket command in value | \`body:[toggle patient:.active]\` |
 | Compound | chain operator between commands | \`[add ...] then [fetch ...]\` |
 
+A selector containing a space, a combinator (\`>\` \`+\` \`~\`), or a comma must use a
+selector literal \u2014 the tokenizer would otherwise split it. Inside a structural role
+(\`body\`, \`then\`, \`else\`, \`condition\`, \`loop-body\`, \`variable\`, \`catch\`, \`finally\`)
+a \`[...]\` value is always a nested command, so an attribute selector there must also
+use the literal form: \`condition:<[data-active]/>\`.
+
 ## Value Classification Priority (first match wins)
 
-1. **Selector** \u2014 starts with \`#\`, \`.\`, \`[\`, \`@\`, \`*\`
-2. **String** \u2014 starts with \`"\` or \`'\`
-3. **Boolean** \u2014 exact: \`true\` or \`false\`
-4. **Reference** \u2014 \`me\`, \`you\`, \`it\`, \`result\`, \`event\`, \`target\`, \`body\`
-5. **Duration** \u2014 number + \`ms\`/\`s\`/\`m\`/\`h\`
-6. **Number** \u2014 integer or decimal
-7. **Plain** \u2014 fallback (any non-whitespace)
+1. **Selector literal** \u2014 starts with \`<\` and ends with \`/>\`; delimiters stripped
+2. **Selector** \u2014 starts with \`#\`, \`.\`, \`[\`, \`@\`, \`*\`
+3. **String** \u2014 starts with \`"\` or \`'\`
+4. **Boolean** \u2014 exact: \`true\` or \`false\`
+5. **Reference** \u2014 \`me\`, \`you\`, \`it\`, \`result\`, \`event\`, \`target\`, \`body\`
+6. **Duration** \u2014 number + \`ms\`/\`s\`/\`m\`/\`h\`
+7. **Number** \u2014 integer or decimal
+8. **Plain** \u2014 fallback (any non-whitespace)
 
 ## Node Kinds
 
@@ -10388,10 +10497,11 @@ function readResource(uri) {
 
 // src/index.ts
 var registry = createDomainRegistry();
+var { version: pkgVersion } = createRequire2(import.meta.url)("../package.json");
 var server = new Server(
   {
     name: "@hyperfixi/mcp-server",
-    version: "1.0.0"
+    version: pkgVersion
   },
   {
     capabilities: {
@@ -10428,6 +10538,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
 });
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
   const { name, arguments: args } = request.params;
+  const stale = staleSinceStartup();
+  if (stale.length > 0) {
+    return staleToolError(stale);
+  }
   if (name.startsWith("analyze_") || name === "explain_code" || name === "recognize_intent") {
     return handleAnalysisTool(name, args);
   }
@@ -10484,7 +10598,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
   if (name === "lse_validate_and_feedback" || name === "lse_pattern_stats") {
     return handleFeedbackTool(name, args);
   }
-  if (name === "lse_from_hyperscript" || name === "lse_to_hyperscript") {
+  if (name === "lse_from_hyperscript" || name === "lse_to_hyperscript" || name === "execute_lse" || name === "validate_lse" || name === "translate_lse") {
     return handleLsePipelineTool(name, args);
   }
   if (name.startsWith("grail_")) {
@@ -10529,9 +10643,19 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
   return readResource(uri);
 });
 async function main() {
+  captureFreshnessBaseline();
+  const bornStale = staleAtStartup();
+  if (bornStale.length > 0) {
+    console.error(
+      `\u26A0 MCP server started against a STALE dist/ in: ${bornStale.map((s) => s.pkg).join(", ")} \u2014
+  src/ is newer than the built output, so answers will reflect the last build, not the
+  checkout. Rebuild, then restart this server:
+` + bornStale.map((s) => `    npm run build --prefix ${s.dir}`).join("\n")
+    );
+  }
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error("HyperFixi MCP server started");
+  console.error(`HyperFixi MCP server started (${freshnessSummary()})`);
 }
 main().catch((error) => {
   console.error("Failed to start MCP server:", error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperfixi/mcp-server",
-  "version": "2.7.1",
+  "version": "2.8.0",
   "description": "Model Context Protocol server for HyperFixi hyperscript development",
   "type": "module",
   "main": "dist/index.js",
@@ -37,31 +37,31 @@
   "author": "LokaScript Contributors",
   "license": "MIT",
   "dependencies": {
-    "@hyperfixi/patterns-reference": "^2.7.1",
-    "@lokascript/compilation-service": "^2.7.1",
-    "@lokascript/domain-config": "^2.7.1",
-    "@lokascript/framework": "^2.7.1",
-    "@lokascript/planner": "^2.7.1",
-    "@lokascript/semantic": "^2.7.1",
+    "@hyperfixi/patterns-reference": "^2.8.0",
+    "@lokascript/compilation-service": "^2.8.0",
+    "@lokascript/domain-config": "^2.8.0",
+    "@lokascript/framework": "^2.8.0",
+    "@lokascript/planner": "^2.8.0",
+    "@lokascript/semantic": "^2.8.0",
     "@modelcontextprotocol/sdk": "^1.25.0",
     "yaml": "^2.8.3"
   },
   "peerDependencies": {
-    "@hyperfixi/core": "^2.7.1",
-    "@hyperfixi/patterns-reference": "^2.7.1",
-    "@hyperfixi/server-bridge": "^2.7.1",
-    "@lokascript/compilation-service": "^2.7.1",
-    "@lokascript/domain-bdd": "^2.7.1",
-    "@lokascript/domain-behaviorspec": "^2.7.1",
-    "@lokascript/domain-flow": "^2.7.1",
-    "@lokascript/domain-jsx": "^2.7.1",
-    "@lokascript/domain-learn": "^2.7.1",
-    "@lokascript/domain-llm": "^2.7.1",
-    "@lokascript/domain-sql": "^2.7.1",
-    "@lokascript/domain-todo": "^2.7.1",
-    "@lokascript/domain-voice": "^2.7.1",
-    "@lokascript/framework": "^2.7.1",
-    "@lokascript/semantic": "^2.7.1"
+    "@hyperfixi/core": "^2.8.0",
+    "@hyperfixi/patterns-reference": "^2.8.0",
+    "@hyperfixi/server-bridge": "^2.8.0",
+    "@lokascript/compilation-service": "^2.8.0",
+    "@lokascript/domain-bdd": "^2.8.0",
+    "@lokascript/domain-behaviorspec": "^2.8.0",
+    "@lokascript/domain-flow": "^2.8.0",
+    "@lokascript/domain-jsx": "^2.8.0",
+    "@lokascript/domain-learn": "^2.8.0",
+    "@lokascript/domain-llm": "^2.8.0",
+    "@lokascript/domain-sql": "^2.8.0",
+    "@lokascript/domain-todo": "^2.8.0",
+    "@lokascript/domain-voice": "^2.8.0",
+    "@lokascript/framework": "^2.8.0",
+    "@lokascript/semantic": "^2.8.0"
   },
   "peerDependenciesMeta": {
     "@lokascript/compilation-service": {
@@ -111,24 +111,24 @@
     }
   },
   "devDependencies": {
-    "@hyperfixi/core": "^2.7.1",
-    "@hyperfixi/patterns-reference": "^2.7.1",
-    "@hyperfixi/server-bridge": "^2.7.1",
-    "@lokascript/compilation-service": "^2.7.1",
-    "@lokascript/domain-bdd": "^2.7.1",
-    "@lokascript/domain-behaviorspec": "^2.7.1",
-    "@lokascript/domain-flow": "^2.7.1",
-    "@lokascript/domain-jsx": "^2.7.1",
-    "@lokascript/domain-learn": "^2.7.1",
-    "@lokascript/domain-llm": "^2.7.1",
-    "@lokascript/domain-sql": "^2.7.1",
-    "@lokascript/domain-todo": "^2.7.1",
-    "@lokascript/domain-voice": "^2.7.1",
-    "@lokascript/framework": "^2.7.1",
-    "@lokascript/semantic": "^2.7.1",
+    "@hyperfixi/core": "^2.8.0",
+    "@hyperfixi/patterns-reference": "^2.8.0",
+    "@hyperfixi/server-bridge": "^2.8.0",
+    "@lokascript/compilation-service": "^2.8.0",
+    "@lokascript/domain-bdd": "^2.8.0",
+    "@lokascript/domain-behaviorspec": "^2.8.0",
+    "@lokascript/domain-flow": "^2.8.0",
+    "@lokascript/domain-jsx": "^2.8.0",
+    "@lokascript/domain-learn": "^2.8.0",
+    "@lokascript/domain-llm": "^2.8.0",
+    "@lokascript/domain-sql": "^2.8.0",
+    "@lokascript/domain-todo": "^2.8.0",
+    "@lokascript/domain-voice": "^2.8.0",
+    "@lokascript/framework": "^2.8.0",
+    "@lokascript/semantic": "^2.8.0",
     "@types/node": "^20.0.0",
     "tsup": "^8.0.0",
-    "tsx": "^4.0.0",
+    "tsx": "^4.23.1",
     "typescript": "^5.0.0",
     "vitest": "^4.1.5"
   },