tina4-nodejs 3.13.99 → 3.13.101

package/packages/core/dist/index.js

@@ -1460,7 +1460,10 @@ var init_trustedProxy = __esm({
 var engine_exports = {};
 __export(engine_exports, {
   Frond: () => Frond,
+  MEMO_CACHE_MAX: () => MEMO_CACHE_MAX,
   TEMPLATE_CACHE_MAX: () => TEMPLATE_CACHE_MAX,
+  filterChainCache: () => filterChainCache,
+  pathParseCache: () => pathParseCache,
   setFormTokenSessionId: () => setFormTokenSessionId
 });
 import { createHash as createHash2, createHmac as createHmac2, randomBytes as randomBytes2 } from "node:crypto";
@@ -1564,6 +1567,12 @@ function capCache(cache, maxEntries) {
     if (--drop <= 0) break;
   }
 }
+function sweepExpiredCache(cache) {
+  const now = Date.now();
+  for (const [key, [, expiresAt]] of cache) {
+    if (expiresAt <= now) cache.delete(key);
+  }
+}
 function tokenize(source) {
   const rawBlocks = [];
   source = source.replace(RAW_BLOCK_RE, (_match, content) => {
@@ -1627,6 +1636,16 @@ function stripTag(raw) {
   }
   return [inner.trim(), stripBefore, stripAfter];
 }
+function extendsTarget(source) {
+  const matches = source.match(EXTENDS_RE_GLOBAL);
+  if (matches && matches.length > 1) {
+    throw new Error(
+      `Frond: template has ${matches.length} "{% extends %}" tags -- a template can extend only one parent`
+    );
+  }
+  const match = source.match(EXTENDS_RE);
+  return match ? match[1] : "";
+}
 function resolveVar(expr, context) {
   expr = expr.trim();
   if (expr.startsWith('"') && expr.endsWith('"') || expr.startsWith("'") && expr.endsWith("'")) {
@@ -1707,6 +1726,7 @@ function resolveVar(expr, context) {
         fromBracket.push(false);
       }
     }
+    capCache(pathParseCache, MEMO_CACHE_MAX);
     pathParseCache.set(expr, [parts, fromBracket]);
   }
   let value = context;
@@ -2294,6 +2314,7 @@ function parseFilterChain(expr) {
     }
   }
   const result = [variable, filters];
+  capCache(filterChainCache, MEMO_CACHE_MAX);
   filterChainCache.set(expr, result);
   return result;
 }
@@ -2473,7 +2494,7 @@ function _generateFormToken(descriptor = "") {
 function _generateFormTokenValue(descriptor = "") {
   return new SafeString(_buildFormTokenJwt(descriptor));
 }
-var SafeString, KNOWN_TAGS, TERMINATOR_TAGS, GATEABLE_TAGS, BLOCK_TAG_ENDS, JSON_UNSAFE_RE, JSON_UNSAFE_MAP, NUMERIC_RE, METHOD_CALL_RE, FN_CALL_RE, IS_NOT_RE, IS_RE, NOT_IN_RE, IN_RE, DIVISIBLE_BY_RE, FILTER_WITH_ARGS_RE, FILTER_COMPARISON_RE, TITLE_WORD_RE, STRIP_TAGS_RE, FORMAT_RE, LEADING_WS_RE, TRAILING_WS_RE, THOUSANDS_RE, LIVE_RE, LIVE_WS_RE, LIVE_SRC_RE, filterChainCache, pathParseCache, TEMPLATE_CACHE_MAX, TOKEN_RE, RAW_BLOCK_RE, VarRef, BUILTIN_FILTERS, _formTokenSessionId, Frond;
+var SafeString, KNOWN_TAGS, TERMINATOR_TAGS, GATEABLE_TAGS, BLOCK_TAG_ENDS, JSON_UNSAFE_RE, JSON_UNSAFE_MAP, NUMERIC_RE, METHOD_CALL_RE, FN_CALL_RE, IS_NOT_RE, IS_RE, NOT_IN_RE, IN_RE, DIVISIBLE_BY_RE, FILTER_WITH_ARGS_RE, FILTER_COMPARISON_RE, TITLE_WORD_RE, STRIP_TAGS_RE, FORMAT_RE, LEADING_WS_RE, TRAILING_WS_RE, THOUSANDS_RE, LIVE_RE, LIVE_WS_RE, LIVE_SRC_RE, EXTENDS_RE, EXTENDS_RE_GLOBAL, filterChainCache, pathParseCache, TEMPLATE_CACHE_MAX, MEMO_CACHE_MAX, TOKEN_RE, RAW_BLOCK_RE, VarRef, BUILTIN_FILTERS, _formTokenSessionId, Frond;
 var init_engine = __esm({
   "../frond/src/engine.ts"() {
     "use strict";
@@ -2567,9 +2588,12 @@ var init_engine = __esm({
     LIVE_RE = /^live\s+["']([^"']+)["']([\s\S]*)$/;
     LIVE_WS_RE = /ws\s+["']([^"']+)["']/;
     LIVE_SRC_RE = /src\s+["']([^"']+)["']/;
+    EXTENDS_RE = /\{%[-\s]*extends\s+["'](.+?)["']\s*[-]?%\}/;
+    EXTENDS_RE_GLOBAL = /\{%[-\s]*extends\s+["'](.+?)["']\s*[-]?%\}/g;
     filterChainCache = /* @__PURE__ */ new Map();
     pathParseCache = /* @__PURE__ */ new Map();
     TEMPLATE_CACHE_MAX = 256;
+    MEMO_CACHE_MAX = 1024;
     TOKEN_RE = /(\{%-?\s*[\s\S]*?\s*-?%\})|(\{\{-?\s*[\s\S]*?\s*-?\}\})|(\{#[\s\S]*?#\})/g;
     RAW_BLOCK_RE = /\{%-?\s*raw\s*-?%\}([\s\S]*?)\{%-?\s*endraw\s*-?%\}/g;
     VarRef = class {
@@ -2922,29 +2946,22 @@ var init_engine = __esm({
         return this;
       }
       /**
-       * Register a custom filter. The filter is persisted at class level
-       * so new instances created by hot-reload inherit it automatically;
-       * the live instance's local filter map also receives the addition
-       * immediately. Mirrors Python's _ClassOrInstanceMethod dual-call.
+       * Register a custom filter on this instance only. Use the static method
+       * for process-global registration. tina4: ADR-0052.
        */
       addFilter(name, fn) {
-        _Frond.classFilters.set(name, fn);
         this.filters[name] = fn;
       }
       /**
-       * Register a global variable available in all templates. Persisted
-       * at class level — see ``addFilter`` for the dual-call semantics.
+       * Register a global variable on this instance only.
        */
       addGlobal(name, value) {
-        _Frond.classGlobals.set(name, value);
         this.globals[name] = value;
       }
       /**
-       * Register a custom test. Persisted at class level — see
-       * ``addFilter`` for the dual-call semantics.
+       * Register a custom test on this instance only.
        */
       addTest(name, fn) {
-        _Frond.classTests.set(name, fn);
         this.tests[name] = fn;
       }
       /**
@@ -3059,9 +3076,8 @@ var init_engine = __esm({
         if (Object.keys(this.tests).length > 0) {
           context.__frond_tests__ = this.tests;
         }
-        const extendsMatch = source.match(/\{%[-\s]*extends\s+["'](.+?)["']\s*[-]?%\}/);
-        if (extendsMatch) {
-          const parentName = extendsMatch[1];
+        const parentName = extendsTarget(source);
+        if (parentName) {
           const parentSource = this.load(parentName);
           const childBlocks = this.extractBlocks(source);
           return this.renderWithBlocks(parentSource, context, childBlocks);
@@ -3072,9 +3088,8 @@ var init_engine = __esm({
         if (Object.keys(this.tests).length > 0) {
           context.__frond_tests__ = this.tests;
         }
-        const extendsMatch = source.match(/\{%[-\s]*extends\s+["'](.+?)["']\s*[-]?%\}/);
-        if (extendsMatch) {
-          const parentName = extendsMatch[1];
+        const parentName = extendsTarget(source);
+        if (parentName) {
           const parentSource = this.load(parentName);
           const childBlocks = this.extractBlocks(source);
           return this.renderWithBlocks(parentSource, context, childBlocks);
@@ -3119,10 +3134,93 @@ var init_engine = __esm({
         }
         return blocks;
       }
+      /**
+       * Depth-aware block substitution against `source` (typically the
+       * fully-resolved root template).
+       *
+       * A single regex `.replace()` pass (the flat `pattern` this replaces in
+       * renderWithBlocks) pairs an OUTER block's open tag with the FIRST
+       * `{% endblock %}` found -- which, when the outer block wraps a NESTED
+       * `{% block %}`, is the nested block's own close tag, not the outer's.
+       * That silently truncates the outer block's captured content and drops
+       * everything after the inner endblock (the root-nested-block
+       * content-loss bug). This scans with an open/close depth counter
+       * instead (mirroring extractBlocks), so an outer block always captures
+       * its FULL body, nested child blocks included.
+       *
+       * The content chosen for each block -- the child override in `blocks`
+       * if present, else the block's own default body -- is then recursively
+       * substituted against the SAME `blocks` map before being tokenized and
+       * rendered, so a block nested inside another block resolves correctly
+       * regardless of which template in the inheritance chain declared the
+       * nesting (the root, an intermediate, however many levels deep).
+       *
+       * `{{ parent() }}` / `{{ super() }}` inside a block still render that
+       * block's OWN default content at this level (lazy, on first call).
+       */
+      substituteBlocks(source, blocks, context) {
+        const blockOpen = /\{%[-\s]*block\s+(\w+)\s*[-]?%\}/g;
+        const blockClose = /\{%[-\s]*endblock\s*[-]?%\}/g;
+        const engine = this;
+        const pieces = [];
+        let pos = 0;
+        while (pos < source.length) {
+          blockOpen.lastIndex = pos;
+          const mOpen = blockOpen.exec(source);
+          if (!mOpen) {
+            pieces.push(source.slice(pos));
+            break;
+          }
+          pieces.push(source.slice(pos, mOpen.index));
+          const name = mOpen[1];
+          const contentStart = mOpen.index + mOpen[0].length;
+          let depth = 1;
+          let scan = contentStart;
+          let closeMatch = null;
+          while (depth > 0 && scan < source.length) {
+            blockOpen.lastIndex = scan;
+            blockClose.lastIndex = scan;
+            const nextOpen = blockOpen.exec(source);
+            const nextClose = blockClose.exec(source);
+            if (!nextClose) break;
+            if (nextOpen && nextOpen.index < nextClose.index) {
+              depth++;
+              scan = nextOpen.index + nextOpen[0].length;
+            } else {
+              depth--;
+              if (depth === 0) {
+                closeMatch = nextClose;
+              } else {
+                scan = nextClose.index + nextClose[0].length;
+              }
+            }
+          }
+          if (!closeMatch) {
+            pieces.push(source.slice(mOpen.index));
+            pos = source.length;
+            break;
+          }
+          const parentContent = source.slice(contentStart, closeMatch.index);
+          const blockSource = blocks[name] ?? parentContent;
+          const resolvedSource = engine.substituteBlocks(blockSource, blocks, context);
+          let renderedParent = null;
+          const getParent = () => {
+            if (renderedParent === null) {
+              renderedParent = new SafeString(
+                engine.renderTokens(tokenize(parentContent), context)
+              );
+            }
+            return renderedParent;
+          };
+          const blockCtx = { ...context, parent: getParent, super: getParent };
+          pieces.push(engine.renderTokens(tokenize(resolvedSource), blockCtx));
+          pos = closeMatch.index + closeMatch[0].length;
+        }
+        return pieces.join("");
+      }
       renderWithBlocks(parentSource, context, childBlocks) {
-        const extendsMatch = parentSource.trimStart().match(/\{%[-\s]*extends\s+["'](.+?)["']\s*[-]?%\}/);
-        if (extendsMatch) {
-          const grandparentName = extendsMatch[1];
+        const grandparentName = extendsTarget(parentSource);
+        if (grandparentName) {
           const grandparentSource = this.load(grandparentName);
           const parentBlocks = this.extractBlocks(parentSource);
           const mergedBlocks = { ...parentBlocks, ...childBlocks };
@@ -3142,22 +3240,7 @@ var init_engine = __esm({
           }
           return this.renderWithBlocks(grandparentSource, context, mergedBlocks);
         }
-        const pattern = /\{%[-\s]*block\s+(\w+)\s*[-]?%\}([\s\S]*?)\{%[-\s]*endblock\s*[-]?%\}/g;
-        const engine = this;
-        const result = parentSource.replace(pattern, (_match, name, parentContent) => {
-          const blockSource = childBlocks[name] ?? parentContent;
-          let renderedParent = null;
-          const getParent = () => {
-            if (renderedParent === null) {
-              renderedParent = new SafeString(
-                engine.renderTokens(tokenize(parentContent), context)
-              );
-            }
-            return renderedParent;
-          };
-          const blockCtx = { ...context, parent: getParent, super: getParent };
-          return this.renderTokens(tokenize(blockSource), blockCtx);
-        });
+        const result = this.substituteBlocks(parentSource, childBlocks, context);
         return this.renderTokens(tokenize(result), context);
       }
       renderTokens(tokens, context) {
@@ -3980,6 +4063,7 @@ var init_engine = __esm({
         const m = content.match(/^cache\s+["'](.+?)["']\s*(\d+)?/);
         const cacheKey = m ? m[1] : "default";
         const ttl = m && m[2] ? parseInt(m[2], 10) : 60;
+        sweepExpiredCache(this.fragmentCache);
         const cached = this.fragmentCache.get(cacheKey);
         if (cached) {
           const [htmlContent, expiresAt] = cached;
@@ -4027,6 +4111,7 @@ var init_engine = __esm({
           i++;
         }
         const rendered = this.renderTokens([...bodyTokens], context);
+        capCache(this.fragmentCache, TEMPLATE_CACHE_MAX);
         this.fragmentCache.set(cacheKey, [rendered, Date.now() + ttl * 1e3]);
         return [rendered, i];
       }
@@ -19481,14 +19566,14 @@ async function discoverRoutes(routesDir) {
     const currentMtime = statSync7(filePath).mtimeMs;
     if (_seenFiles.has(filePath) && _seenMtimes.get(filePath) === currentMtime) continue;
     const method = name.toUpperCase();
-    const relativePath3 = relative(routesDir, filePath);
-    const pattern = filePathToPattern(relativePath3);
+    const relativePath2 = relative(routesDir, filePath);
+    const pattern = filePathToPattern(relativePath2);
     try {
       const moduleUrl = `file://${filePath}?t=${currentMtime}`;
       const mod = await import(moduleUrl);
       const handler = mod.default ?? mod.handler;
       if (typeof handler !== "function") {
-        console.warn(`  Warning: ${relativePath3} does not export a handler function, skipping`);
+        console.warn(`  Warning: ${relativePath2} does not export a handler function, skipping`);
         continue;
       }
       const meta = mod.meta;
@@ -19500,7 +19585,7 @@ async function discoverRoutes(routesDir) {
       _seenMtimes.set(filePath, currentMtime);
       registeredFromThisScan++;
     } catch (err) {
-      console.error(`  Error loading route ${relativePath3}:`, err);
+      console.error(`  Error loading route ${relativePath2}:`, err);
       recordBrokenImport(filePath, err);
     }
   }
@@ -19534,8 +19619,8 @@ function recordBrokenImport(filePath, error) {
   } catch {
   }
 }
-function filePathToPattern(relativePath3) {
-  const parts = relativePath3.replace(/\\/g, "/").split("/").slice(0, -1);
+function filePathToPattern(relativePath2) {
+  const parts = relativePath2.replace(/\\/g, "/").split("/").slice(0, -1);
   const urlParts = parts.map((part) => {
     if (part.startsWith("[...") && part.endsWith("]")) {
       const name = part.slice(4, -1);
@@ -22772,489 +22857,127 @@ import * as fs3 from "node:fs";
 import * as path2 from "node:path";
 import { spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
-function walkFiles(dir, extensions, exclude = ["node_modules", ".git", "dist", "build"]) {
-  const results = [];
-  if (!fs3.existsSync(dir)) return results;
-  const entries = fs3.readdirSync(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    const fullPath = path2.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      if (!exclude.includes(entry.name)) {
-        results.push(...walkFiles(fullPath, extensions, exclude));
-      }
-    } else if (entry.isFile()) {
-      const ext = path2.extname(entry.name);
-      if (extensions.includes(ext) && !entry.name.endsWith(".d.ts")) {
-        results.push(fullPath);
-      }
-    }
-  }
-  return results;
-}
-function readFileSafe(filePath) {
-  try {
-    return fs3.readFileSync(filePath, "utf-8");
-  } catch {
-    return null;
-  }
-}
-function relativePath(filePath, root = ".") {
-  return path2.relative(root, filePath);
-}
-function countLines(source) {
-  const lines = source.split("\n");
-  let loc = 0;
-  let blank = 0;
-  let comment = 0;
-  let inBlockComment = false;
-  for (const line of lines) {
-    const stripped = line.trim();
-    if (!stripped) {
-      blank++;
-      continue;
-    }
-    if (inBlockComment) {
-      comment++;
-      if (stripped.includes("*/")) {
-        inBlockComment = false;
-      }
-      continue;
-    }
-    if (stripped.startsWith("/*")) {
-      comment++;
-      if (!stripped.includes("*/") || stripped.endsWith("/*")) {
-        inBlockComment = true;
-      }
-      continue;
-    }
-    if (stripped.startsWith("//")) {
-      comment++;
-      continue;
-    }
-    loc++;
-  }
-  return { loc, blank, comment };
-}
-function stripLiterals(source) {
-  const out = [];
-  const n = source.length;
-  let i = 0;
-  let prevSignificant = "";
-  let prevWord = "";
-  const regexKeywords = /* @__PURE__ */ new Set([
-    "return",
-    "typeof",
-    "instanceof",
-    "in",
-    "of",
-    "new",
-    "delete",
-    "void",
-    "throw",
-    "case",
-    "do",
-    "else",
-    "yield",
-    "await"
-  ]);
-  function prevEndsExpression() {
-    if (prevSignificant === "") return false;
-    if (/[A-Za-z0-9_$]/.test(prevSignificant)) {
-      return !regexKeywords.has(prevWord);
-    }
-    if (prevSignificant === ")" || prevSignificant === "]") return true;
-    if (prevSignificant === ".") return true;
-    return false;
-  }
-  while (i < n) {
-    const ch = source[i];
-    const next = i + 1 < n ? source[i + 1] : "";
-    if (ch === "/" && next === "/") {
-      out.push("//");
-      i += 2;
-      while (i < n && source[i] !== "\n") {
-        out.push(" ");
-        i++;
-      }
-      continue;
-    }
-    if (ch === "/" && next === "*") {
-      out.push("/*");
-      i += 2;
-      while (i < n && !(source[i] === "*" && source[i + 1] === "/")) {
-        out.push(source[i] === "\n" ? "\n" : " ");
-        i++;
-      }
-      if (i < n) {
-        out.push("*/");
-        i += 2;
-      }
-      continue;
-    }
-    if (ch === '"' || ch === "'") {
-      const quote = ch;
-      out.push(quote);
-      i++;
-      while (i < n && source[i] !== quote) {
-        if (source[i] === "\\" && i + 1 < n) {
-          out.push("  ");
-          i += 2;
-          continue;
-        }
-        if (source[i] === "\n") {
-          out.push("\n");
-          i++;
-          break;
-        }
-        out.push(" ");
-        i++;
-      }
-      if (i < n && source[i] === quote) {
-        out.push(quote);
-        i++;
-      }
-      prevSignificant = quote;
-      prevWord = "";
-      continue;
-    }
-    if (ch === "`") {
-      out.push("`");
-      i++;
-      while (i < n && source[i] !== "`") {
-        if (source[i] === "\\" && i + 1 < n) {
-          out.push(source[i + 1] === "\n" ? " \n" : "  ");
-          i += 2;
-          continue;
-        }
-        if (source[i] === "$" && source[i + 1] === "{") {
-          out.push("${");
-          i += 2;
-          let depth = 1;
-          const exprStart = i;
-          while (i < n && depth > 0) {
-            if (source[i] === "{") depth++;
-            else if (source[i] === "}") depth--;
-            if (depth === 0) break;
-            i++;
-          }
-          out.push(stripLiterals(source.slice(exprStart, i)));
-          if (i < n && source[i] === "}") {
-            out.push("}");
-            i++;
-          }
-          continue;
-        }
-        out.push(source[i] === "\n" ? "\n" : " ");
-        i++;
-      }
-      if (i < n && source[i] === "`") {
-        out.push("`");
-        i++;
-      }
-      prevSignificant = "`";
-      prevWord = "";
-      continue;
-    }
-    if (ch === "/" && !prevEndsExpression()) {
-      let j = i + 1;
-      let ok = false;
-      let inClass = false;
-      while (j < n) {
-        const c = source[j];
-        if (c === "\\") {
-          j += 2;
-          continue;
-        }
-        if (c === "\n") break;
-        if (c === "[") inClass = true;
-        else if (c === "]") inClass = false;
-        else if (c === "/" && !inClass) {
-          ok = true;
-          break;
-        }
-        j++;
-      }
-      if (ok) {
-        out.push("/");
-        for (let k = i + 1; k < j; k++) out.push(" ");
-        out.push("/");
-        i = j + 1;
-        while (i < n && /[a-z]/i.test(source[i])) {
-          out.push(source[i]);
-          i++;
-        }
-        prevSignificant = "/";
-        prevWord = "";
-        continue;
-      }
-    }
-    out.push(ch);
-    if (!/\s/.test(ch)) {
-      prevSignificant = ch;
-      if (/[A-Za-z0-9_$]/.test(ch)) {
-        prevWord = /[A-Za-z0-9_$]/.test(source[i - 1] ?? "") ? prevWord + ch : ch;
-      } else {
-        prevWord = "";
-      }
-    }
-    i++;
+function containsTypeScript(directory) {
+  if (!fs3.existsSync(directory) || !fs3.statSync(directory).isDirectory()) return false;
+  for (const entry of fs3.readdirSync(directory, { withFileTypes: true })) {
+    if (["node_modules", ".git", "dist", "build"].includes(entry.name)) continue;
+    const target = path2.join(directory, entry.name);
+    if (entry.isDirectory() ? containsTypeScript(target) : /\.[cm]?[jt]sx?$/.test(entry.name)) return true;
   }
-  return out.join("");
-}
-function countClassesQuick(source) {
-  const matches = source.match(
-    /(?:^|\n)\s*(?:export\s+)?(?:abstract\s+)?class\s+\w+/g
-  );
-  return matches ? matches.length : 0;
-}
-function countFunctionsQuick(source) {
-  const clean = stripLiterals(source);
-  let count = 0;
-  const funcDecls = clean.match(
-    /(?:^|\n)\s*(?:export\s+)?(?:async\s+)?function\s+\w+\s*\(/g
-  );
-  if (funcDecls) count += funcDecls.length;
-  const methods = clean.match(
-    /(?:^|\n)\s*(?:public\s+|private\s+|protected\s+)?(?:static\s+)?(?:async\s+)?(?:get\s+|set\s+)?\w+\s*\([^)]*\)\s*(?::\s*\S+)?\s*\{/g
-  );
-  if (methods) count += methods.length;
-  const arrows = clean.match(
-    /(?:^|\n)\s*(?:export\s+)?(?:const|let|var)\s+\w+\s*=\s*(?:async\s+)?\(/g
-  );
-  if (arrows) count += arrows.length;
-  return count;
-}
-function resolveRoot(root = "src") {
-  const rootPath = path2.resolve(root);
-  if (fs3.existsSync(rootPath) && walkFiles(rootPath, [".ts", ".js"]).length > 0) {
-    _lastScanRoot = rootPath;
-    return root;
-  }
-  const fwDir = path2.resolve(path2.dirname(new URL(import.meta.url).pathname));
-  _lastScanRoot = fwDir;
-  return fwDir;
-}
-function quickMetrics(root = "src") {
-  root = resolveRoot(root);
-  const rootPath = path2.resolve(root);
-  if (!fs3.existsSync(rootPath)) {
-    return { error: `Directory not found: ${root}` };
-  }
-  const tsFiles = walkFiles(rootPath, [".ts", ".js"]);
-  const twigFiles = walkFiles(rootPath, [".twig", ".html"]);
-  const migrationsDir = path2.resolve("migrations");
-  const migrationFiles = [
-    ...walkFiles(migrationsDir, [".sql"]),
-    ...walkFiles(migrationsDir, [".ts"])
-  ];
-  const scssFiles = walkFiles(rootPath, [".scss", ".css"]);
-  let totalLoc = 0;
-  let totalBlank = 0;
-  let totalComment = 0;
-  let totalClasses = 0;
-  let totalFunctions = 0;
-  const fileDetails = [];
-  for (const f of tsFiles) {
-    const source = readFileSafe(f);
-    if (source === null) continue;
-    const counts = countLines(source);
-    const classes = countClassesQuick(source);
-    const functions = countFunctionsQuick(source);
-    totalLoc += counts.loc;
-    totalBlank += counts.blank;
-    totalComment += counts.comment;
-    totalClasses += classes;
-    totalFunctions += functions;
-    fileDetails.push({
-      path: relativePath(f, rootPath),
-      loc: counts.loc,
-      blank: counts.blank,
-      comment: counts.comment,
-      classes,
-      functions
-    });
-  }
-  fileDetails.sort((a, b) => b.loc - a.loc);
-  let routeCount = 0;
-  let ormCount = 0;
-  for (const f of tsFiles) {
-    const source = readFileSafe(f);
-    if (source === null) continue;
-    const routes = source.match(
-      /(?:router\s*\.\s*(?:get|post|put|delete|patch|any)\s*\(|@(?:get|post|put|delete|patch)\s*\()/g
-    );
-    if (routes) routeCount += routes.length;
-    const orms = source.match(
-      /class\s+\w+\s+extends\s+(?:ORM|Model)\b/g
-    );
-    if (orms) ormCount += orms.length;
-  }
-  const breakdown = {
-    typescript: tsFiles.filter((f) => f.endsWith(".ts")).length,
-    javascript: tsFiles.filter((f) => f.endsWith(".js")).length,
-    templates: twigFiles.length,
-    migrations: migrationFiles.length,
-    stylesheets: scssFiles.length
-  };
-  return {
-    file_count: tsFiles.length,
-    total_loc: totalLoc,
-    total_blank: totalBlank,
-    total_comment: totalComment,
-    lloc: totalLoc,
-    classes: totalClasses,
-    functions: totalFunctions,
-    route_count: routeCount,
-    orm_count: ormCount,
-    template_count: twigFiles.length,
-    migration_count: migrationFiles.length,
-    avg_file_size: tsFiles.length > 0 ? Math.round(totalLoc / tsFiles.length * 10) / 10 : 0,
-    largest_files: fileDetails.slice(0, 10),
-    breakdown
-  };
+  return false;
 }
-function resolveScanTarget(root = "src") {
-  const resolved = resolveRoot(root);
-  const frameworkDir = path2.dirname(fileURLToPath(import.meta.url));
-  const real = path2.resolve(resolved);
-  const scanningFramework = real === frameworkDir || real.startsWith(frameworkDir);
-  return [resolved, scanningFramework ? "framework" : "project"];
+function resolveTarget(root = "src") {
+  const resolved = containsTypeScript(root) ? path2.resolve(root) : path2.dirname(fileURLToPath(import.meta.url));
+  const mode = containsTypeScript(root) ? "project" : "framework";
+  lastScanRoot = resolved;
+  return [resolved, mode];
 }
 function enginePath() {
-  const names = process.platform === "win32" ? ["tina4.exe", "tina4.cmd", "tina4"] : ["tina4"];
-  for (const dir of (process.env.PATH || "").split(path2.delimiter)) {
-    if (!dir) continue;
+  const names = process.platform === "win32" ? ["tina4.exe", "tina4"] : ["tina4"];
+  for (const directory of (process.env.PATH || "").split(path2.delimiter)) {
     for (const name of names) {
-      const candidate = path2.join(dir, name);
+      const candidate = path2.join(directory, name);
       try {
-        if (!fs3.statSync(candidate).isFile()) continue;
         fs3.accessSync(candidate, fs3.constants.X_OK);
+        if (!fs3.statSync(candidate).isFile()) continue;
+        const descriptor = fs3.openSync(candidate, "r");
+        const header = Buffer.alloc(2);
+        fs3.readSync(descriptor, header, 0, 2, 0);
+        fs3.closeSync(descriptor);
+        if (header.toString("latin1") !== "#!") return candidate;
       } catch {
         continue;
       }
-      try {
-        const fd = fs3.openSync(candidate, "r");
-        const buf = Buffer.alloc(2);
-        fs3.readSync(fd, buf, 0, 2, 0);
-        fs3.closeSync(fd);
-        if (buf.toString("latin1") === "#!") continue;
-      } catch {
-      }
-      return candidate;
     }
   }
   return null;
 }
 function runEngine(target) {
   const binary = enginePath();
-  if (binary === null) {
-    throw new MetricsEngineError(`tina4 not found on PATH - ${INSTALL_HINT}`);
-  }
-  const proc = spawnSync(binary, ["metrics", "--path", target, "--json"], {
+  if (!binary) throw new MetricsEngineError(`tina4 not found on PATH - ${INSTALL_HINT}`);
+  const processResult = spawnSync(binary, ["metrics", "--path", target, "--json"], {
     encoding: "utf8",
-    timeout: TIMEOUT_MS,
+    timeout: 6e4,
     maxBuffer: 64 * 1024 * 1024
   });
-  if (proc.error) {
-    const err = proc.error;
-    if (err.code === "ETIMEDOUT") {
-      throw new MetricsEngineError(`tina4 metrics timed out after ${TIMEOUT_MS / 1e3}s on ${target}`);
-    }
-    throw new MetricsEngineError(`could not run ${binary}: ${err.message}`);
+  if (processResult.error) {
+    throw new MetricsEngineError(`could not run ${binary}: ${processResult.error.message}`);
   }
-  if (proc.status !== 0) {
-    const detail = (proc.stderr || proc.stdout || "").trim().split("\n")[0];
-    throw new MetricsEngineError(
-      `tina4 metrics failed on ${target}: ${detail || `exit code ${proc.status}`}`
-    );
-  }
-  if (!proc.stdout || !proc.stdout.trim()) {
-    throw new MetricsEngineError(`tina4 metrics produced no output for ${target}`);
+  if (processResult.status !== 0) {
+    const detail = (processResult.stderr || processResult.stdout || "").trim().split("\n")[0];
+    throw new MetricsEngineError(`tina4 metrics failed on ${target}: ${detail || processResult.status}`);
   }
-  let payload;
   try {
-    payload = JSON.parse(proc.stdout);
-  } catch (e) {
-    throw new MetricsEngineError(`tina4 metrics returned unreadable JSON: ${e.message}`);
-  }
-  if (payload === null || typeof payload !== "object" || Array.isArray(payload)) {
-    throw new MetricsEngineError("tina4 metrics returned a non-object payload");
+    const payload = JSON.parse(processResult.stdout);
+    if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+      throw new Error("non-object payload");
+    }
+    return payload;
+  } catch (error) {
+    throw new MetricsEngineError(`tina4 metrics returned unreadable JSON: ${error.message}`);
   }
-  return payload;
 }
-function requireKey(payload, key, isArray) {
-  const value = payload[key];
-  const ok = isArray ? Array.isArray(value) : value !== null && typeof value === "object" && !Array.isArray(value);
-  if (!ok) {
-    throw new MetricsEngineError(
-      `engine payload has no usable '${key}' - the installed tina4 CLI predates a field the dashboard renders. Update it: ${INSTALL_HINT}`
-    );
+function requireArray(payload, key) {
+  if (!Array.isArray(payload[key])) {
+    throw new MetricsEngineError(`engine payload has no usable '${key}' - ${INSTALL_HINT}`);
   }
-  return value;
+  return payload[key];
 }
 function fullAnalysis(root = "src") {
-  const [resolved, scanMode] = resolveScanTarget(root);
+  const [resolved, scanMode] = resolveTarget(root);
   const payload = runEngine(resolved);
-  const summary = requireKey(payload, "summary", false);
-  const fileMetrics = requireKey(payload, "file_metrics", true);
-  const functions = requireKey(payload, "most_complex_functions", true);
-  const missing = SUMMARY_KEYS.filter((k) => !(k in summary));
-  if (missing.length) {
-    throw new MetricsEngineError(
-      `engine summary is missing ${missing.join(", ")} - update the CLI: ${INSTALL_HINT}`
-    );
-  }
-  if (fileMetrics.length) {
-    const absent = FILE_KEYS.filter((k) => !(k in fileMetrics[0]));
-    if (absent.length) throw new MetricsEngineError(`engine file_metrics is missing ${absent.join(", ")}`);
-  }
-  if (functions.length) {
-    const absent = FUNCTION_KEYS.filter((k) => !(k in functions[0]));
-    if (absent.length) throw new MetricsEngineError(`engine function metrics are missing ${absent.join(", ")}`);
+  const summary = payload.summary;
+  if (!summary || typeof summary !== "object" || Array.isArray(summary)) {
+    throw new MetricsEngineError(`engine payload has no usable 'summary' - ${INSTALL_HINT}`);
+  }
+  const fileMetrics = requireArray(payload, "file_metrics");
+  const functions = requireArray(payload, "most_complex_functions");
+  const missingSummary = SUMMARY_KEYS.filter((key) => !(key in summary));
+  if (missingSummary.length) throw new MetricsEngineError(`engine summary is missing ${missingSummary.join(", ")}`);
+  const missingFile = fileMetrics.length ? FILE_KEYS.filter((key) => !(key in fileMetrics[0])) : [];
+  if (missingFile.length) throw new MetricsEngineError(`engine file_metrics is missing ${missingFile.join(", ")}`);
+  const missingFunction = functions.length ? FUNCTION_KEYS.filter((key) => !(key in functions[0])) : [];
+  if (missingFunction.length) {
+    throw new MetricsEngineError(`engine function metrics are missing ${missingFunction.join(", ")}`);
   }
-  const result = {};
-  for (const key of SUMMARY_KEYS) result[key] = summary[key];
-  result.file_metrics = fileMetrics;
-  result.most_complex_functions = functions.slice(0, 15);
-  result.dependency_graph = payload.dependency_graph || {};
-  result.scan_mode = scanMode;
-  result.scan_root = path2.resolve(resolved);
-  result.engine = "tina4-cli";
-  return result;
+  return {
+    ...Object.fromEntries(SUMMARY_KEYS.map((key) => [key, summary[key]])),
+    file_metrics: fileMetrics,
+    most_complex_functions: functions.slice(0, 15),
+    dependency_graph: payload.dependency_graph || {},
+    scan_mode: scanMode,
+    scan_root: resolved,
+    engine: "tina4-cli"
+  };
 }
 function fileDetail(filePath) {
   if (!filePath) throw new MetricsEngineError("fileDetail needs a path");
   let target = filePath;
-  if (!fs3.existsSync(target) && _lastScanRoot) {
-    const candidate = path2.join(_lastScanRoot, filePath);
-    if (fs3.existsSync(candidate)) target = candidate;
-  }
+  if (!fs3.existsSync(target) && lastScanRoot) target = path2.join(lastScanRoot, filePath);
   if (!fs3.existsSync(target)) throw new MetricsEngineError(`no such file: ${filePath}`);
   if (fs3.statSync(target).isDirectory()) throw new MetricsEngineError(`not a file: ${filePath}`);
   const payload = runEngine(target);
-  const fileMetrics = requireKey(payload, "file_metrics", true);
-  if (!fileMetrics.length) {
-    throw new MetricsEngineError(`engine reported no metrics for ${filePath}`);
-  }
-  return { ...fileMetrics[0], engine: "tina4-cli" };
+  const files = requireArray(payload, "file_metrics");
+  if (!files.length) throw new MetricsEngineError(`engine reported no metrics for ${filePath}`);
+  return {
+    ...files[0],
+    function_count: files[0].functions || 0,
+    functions: requireArray(payload, "most_complex_functions"),
+    engine: "tina4-cli"
+  };
 }
-var _lastScanRoot, MetricsEngineError, TIMEOUT_MS, INSTALL_HINT, SUMMARY_KEYS, FILE_KEYS, FUNCTION_KEYS;
+var lastScanRoot, MetricsEngineError, INSTALL_HINT, SUMMARY_KEYS, FILE_KEYS, FUNCTION_KEYS;
 var init_metrics = __esm({
   "src/metrics.ts"() {
     "use strict";
-    _lastScanRoot = "";
+    lastScanRoot = "";
     MetricsEngineError = class extends Error {
       constructor(message) {
         super(message);
         this.name = "MetricsEngineError";
       }
     };
-    TIMEOUT_MS = 6e4;
-    INSTALL_HINT = [
-      "the tina4 CLI provides the metrics engine (ADR-0002). Install it with",
-      "  curl -fsSL https://tina4.com/install.sh | sh",
-      "or see https://tina4.com/cli"
-    ].join("\n");
+    INSTALL_HINT = "update the native tina4 CLI: https://tina4.com/cli";
     SUMMARY_KEYS = ["files_analyzed", "total_functions", "avg_complexity", "avg_maintainability"];
     FILE_KEYS = ["path", "loc", "avg_complexity", "maintainability", "has_tests"];
     FUNCTION_KEYS = ["name", "file", "line", "complexity", "loc"];
@@ -23262,7 +22985,7 @@ var init_metrics = __esm({
 });
 
 // src/feedback.ts
-import { readFileSync as readFileSync13, existsSync as existsSync13 } from "node:fs";
+import { readFileSync as readFileSync12, existsSync as existsSync13 } from "node:fs";
 import { dirname as dirname7, join as join18, resolve as resolve9 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 function feedbackEnabled() {
@@ -23403,7 +23126,7 @@ var init_feedback = __esm({
     handleFeedbackWidgetJs = (_req, res) => {
       let body;
       if (existsSync13(WIDGET_BUNDLE_PATH)) {
-        body = readFileSync13(WIDGET_BUNDLE_PATH);
+        body = readFileSync12(WIDGET_BUNDLE_PATH);
       } else {
         body = "console.warn('tina4-feedback-widget bundle not built yet');";
       }
@@ -23418,7 +23141,7 @@ var init_feedback = __esm({
 });
 
 // src/version.ts
-import { existsSync as existsSync14, readFileSync as readFileSync14 } from "node:fs";
+import { existsSync as existsSync14, readFileSync as readFileSync13 } from "node:fs";
 import { dirname as dirname8, join as join19 } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 function resolveFrameworkVersion() {
@@ -23427,7 +23150,7 @@ function resolveFrameworkVersion() {
     const pkgPath = join19(dir, "package.json");
     if (existsSync14(pkgPath)) {
       try {
-        const pkg = JSON.parse(readFileSync14(pkgPath, "utf-8"));
+        const pkg = JSON.parse(readFileSync13(pkgPath, "utf-8"));
         if (typeof pkg.version === "string" && pkg.version) return pkg.version;
       } catch {
       }
@@ -26215,8 +25938,8 @@ __export(context_exports, {
   fts5Supported: () => fts5Supported
 });
 import { DatabaseSync as DatabaseSync4 } from "node:sqlite";
-import { existsSync as existsSync16, mkdirSync as mkdirSync13, readFileSync as readFileSync16, readdirSync as readdirSync10, realpathSync as realpathSync5 } from "node:fs";
-import { basename as basename4, dirname as dirname10, extname as extname6, isAbsolute as isAbsolute6, join as join21, relative as relative4, resolve as resolve11 } from "node:path";
+import { existsSync as existsSync16, mkdirSync as mkdirSync13, readFileSync as readFileSync15, readdirSync as readdirSync10, realpathSync as realpathSync5 } from "node:fs";
+import { basename as basename4, dirname as dirname10, extname as extname5, isAbsolute as isAbsolute6, join as join21, relative as relative3, resolve as resolve11 } from "node:path";
 function fts5Supported() {
   try {
     const conn = new DatabaseSync4(":memory:");
@@ -26351,7 +26074,7 @@ var init_context = __esm({
       }
       // ── indexing ───────────────────────────────────────────────
       static chunksFor(label, text) {
-        const ext = extname6(label).toLowerCase();
+        const ext = extname5(label).toLowerCase();
         const special = SPECIAL_FILES.has(basename4(label).toLowerCase());
         if (CODE_EXTS.has(ext) || CONFIG_EXTS.has(ext) || special) {
           return chunkCode(text, label);
@@ -26369,7 +26092,7 @@ var init_context = __esm({
         const stored = label != null ? String(label) : String(file);
         let text;
         try {
-          text = readFileSync16(file, "utf-8");
+          text = readFileSync15(file, "utf-8");
         } catch {
           return 0;
         }
@@ -26390,7 +26113,7 @@ var init_context = __esm({
       static eligible(filename) {
         const fn = filename.toLowerCase();
         if (fn.endsWith(".min.js")) return false;
-        const ext = extname6(fn);
+        const ext = extname5(fn);
         return CODE_EXTS.has(ext) || DOC_EXTS.has(ext) || CONFIG_EXTS.has(ext) || SPECIAL_FILES.has(fn);
       }
       /**
@@ -26419,7 +26142,7 @@ var init_context = __esm({
           for (const fn of files) {
             if (!_Context.eligible(fn)) continue;
             const full = join21(dir, fn);
-            const rel = relative4(rootAbs, full);
+            const rel = relative3(rootAbs, full);
             total += this.indexPath(full, rel);
           }
           for (const d of subdirs) walk2(join21(dir, d));
@@ -26440,7 +26163,7 @@ var init_context = __esm({
         const raw = String(changedPath);
         const abs = isAbsolute6(raw) ? raw : join21(process.cwd(), raw);
         const resolved = realResolve(resolve11(abs));
-        const rel = relative4(this.root, resolved);
+        const rel = relative3(this.root, resolved);
         if (rel === "" || rel.startsWith("..") || isAbsolute6(rel)) {
           return -1;
         }
@@ -28362,7 +28085,7 @@ var init_job = __esm({
 });
 
 // src/queueBackends/liteBackend.ts
-import { mkdirSync as mkdirSync14, readdirSync as readdirSync11, readFileSync as readFileSync17, writeFileSync as writeFileSync10, unlinkSync as unlinkSync7, existsSync as existsSync17 } from "node:fs";
+import { mkdirSync as mkdirSync14, readdirSync as readdirSync11, readFileSync as readFileSync16, writeFileSync as writeFileSync10, unlinkSync as unlinkSync7, existsSync as existsSync17 } from "node:fs";
 import { join as join22 } from "node:path";
 import { randomUUID as randomUUID6 } from "node:crypto";
 var LiteBackend;
@@ -28462,7 +28185,7 @@ var init_liteBackend = __esm({
           const filePath = join22(dir, filename);
           let job;
           try {
-            job = JSON.parse(readFileSync17(filePath, "utf-8"));
+            job = JSON.parse(readFileSync16(filePath, "utf-8"));
           } catch {
             continue;
           }
@@ -28526,7 +28249,7 @@ var init_liteBackend = __esm({
           const filePath = join22(reservedDir, filename);
           let record;
           try {
-            record = JSON.parse(readFileSync17(filePath, "utf-8"));
+            record = JSON.parse(readFileSync16(filePath, "utf-8"));
           } catch {
             continue;
           }
@@ -28639,7 +28362,7 @@ var init_liteBackend = __esm({
         let count = 0;
         for (const file of files) {
           try {
-            const job = JSON.parse(readFileSync17(join22(scanDir, file), "utf-8"));
+            const job = JSON.parse(readFileSync16(join22(scanDir, file), "utf-8"));
             if (job.status === status2) count++;
           } catch {
           }
@@ -28696,7 +28419,7 @@ var init_liteBackend = __esm({
           const files = readdirSync11(dir).filter((f) => f.endsWith(".queue-data")).sort();
           for (const file of files) {
             try {
-              const job = JSON.parse(readFileSync17(join22(dir, file), "utf-8"));
+              const job = JSON.parse(readFileSync16(join22(dir, file), "utf-8"));
               const attempts = job.attempts || 0;
               if (attempts > 0 && attempts < maxRetries) {
                 results.push(job);
@@ -28722,7 +28445,7 @@ var init_liteBackend = __esm({
             const failedDir = join22(this.basePath, q, "failed");
             const filePath = join22(failedDir, `${jobId}.queue-data`);
             if (existsSync17(filePath)) {
-              const job = JSON.parse(readFileSync17(filePath, "utf-8"));
+              const job = JSON.parse(readFileSync16(filePath, "utf-8"));
               job.status = "pending";
               job.attempts = (job.attempts || 0) + 1;
               job.error = void 0;
@@ -28746,7 +28469,7 @@ var init_liteBackend = __esm({
           const files = readdirSync11(failedDir).filter((f) => f.endsWith(".queue-data")).sort();
           for (const file of files) {
             try {
-              const job = JSON.parse(readFileSync17(join22(failedDir, file), "utf-8"));
+              const job = JSON.parse(readFileSync16(join22(failedDir, file), "utf-8"));
               if ((job.attempts || 0) >= maxRetries) {
                 job.status = "dead";
                 results.push(job);
@@ -28780,7 +28503,7 @@ var init_liteBackend = __esm({
             const files = readdirSync11(dir).filter((f) => f.endsWith(".queue-data"));
             for (const file of files) {
               try {
-                const job = JSON.parse(readFileSync17(join22(dir, file), "utf-8"));
+                const job = JSON.parse(readFileSync16(join22(dir, file), "utf-8"));
                 if (job.status === status2) {
                   unlinkSync7(join22(dir, file));
                   count++;
@@ -28807,7 +28530,7 @@ var init_liteBackend = __esm({
           for (const file of files) {
             try {
               const filePath = join22(failedDir, file);
-              const job = JSON.parse(readFileSync17(filePath, "utf-8"));
+              const job = JSON.parse(readFileSync16(filePath, "utf-8"));
               if ((job.attempts || 0) >= maxRetries) {
                 continue;
               }
@@ -28839,7 +28562,7 @@ var init_liteBackend = __esm({
           const filePath = join22(dir, file);
           let job;
           try {
-            job = JSON.parse(readFileSync17(filePath, "utf-8"));
+            job = JSON.parse(readFileSync16(filePath, "utf-8"));
           } catch {
             continue;
           }
@@ -30302,7 +30025,7 @@ function detectVersion(projectRoot3) {
   }
   return "0.0.0";
 }
-function relativePath2(absPath, projectRoot3, frameworkRoots) {
+function relativePath(absPath, projectRoot3, frameworkRoots) {
   const norm = path6.resolve(absPath);
   for (const fw of frameworkRoots) {
     const parent = path6.dirname(fw);
@@ -30767,7 +30490,7 @@ function buildEntriesForFile(absPath, source, fwRoots, projectRoot3, version, ou
   } catch {
     return;
   }
-  const rel = relativePath2(absPath, projectRoot3, fwRoots);
+  const rel = relativePath(absPath, projectRoot3, fwRoots);
   for (const cls of parsed.classes) {
     if (!cls.exported && source === "framework") {
       continue;
@@ -31403,8 +31126,8 @@ ${end}
 
 // src/devAdmin.ts
 import { cpus as osCpus } from "node:os";
-import { readFileSync as readFileSync21, writeFileSync as writeFileSync14, existsSync as existsSync21, readdirSync as readdirSync15, mkdirSync as mkdirSync17, copyFileSync, statSync as statSync16 } from "node:fs";
-import { join as join26, dirname as dirname12, resolve as resolve15, relative as relative8 } from "node:path";
+import { readFileSync as readFileSync20, writeFileSync as writeFileSync14, existsSync as existsSync21, readdirSync as readdirSync15, mkdirSync as mkdirSync17, copyFileSync, statSync as statSync16 } from "node:fs";
+import { join as join26, dirname as dirname12, resolve as resolve15, relative as relative7 } from "node:path";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 import { timingSafeEqual as timingSafeEqual2 } from "node:crypto";
 function escapeHtml(value) {
@@ -31523,7 +31246,7 @@ function readQueueDir(dir, topic, status2) {
   for (const filename of readdirSync15(dir).sort()) {
     if (!filename.endsWith(".queue-data")) continue;
     try {
-      jobs.push(mapQueueJob(JSON.parse(readFileSync21(join26(dir, filename), "utf-8")), topic, status2));
+      jobs.push(mapQueueJob(JSON.parse(readFileSync20(join26(dir, filename), "utf-8")), topic, status2));
     } catch {
     }
   }
@@ -31642,7 +31365,7 @@ function resolveDevEnvVar(key) {
   if (live !== void 0 && live !== "") return live;
   const envPath = join26(process.cwd(), ".env");
   if (!existsSync21(envPath)) return "";
-  for (const line of readFileSync21(envPath, "utf-8").split("\n")) {
+  for (const line of readFileSync20(envPath, "utf-8").split("\n")) {
     const t = line.trim();
     if (!t || t.startsWith("#") || !t.includes("=")) continue;
     const eq = t.indexOf("=");
@@ -31652,7 +31375,7 @@ function resolveDevEnvVar(key) {
 }
 function upsertDevEnvVar(key, value) {
   const envPath = join26(process.cwd(), ".env");
-  const lines = existsSync21(envPath) ? readFileSync21(envPath, "utf-8").split("\n") : [];
+  const lines = existsSync21(envPath) ? readFileSync20(envPath, "utf-8").split("\n") : [];
   let found = false;
   const out = [];
   for (const line of lines) {
@@ -31685,7 +31408,7 @@ function parseEnvFile() {
   const envPath = join26(process.cwd(), ".env");
   const result = {};
   if (!existsSync21(envPath)) return result;
-  const lines = readFileSync21(envPath, "utf-8").split("\n");
+  const lines = readFileSync20(envPath, "utf-8").split("\n");
   for (const line of lines) {
     const trimmed = line.trim();
     if (!trimmed || trimmed.startsWith("#") || !trimmed.includes("=")) continue;
@@ -31725,7 +31448,7 @@ function handleGalleryDeploy(router) {
     const copied = [];
     const allFiles = walkDirRecursive(gallerySrc);
     for (const srcFile of allFiles) {
-      const rel = relative8(gallerySrc, srcFile);
+      const rel = relative7(gallerySrc, srcFile);
       const dest = join26(projectSrc, rel);
       mkdirSync17(dirname12(dest), { recursive: true });
       copyFileSync(srcFile, dest);
@@ -32387,9 +32110,6 @@ var init_devAdmin = __esm({
           { method: "GET", pattern: "/__dev/api/gallery", handler: handleGalleryList },
           { method: "POST", pattern: "/__dev/api/gallery/deploy", handler: handleGalleryDeploy(router) },
           // Metrics
-          { method: "GET", pattern: "/__dev/api/metrics", handler: (_req, res) => {
-            res.json(quickMetrics());
-          } },
           // No fallback (ADR-0002): a missing or stale CLI is a 503 naming the
           // install command, never zeros that read as a healthy codebase.
           { method: "GET", pattern: "/__dev/api/metrics/full", handler: (_req, res) => {
@@ -33198,7 +32918,7 @@ var init_devAdmin = __esm({
       }
       try {
         const envPath = join26(process.cwd(), ".env");
-        const lines = existsSync21(envPath) ? readFileSync21(envPath, "utf-8").split("\n") : [];
+        const lines = existsSync21(envPath) ? readFileSync20(envPath, "utf-8").split("\n") : [];
         const keysFound = { TINA4_DATABASE_URL: false, TINA4_DATABASE_USERNAME: false, TINA4_DATABASE_PASSWORD: false };
         const newLines = [];
         for (const line of lines) {
@@ -33244,12 +32964,12 @@ var init_devAdmin = __esm({
           const metaFile = join26(entryPath, "meta.json");
           if (statSync16(entryPath).isDirectory() && existsSync21(metaFile)) {
             try {
-              const meta = JSON.parse(readFileSync21(metaFile, "utf-8"));
+              const meta = JSON.parse(readFileSync20(metaFile, "utf-8"));
               meta.id = entry;
               const srcDir = join26(entryPath, "src");
               if (existsSync21(srcDir)) {
                 const allFiles = walkDirRecursive(srcDir);
-                meta.files = allFiles.map((f) => relative8(srcDir, f));
+                meta.files = allFiles.map((f) => relative7(srcDir, f));
               }
               const projectSrc = resolve15(process.cwd(), "src");
               if (existsSync21(srcDir) && meta.files) {
@@ -33367,7 +33087,7 @@ var init_devAdmin = __esm({
       for (const name of readdirSync15(target).sort()) {
         if (devFilesHidden(name)) continue;
         const full = join26(target, name);
-        const entryRel = relative8(root, full).replace(/\\/g, "/");
+        const entryRel = relative7(root, full).replace(/\\/g, "/");
         if (isSecretPath(entryRel)) continue;
         let isDir = false;
         let size = null;
@@ -33412,7 +33132,7 @@ var init_devAdmin = __esm({
           size
         });
       }
-      res.json({ path: relative8(root, target).replace(/\\/g, "/") || ".", branch, entries });
+      res.json({ path: relative7(root, target).replace(/\\/g, "/") || ".", branch, entries });
     };
     DEV_ADMIN_LANG_MAP = {
       ".py": "python",
@@ -33464,8 +33184,8 @@ var init_devAdmin = __esm({
         return;
       }
       try {
-        const content = readFileSync21(target, "utf-8");
-        const path8 = relative8(root, target);
+        const content = readFileSync20(target, "utf-8");
+        const path8 = relative7(root, target);
         res.json({ path: path8, content, language: devAdminLanguage(path8), bytes: Buffer.byteLength(content, "utf-8") });
       } catch (e) {
         res.json({ error: e.message }, 500);
@@ -33487,10 +33207,10 @@ var init_devAdmin = __esm({
         writeFileSync14(target, content, "utf-8");
         try {
           const { Plan: Plan2 } = await Promise.resolve().then(() => (init_plan(), plan_exports));
-          Plan2.recordAction(existed ? "patched" : "created", relative8(root, target));
+          Plan2.recordAction(existed ? "patched" : "created", relative7(root, target));
         } catch {
         }
-        res.json({ ok: true, path: relative8(root, target), bytes: Buffer.byteLength(content, "utf-8") });
+        res.json({ ok: true, path: relative7(root, target), bytes: Buffer.byteLength(content, "utf-8") });
       } catch (e) {
         res.json({ error: e.message }, 500);
       }
@@ -33510,7 +33230,7 @@ var init_devAdmin = __esm({
         return;
       }
       try {
-        const buf = readFileSync21(target);
+        const buf = readFileSync20(target);
         const ext = target.slice(target.lastIndexOf(".") + 1).toLowerCase();
         const mime = {
           js: "application/javascript",
@@ -33552,7 +33272,7 @@ var init_devAdmin = __esm({
         const { renameSync: renameSync3 } = await import("node:fs");
         mkdirSync17(dirname12(dst), { recursive: true });
         renameSync3(src, dst);
-        res.json({ ok: true, from: relative8(root, src), to: relative8(root, dst) });
+        res.json({ ok: true, from: relative7(root, src), to: relative7(root, dst) });
       } catch (e) {
         res.json({ error: e.message }, 500);
       }
@@ -33573,7 +33293,7 @@ var init_devAdmin = __esm({
       try {
         const { rmSync } = await import("node:fs");
         rmSync(target, { recursive: true, force: true });
-        res.json({ ok: true, deleted: relative8(root, target) });
+        res.json({ ok: true, deleted: relative7(root, target) });
       } catch (e) {
         res.json({ error: e.message }, 500);
       }
@@ -33907,7 +33627,7 @@ var init_devAdmin = __esm({
       });
     };
     handleDevAdminJs = async (_req, res) => {
-      const { readFileSync: readFileSync28, existsSync: existsSync27 } = await import("node:fs");
+      const { readFileSync: readFileSync27, existsSync: existsSync27 } = await import("node:fs");
       const { dirname: dirname15, join: join32, resolve: resolve20 } = await import("node:path");
       const { fileURLToPath: fileURLToPath8 } = await import("node:url");
       const dir = dirname15(fileURLToPath8(import.meta.url));
@@ -33923,7 +33643,7 @@ var init_devAdmin = __esm({
       for (const jsPath of candidates) {
         if (existsSync27(jsPath)) {
           try {
-            const content = readFileSync28(jsPath, "utf-8");
+            const content = readFileSync27(jsPath, "utf-8");
             res.raw.writeHead(200, { "Content-Type": "application/javascript; charset=utf-8", "Cache-Control": "no-cache" });
             res.raw.end(content);
             return;
@@ -33938,7 +33658,7 @@ var init_devAdmin = __esm({
 });
 
 // src/i18n.ts
-import { readFileSync as readFileSync22, readdirSync as readdirSync16, existsSync as existsSync22 } from "node:fs";
+import { readFileSync as readFileSync21, readdirSync as readdirSync16, existsSync as existsSync22 } from "node:fs";
 import { join as join27, resolve as resolve16 } from "node:path";
 var I18n;
 var init_i18n = __esm({
@@ -34035,7 +33755,7 @@ var init_i18n = __esm({
         const filePath = join27(this._localeDir, `${locale}.json`);
         if (existsSync22(filePath)) {
           try {
-            const raw = readFileSync22(filePath, "utf-8");
+            const raw = readFileSync21(filePath, "utf-8");
             const data = JSON.parse(raw);
             this._translations.set(locale, _I18n._flatten(data));
             return;
@@ -34048,7 +33768,7 @@ var init_i18n = __esm({
           const yamlPath = join27(this._localeDir, `${locale}${ext}`);
           if (existsSync22(yamlPath)) {
             try {
-              const raw = readFileSync22(yamlPath, "utf-8");
+              const raw = readFileSync21(yamlPath, "utf-8");
               const data = _I18n._parseSimpleYaml(raw);
               this._translations.set(locale, _I18n._flatten(data));
               return;
@@ -34911,8 +34631,8 @@ var init_docsAutoDiscovery = __esm({
 // src/server.ts
 import { createServer as createServer2 } from "node:http";
 import { randomBytes as randomBytes7 } from "node:crypto";
-import { resolve as resolve18, dirname as dirname13, join as join29, relative as relative9 } from "node:path";
-import { existsSync as existsSync24, readdirSync as readdirSync17, readFileSync as readFileSync24, statSync as statSync17 } from "node:fs";
+import { resolve as resolve18, dirname as dirname13, join as join29, relative as relative8 } from "node:path";
+import { existsSync as existsSync24, readdirSync as readdirSync17, readFileSync as readFileSync23, statSync as statSync17 } from "node:fs";
 import { isatty } from "node:tty";
 import { fileURLToPath as fileURLToPath6 } from "node:url";
 import { execFileSync as execFileSync3, exec } from "node:child_process";
@@ -35136,7 +34856,7 @@ function getGalleryDeployedState() {
         if (existsSync24(srcDir)) {
           const files = walkGalleryFiles(srcDir);
           const projectSrc = resolve18(process.cwd(), "src");
-          state[entry] = files.every((f) => existsSync24(join29(projectSrc, relative9(srcDir, f))));
+          state[entry] = files.every((f) => existsSync24(join29(projectSrc, relative8(srcDir, f))));
         } else {
           state[entry] = false;
         }
@@ -35573,7 +35293,7 @@ function serveTemplateFallback(ctx) {
   if ((ctx.req.method ?? "GET") !== "GET") return false;
   const tplFile = resolveTemplate(ctx.pathname, ctx.templatesDir);
   if (!tplFile) return false;
-  const html = ctx.frondEngine ? ctx.frondEngine.render(tplFile, {}) : readFileSync24(resolve18(ctx.templatesDir, tplFile), "utf-8");
+  const html = ctx.frondEngine ? ctx.frondEngine.render(tplFile, {}) : readFileSync23(resolve18(ctx.templatesDir, tplFile), "utf-8");
   ctx.res.raw.writeHead(200, void 0, { "Content-Type": "text/html; charset=utf-8" });
   ctx.res.raw.end(html);
   return true;
@@ -36400,7 +36120,7 @@ var init_mqttMessage = __esm({
 import net2 from "node:net";
 import tls from "node:tls";
 import { randomBytes as randomBytes8 } from "node:crypto";
-import { existsSync as existsSync25, readFileSync as readFileSync25 } from "node:fs";
+import { existsSync as existsSync25, readFileSync as readFileSync24 } from "node:fs";
 var MqttError, MqttTimeoutError, CONNECT, CONNACK, PUBLISH, PUBACK, SUBSCRIBE, SUBACK, PINGREQ, PINGRESP, DISCONNECT, PROTOCOL_LEVEL, DEFAULT_PORT, DEFAULT_TLS_PORT, DEFAULT_URL, DEFAULT_KEEPALIVE, SUBSCRIPTION_REFUSED, MAX_REMAINING_LENGTH, QOS2_REFUSED_MESSAGE, CONNACK_RETURN_CODES, Mqtt;
 var init_mqtt = __esm({
   "src/mqtt.ts"() {
@@ -36865,7 +36585,7 @@ var init_mqtt = __esm({
               servername: this.host,
               rejectUnauthorized: this.tlsVerify
             };
-            if (this.tlsVerify && this.caFile) opts.ca = readFileSync25(this.caFile);
+            if (this.tlsVerify && this.caFile) opts.ca = readFileSync24(this.caFile);
             sock = tls.connect(opts, () => settle(() => resolve20(sock)));
           } else {
             sock = net2.createConnection({ host: this.host, port: this.port }, () => settle(() => resolve20(sock)));
@@ -37086,7 +36806,7 @@ var init_mqtt = __esm({
 
 // src/service.ts
 import { readdirSync as readdirSync18, statSync as statSync18, watchFile, unwatchFile } from "node:fs";
-import { join as join30, extname as extname8 } from "node:path";
+import { join as join30, extname as extname7 } from "node:path";
 import { pathToFileURL } from "node:url";
 function matchCronField(field, value) {
   if (field === "*") return true;
@@ -37257,7 +36977,7 @@ var init_service = __esm({
           return discovered;
         }
         for (const entry of entries) {
-          const ext = extname8(entry);
+          const ext = extname7(entry);
           if (ext !== ".ts" && ext !== ".js") continue;
           const fullPath = join30(dir, entry);
           const stat = statSync18(fullPath);
@@ -37373,7 +37093,7 @@ var init_service = __esm({
           return;
         }
         for (const entry of entries) {
-          const ext = extname8(entry);
+          const ext = extname7(entry);
           if (ext !== ".ts" && ext !== ".js") continue;
           const fullPath = join30(dir, entry);
           if (watchedFiles.has(fullPath)) continue;
@@ -38076,7 +37796,7 @@ var init_api = __esm({
 // src/messenger.ts
 import net3 from "node:net";
 import tls2 from "node:tls";
-import { readFileSync as readFileSync26 } from "node:fs";
+import { readFileSync as readFileSync25 } from "node:fs";
 import { basename as basename6 } from "node:path";
 import { randomUUID as randomUUID7 } from "node:crypto";
 function tlsRejectUnauthorized() {
@@ -38173,7 +37893,7 @@ function buildMimeMessage(options) {
     }
     for (const filePath of options.attachments) {
       const fileName = basename6(filePath);
-      const fileData = readFileSync26(filePath);
+      const fileData = readFileSync25(filePath);
       const base64Data = fileData.toString("base64");
       lines.push("");
       lines.push(`--${boundary}`);
@@ -39636,9 +39356,9 @@ var init_htmlElement = __esm({
 });
 
 // src/ai.ts
-import { existsSync as existsSync26, mkdirSync as mkdirSync20, writeFileSync as writeFileSync17, readFileSync as readFileSync27 } from "node:fs";
+import { existsSync as existsSync26, mkdirSync as mkdirSync20, writeFileSync as writeFileSync17, readFileSync as readFileSync26 } from "node:fs";
 import { homedir } from "node:os";
-import { join as join31, resolve as resolve19, relative as relative10, dirname as dirname14 } from "node:path";
+import { join as join31, resolve as resolve19, relative as relative9, dirname as dirname14 } from "node:path";
 import { fileURLToPath as fileURLToPath7 } from "node:url";
 import { execSync, execFileSync as execFileSync4 } from "node:child_process";
 import { createInterface } from "node:readline";
@@ -39646,7 +39366,7 @@ function readVersion() {
   try {
     const thisDir = dirname14(fileURLToPath7(import.meta.url));
     const rootPkg = resolve19(thisDir, "..", "..", "..", "package.json");
-    const pkg = JSON.parse(readFileSync27(rootPkg, "utf-8"));
+    const pkg = JSON.parse(readFileSync26(rootPkg, "utf-8"));
     return pkg.version ?? "0.0.0";
   } catch {
     return "0.0.0";
@@ -39664,14 +39384,16 @@ function downloadSkillsSync(jobs) {
     const jobs = JSON.parse(process.argv[1]);
     const fs = require("node:fs");
     const path = require("node:path");
+    const transientStatuses = new Set([429, 500, 502, 503, 504]);
     async function fetchOne(job) {
       const resp = await fetch(job.url, { signal: AbortSignal.timeout(15000) });
-      if (!resp.ok) throw new Error("HTTP " + resp.status);
+      if (!resp.ok) return { ok: false, retry: transientStatuses.has(resp.status) };
       const buf = Buffer.from(await resp.arrayBuffer());
       for (const dest of job.dests) {
         fs.mkdirSync(path.dirname(dest), { recursive: true });
         fs.writeFileSync(dest, buf);
       }
+      return { ok: true, retry: false };
     }
     (async () => {
       const ok = [];
@@ -39680,9 +39402,11 @@ function downloadSkillsSync(jobs) {
         const failed = [];
         await Promise.all(pending.map(async (job) => {
           try {
-            await fetchOne(job);
-            ok.push(job.url);
+            const result = await fetchOne(job);
+            if (result.ok) ok.push(job.url);
+            else if (result.retry) failed.push(job);
           } catch {
+            // DNS, TLS, timeout and connection failures are transient.
             failed.push(job);
           }
         }));
@@ -39865,7 +39589,7 @@ function writeOrMerge(contextPath, contextFile, frameworkGuide) {
     writeFileSync17(contextPath, frameworkGuide.replace(/\s+$/, "") + "\n\n" + block + "\n", "utf-8");
     return "Installed";
   }
-  const existing = readFileSync27(contextPath, "utf-8");
+  const existing = readFileSync26(contextPath, "utf-8");
   if (hasMarkers(existing, start2, end)) {
     writeFileSync17(contextPath, replaceMarkerBlock(existing, block, start2, end), "utf-8");
     return "Refreshed skill block in";
@@ -39889,7 +39613,7 @@ function installForTool(root, tool, context) {
   const parentDir = dirname14(contextPath);
   mkdirSync20(parentDir, { recursive: true });
   const action = writeOrMerge(contextPath, tool.contextFile, context);
-  const rel = relative10(root, contextPath);
+  const rel = relative9(root, contextPath);
   created.push(rel);
   console.log(`  ${GREEN2}\u2713${RESET2} ${action} ${rel}`);
   if (tool.name === "claude-code") {
@@ -40267,7 +39991,7 @@ function generateClaudeCodeContext() {
     const repoRoot = resolve19(thisDir, "..", "..", "..");
     const claudeMdPath = join31(repoRoot, "CLAUDE.md");
     if (existsSync26(claudeMdPath)) {
-      return readFileSync27(claudeMdPath, "utf-8");
+      return readFileSync26(claudeMdPath, "utf-8");
     }
   } catch {
   }
@@ -40461,6 +40185,292 @@ export default class User {
   }
 });
 
+// src/aiClient.ts
+import http2 from "node:http";
+import https2 from "node:https";
+var AiError, AiConfigError, AiTimeoutError, AiParseError, AiHTTPError, Ai;
+var init_aiClient = __esm({
+  "src/aiClient.ts"() {
+    "use strict";
+    AiError = class extends Error {
+    };
+    AiConfigError = class extends AiError {
+    };
+    AiTimeoutError = class extends AiError {
+    };
+    AiParseError = class extends AiError {
+    };
+    AiHTTPError = class extends AiError {
+      constructor(message, status2 = null) {
+        super(message);
+        this.status = status2;
+      }
+    };
+    Ai = class {
+      static chat(messages, options = {}) {
+        this.validateMessages(messages);
+        const config = this.config("chat", options);
+        const body = this.chatBody(config, messages, options);
+        const headers = this.headers(config);
+        return options.stream ? this.streamRequest(config, headers, body) : this.chatResponse(config, headers, body);
+      }
+      static async complete(prompt, options = {}) {
+        if (typeof prompt !== "string") throw new AiConfigError("AI prompt must be a string");
+        return (await this.chat([{ role: "user", content: prompt }], { ...options, stream: false })).text;
+      }
+      static async embed(textOrTexts, options = {}) {
+        const single = typeof textOrTexts === "string";
+        if (!single && (!Array.isArray(textOrTexts) || textOrTexts.length === 0 || !textOrTexts.every((item) => typeof item === "string"))) {
+          throw new AiConfigError("AI embedding input must be a string or a non-empty list of strings");
+        }
+        const config = this.config("embed", options);
+        if (config.provider === "anthropic") throw new AiConfigError("Anthropic does not provide the embedding endpoint in this contract");
+        const raw = await this.requestJson(config, this.headers(config), { model: config.model, input: textOrTexts });
+        try {
+          const data = raw.data.sort((a, b) => (a.index ?? 0) - (b.index ?? 0));
+          const vectors = data.map((item) => item.embedding);
+          const expected = single ? 1 : textOrTexts.length;
+          if (vectors.length !== expected || !vectors.every((vector) => Array.isArray(vector) && vector.length > 0 && vector.every((value) => typeof value === "number" && Number.isFinite(value)))) throw new Error();
+          return single ? vectors[0] : vectors;
+        } catch {
+          throw new AiParseError("AI provider returned a malformed embedding response");
+        }
+      }
+      static validateMessages(messages) {
+        if (!Array.isArray(messages) || messages.length === 0 || !messages.every((message) => message && ["system", "user", "assistant"].includes(message.role) && typeof message.content === "string")) {
+          throw new AiConfigError("AI messages must contain supported roles and string content");
+        }
+      }
+      static number(name, fallback, minimum) {
+        const value = process.env[name] === void 0 ? fallback : Number(process.env[name]);
+        if (!Number.isFinite(value) || value < minimum) throw new AiConfigError(`${name} must be numeric and at least ${minimum}`);
+        return value;
+      }
+      static config(capability, options) {
+        const provider = (options.provider ?? process.env.TINA4_AI_PROVIDER ?? "local").trim().toLowerCase();
+        if (provider !== "local" && provider !== "openai" && provider !== "anthropic") throw new AiConfigError("TINA4_AI_PROVIDER must be local, openai, or anthropic");
+        const key = process.env.TINA4_AI_KEY || null;
+        if ((provider === "openai" || provider === "anthropic") && !key) throw new AiConfigError(`TINA4_AI_KEY is required for the ${provider} provider`);
+        const defaults = {
+          local: ["http://localhost:11437", "llama3.2"],
+          openai: ["https://api.openai.com/v1", "gpt-4o-mini"],
+          anthropic: ["https://api.anthropic.com/v1", "claude-3-5-haiku-latest"]
+        };
+        const rawUrl = capability === "embed" && process.env.TINA4_EMBED_URL ? process.env.TINA4_EMBED_URL : process.env.TINA4_AI_URL ?? defaults[provider][0];
+        const model = (options.model ?? process.env.TINA4_AI_MODEL ?? defaults[provider][1]).trim();
+        if (!model) throw new AiConfigError("AI model must be a non-empty string");
+        const totalTimeout = options.timeout === void 0 ? this.number("TINA4_AI_TIMEOUT", 60, 1e-3) : Number(options.timeout);
+        if (!Number.isFinite(totalTimeout) || totalTimeout <= 0) throw new AiConfigError("AI timeout must be greater than zero");
+        return { provider, url: this.endpoint(rawUrl, capability, provider), model, key, totalTimeout, connectTimeout: this.number("TINA4_AI_CONNECT_TIMEOUT", 10, 1e-3), maxRetries: Math.trunc(this.number("TINA4_AI_MAX_RETRIES", 2, 0)) };
+      }
+      static endpoint(value, capability, provider) {
+        let url;
+        try {
+          url = new URL(value);
+        } catch {
+          throw new AiConfigError("AI URL must be an http or https URL");
+        }
+        if (url.protocol !== "http:" && url.protocol !== "https:") throw new AiConfigError("AI URL must be an http or https URL");
+        const path8 = url.pathname.replace(/\/+$/, "");
+        if (path8 === "" || path8 === "/v1" || path8 === "/api") {
+          const suffix = provider === "anthropic" ? "/messages" : capability === "embed" ? "/embeddings" : "/chat/completions";
+          url.pathname = (path8 || "/v1") + suffix;
+        }
+        return url.toString();
+      }
+      static headers(config) {
+        const headers = { "content-type": "application/json", accept: "application/json" };
+        if (config.provider === "openai") headers.authorization = `Bearer ${config.key}`;
+        if (config.provider === "anthropic") {
+          headers["x-api-key"] = config.key;
+          headers["anthropic-version"] = "2023-06-01";
+        }
+        return headers;
+      }
+      static chatBody(config, messages, options) {
+        const body = { model: config.model, messages, stream: options.stream ?? false };
+        if (options.temperature !== void 0) body.temperature = options.temperature;
+        if (options.maxTokens !== void 0) body.max_tokens = options.maxTokens;
+        if (config.provider === "anthropic") {
+          const system = messages.filter((message) => message.role === "system").map((message) => message.content);
+          body.messages = messages.filter((message) => message.role !== "system");
+          body.max_tokens = options.maxTokens ?? 1024;
+          if (system.length) body.system = system.join("\n\n");
+        }
+        return body;
+      }
+      static open(config, deadline, headers, body) {
+        const remainingMs = deadline - performance.now();
+        if (remainingMs <= 0) return Promise.reject(new AiTimeoutError("AI total request timeout expired"));
+        const url = new URL(config.url);
+        const payload = JSON.stringify(body);
+        const controller = new AbortController();
+        const totalTimer = setTimeout(() => controller.abort(new AiTimeoutError("AI total request timeout expired")), remainingMs);
+        return new Promise((resolve20, reject) => {
+          const client = url.protocol === "https:" ? https2 : http2;
+          const request = client.request(url, { method: "POST", headers: { ...headers, "content-length": Buffer.byteLength(payload) }, signal: controller.signal }, (response) => {
+            clearTimeout(connectTimer);
+            resolve20({ response, cleanup: () => {
+              clearTimeout(totalTimer);
+              clearTimeout(connectTimer);
+            } });
+          });
+          const connectTimer = setTimeout(() => request.destroy(new AiTimeoutError("AI connection timeout expired")), Math.min(config.connectTimeout * 1e3, remainingMs));
+          request.on("socket", (socket) => {
+            if (!socket.connecting) clearTimeout(connectTimer);
+            socket.once(url.protocol === "https:" ? "secureConnect" : "connect", () => clearTimeout(connectTimer));
+          });
+          request.once("error", (error) => {
+            clearTimeout(totalTimer);
+            clearTimeout(connectTimer);
+            if (error instanceof AiError) reject(error);
+            else if (controller.signal.aborted) reject(new AiTimeoutError("AI total request timeout expired"));
+            else reject(new AiHTTPError(`AI transport failed (${error.name})`));
+          });
+          request.end(payload);
+        });
+      }
+      static async readBody(response) {
+        const chunks = [];
+        for await (const chunk of response) chunks.push(Buffer.from(chunk));
+        return Buffer.concat(chunks).toString("utf8");
+      }
+      static retryDelay(headers, deadline) {
+        const value = Array.isArray(headers["retry-after"]) ? headers["retry-after"][0] : headers["retry-after"];
+        const requested = value !== void 0 && Number.isFinite(Number(value)) ? Math.max(0, Number(value) * 1e3) : 100;
+        const delay = Math.min(requested, Math.max(0, deadline - performance.now()));
+        return new Promise((resolve20) => setTimeout(resolve20, delay));
+      }
+      static async requestJson(config, headers, body) {
+        const deadline = performance.now() + config.totalTimeout * 1e3;
+        for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+          let opened = null;
+          try {
+            opened = await this.open(config, deadline, headers, body);
+            const status2 = opened.response.statusCode ?? 0;
+            const responseHeaders = opened.response.headers;
+            const raw = await this.readBody(opened.response);
+            opened.cleanup();
+            opened = null;
+            if (status2 < 200 || status2 >= 300) {
+              if ((status2 === 429 || status2 >= 500) && attempt < config.maxRetries) {
+                await this.retryDelay(responseHeaders, deadline);
+                continue;
+              }
+              throw new AiHTTPError(`AI provider returned HTTP ${status2}`, status2);
+            }
+            let parsed;
+            try {
+              parsed = JSON.parse(raw);
+            } catch {
+              throw new AiParseError("AI provider returned malformed JSON");
+            }
+            if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new AiParseError("AI provider returned a non-object JSON response");
+            return parsed;
+          } catch (error) {
+            opened?.cleanup();
+            if (error instanceof AiParseError || error instanceof AiHTTPError && error.status !== null) throw error;
+            if (attempt >= config.maxRetries) throw error;
+          }
+        }
+        throw new AiHTTPError("AI request failed");
+      }
+      static normalizeChat(provider, raw) {
+        try {
+          if (provider === "anthropic") {
+            const content = raw.content;
+            const parts = content.filter((item) => (item.type ?? "text") === "text").map((item) => item.text);
+            if (!parts.length || !parts.every((part) => typeof part === "string")) throw new Error();
+            const usage2 = raw.usage ?? {};
+            const promptTokens = Number(usage2.input_tokens ?? 0);
+            const completionTokens = Number(usage2.output_tokens ?? 0);
+            return { text: parts.join(""), model: String(raw.model ?? ""), usage: { promptTokens, completionTokens, totalTokens: promptTokens + completionTokens }, finishReason: raw.stop_reason == null ? null : String(raw.stop_reason), raw };
+          }
+          const choice = raw.choices[0];
+          const text = choice.message.content;
+          if (typeof text !== "string") throw new Error();
+          const usage = raw.usage ?? {};
+          return { text, model: String(raw.model ?? ""), usage: { promptTokens: Number(usage.prompt_tokens ?? 0), completionTokens: Number(usage.completion_tokens ?? 0), totalTokens: Number(usage.total_tokens ?? 0) }, finishReason: choice.finish_reason == null ? null : String(choice.finish_reason), raw };
+        } catch {
+          throw new AiParseError("AI provider returned a malformed chat response");
+        }
+      }
+      static async chatResponse(config, headers, body) {
+        return this.normalizeChat(config.provider, await this.requestJson(config, headers, body));
+      }
+      static streamDelta(provider, data) {
+        if (data === "[DONE]") return { completed: true };
+        let event;
+        try {
+          event = JSON.parse(data);
+        } catch {
+          throw new AiParseError("AI provider returned malformed stream data");
+        }
+        const text = provider === "anthropic" ? event.type === "content_block_delta" ? event.delta?.text : void 0 : event.choices?.[0]?.delta?.content;
+        if (text !== void 0 && text !== null && typeof text !== "string") throw new AiParseError("AI provider returned malformed stream data");
+        return { completed: false, text };
+      }
+      static async *streamData(response) {
+        let buffer = "";
+        for await (const chunk of response) {
+          buffer += Buffer.from(chunk).toString("utf8");
+          let newline;
+          while ((newline = buffer.indexOf("\n")) >= 0) {
+            const line = buffer.slice(0, newline).trim();
+            buffer = buffer.slice(newline + 1);
+            if (line.startsWith("data:")) yield line.slice(5).trim();
+          }
+        }
+      }
+      static streamError(error) {
+        if (error instanceof AiError) return error;
+        if (error instanceof Error && error.name === "AbortError") return new AiTimeoutError("AI total request timeout expired");
+        return new AiHTTPError(`AI transport failed (${error instanceof Error ? error.name : "Error"})`);
+      }
+      static async *streamRequest(config, headers, body) {
+        const deadline = performance.now() + config.totalTimeout * 1e3;
+        let yielded = false;
+        for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+          let opened = null;
+          try {
+            opened = await this.open(config, deadline, { ...headers, accept: "text/event-stream" }, body);
+            const status2 = opened.response.statusCode ?? 0;
+            if (status2 < 200 || status2 >= 300) {
+              await this.readBody(opened.response);
+              if ((status2 === 429 || status2 >= 500) && attempt < config.maxRetries) {
+                await this.retryDelay(opened.response.headers, deadline);
+                opened.cleanup();
+                opened = null;
+                continue;
+              }
+              throw new AiHTTPError(`AI provider returned HTTP ${status2}`, status2);
+            }
+            let completed = false;
+            for await (const data of this.streamData(opened.response)) {
+              const delta = this.streamDelta(config.provider, data);
+              if (delta.completed) {
+                completed = true;
+                break;
+              }
+              if (delta.text === void 0) continue;
+              yielded = true;
+              yield delta.text;
+            }
+            opened.cleanup();
+            opened = null;
+            if (completed) return;
+            throw new AiParseError("AI provider stream ended before [DONE]");
+          } catch (error) {
+            opened?.cleanup();
+            const failure = this.streamError(error);
+            if (failure instanceof AiParseError || failure instanceof AiHTTPError && failure.status !== null || yielded || attempt >= config.maxRetries) throw failure;
+          }
+        }
+      }
+    };
+  }
+});
+
 // src/queueBackends/rabbitmqBackend.ts
 import { execFileSync as execFileSync5 } from "node:child_process";
 import { randomUUID as randomUUID8 } from "node:crypto";
@@ -42164,6 +42174,12 @@ __export(index_exports, {
   APPLICATION_JSON: () => APPLICATION_JSON,
   APPLICATION_OCTET: () => APPLICATION_OCTET,
   APPLICATION_XML: () => APPLICATION_XML,
+  Ai: () => Ai,
+  AiConfigError: () => AiConfigError,
+  AiError: () => AiError,
+  AiHTTPError: () => AiHTTPError,
+  AiParseError: () => AiParseError,
+  AiTimeoutError: () => AiTimeoutError,
   Api: () => Api,
   Auth: () => Auth,
   CANONICAL_SESSION_BACKENDS: () => CANONICAL_SESSION_BACKENDS,
@@ -42490,6 +42506,7 @@ var init_index = __esm({
     init_htmlElement();
     init_errorOverlay();
     init_ai();
+    init_aiClient();
     init_liteBackend();
     init_rabbitmqBackend();
     init_kafkaBackend();
@@ -42519,6 +42536,12 @@ export {
   APPLICATION_JSON,
   APPLICATION_OCTET,
   APPLICATION_XML,
+  Ai,
+  AiConfigError,
+  AiError,
+  AiHTTPError,
+  AiParseError,
+  AiTimeoutError,
   Api,
   Auth,
   CANONICAL_SESSION_BACKENDS,