engramx 2.0.0 → 2.0.1

package/CHANGELOG.md

@@ -4,6 +4,38 @@ All notable changes to engram are documented here. Format based on
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versioning follows
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.0.1] — 2026-04-17 — Windows CI + favicon route
+
+Patch release fixing two issues caught immediately after v2.0.0 shipped.
+
+### Fixed
+
+- **Windows cross-platform bug in the plugin loader.** `PLUGINS_DIR` was a
+  module-load-time constant that baked in `homedir()` at import time. Windows
+  uses `USERPROFILE` while Unix uses `HOME`, and a frozen constant meant any
+  runtime override (tests, future `--plugins-dir` flag, programmatic use)
+  couldn't take effect without a module reload. Windows CI failed on the
+  plugin-loader tests because `process.env.HOME` mutation had no effect.
+  Fixed by introducing `getPluginsDir()` that resolves on every call, and
+  accepting an optional `dir` parameter on `loadPlugins()`,
+  `getLoadedPlugins()`, and `ensurePluginsDir()`. The `PLUGINS_DIR` constant
+  is retained for back-compat but runtime paths now go through the getter.
+- **`/favicon.ico` returning 404 for clients that ignore `<link rel="icon">`.**
+  Added an explicit `GET /favicon.ico` route to the HTTP server that serves
+  a 238-byte inline SVG favicon with `Cache-Control: public, max-age=86400`.
+  The dashboard HTML still inlines the same favicon via `<link>` so modern
+  browsers avoid the request entirely.
+
+### Changed
+
+- Test count: 640 → 641 (+1 for the "plugins directory does not exist"
+  branch of `loadPlugins()`).
+
+### CI
+
+- Verified green on GitHub Actions matrix: Ubuntu + Windows × Node 20 + 22.
+  Commit `7c6001c`.
+
 ## [2.0.0] — 2026-04-17 — "Ecosystem"
 
 The biggest release since v1.0.0. Completes the v2.0 roadmap Phases 1–4:

package/dist/cli.js

@@ -1351,7 +1351,7 @@ var BUILTIN_PROVIDERS = [
 ];
 var BUILTIN_NAMES = new Set(BUILTIN_PROVIDERS.map((p) => p.name));
 async function getAllProviders() {
-  const { getLoadedPlugins } = await import("./plugin-loader-FCOMVOX7.js");
+  const { getLoadedPlugins } = await import("./plugin-loader-STTGYIL5.js");
   const { loaded } = await getLoadedPlugins();
   const safePlugins = loaded.filter((p) => !BUILTIN_NAMES.has(p.name));
   return [...BUILTIN_PROVIDERS, ...safePlugins];
@@ -3605,7 +3605,7 @@ program.command("stress-test").description("Run stress tests: memory, concurrenc
   }
 });
 program.command("server").description("Start engram HTTP REST server (binds to 127.0.0.1 only)").option("--http", "Enable HTTP server (default)").option("--port <port>", "HTTP port", "7337").option("-p, --project <path>", "Project directory", ".").action(async (opts) => {
-  const { startHttpServer } = await import("./server-VBRTTECZ.js");
+  const { startHttpServer } = await import("./server-6AOI7NQP.js");
   await startHttpServer(pathResolve(opts.project), parseInt(opts.port, 10));
 });
 program.command("ui").description("Open the web dashboard (auto-starts HTTP server if needed)").option("--port <port>", "HTTP port", "7337").option("-p, --project <path>", "Project directory", ".").option("--no-open", "Don't launch browser, just print the URL").action(async (opts) => {
@@ -3798,13 +3798,14 @@ dbCmd.command("rollback").description("Roll back to an earlier schema version (D
 });
 var pluginCmd = program.command("plugin").description("Manage context provider plugins");
 pluginCmd.command("list").description("List installed provider plugins").action(async () => {
-  const { loadPlugins, PLUGINS_DIR, ensurePluginsDir } = await import("./plugin-loader-FCOMVOX7.js");
-  ensurePluginsDir();
-  const { loaded, failed } = await loadPlugins();
+  const { loadPlugins, getPluginsDir, ensurePluginsDir } = await import("./plugin-loader-STTGYIL5.js");
+  const dir = getPluginsDir();
+  ensurePluginsDir(dir);
+  const { loaded, failed } = await loadPlugins(dir);
   if (loaded.length === 0 && failed.length === 0) {
     console.log(chalk2.dim(`No plugins installed.`));
     console.log(chalk2.dim(`Install with: engram plugin install <file.mjs>`));
-    console.log(chalk2.dim(`Plugins directory: ${PLUGINS_DIR}`));
+    console.log(chalk2.dim(`Plugins directory: ${dir}`));
     return;
   }
   if (loaded.length > 0) {
@@ -3830,7 +3831,7 @@ pluginCmd.command("list").description("List installed provider plugins").action(
 pluginCmd.command("install").description("Install a plugin by copying its .mjs file into ~/.engram/plugins/").argument("<file>", "Path to plugin .mjs file").action(async (file) => {
   const { copyFileSync: copyFileSync2, statSync: statSync5 } = await import("fs");
   const { basename: basename6 } = await import("path");
-  const { PLUGINS_DIR, ensurePluginsDir, validatePlugin } = await import("./plugin-loader-FCOMVOX7.js");
+  const { getPluginsDir, ensurePluginsDir, validatePlugin } = await import("./plugin-loader-STTGYIL5.js");
   const { pathToFileURL } = await import("url");
   const absPath = pathResolve(file);
   if (!existsSync9(absPath)) {
@@ -3859,18 +3860,20 @@ pluginCmd.command("install").description("Install a plugin by copying its .mjs f
     console.error(chalk2.red(`Failed to load plugin: ${e.message}`));
     process.exit(1);
   }
-  ensurePluginsDir();
+  const pluginsDir = getPluginsDir();
+  ensurePluginsDir(pluginsDir);
   const destName = basename6(absPath);
-  const destPath = join9(PLUGINS_DIR, destName);
+  const destPath = join9(pluginsDir, destName);
   copyFileSync2(absPath, destPath);
   console.log(chalk2.green(`\u2713 Installed: ${destPath}`));
 });
 pluginCmd.command("remove").description("Remove an installed plugin by filename").argument("<filename>", "Plugin filename (e.g., my-provider.mjs)").action(async (filename) => {
-  const { PLUGINS_DIR } = await import("./plugin-loader-FCOMVOX7.js");
-  const target = join9(PLUGINS_DIR, filename);
+  const { getPluginsDir } = await import("./plugin-loader-STTGYIL5.js");
+  const pluginsDir = getPluginsDir();
+  const target = join9(pluginsDir, filename);
   if (!existsSync9(target)) {
     console.error(chalk2.red(`No such plugin: ${filename}`));
-    console.log(chalk2.dim(`Plugins directory: ${PLUGINS_DIR}`));
+    console.log(chalk2.dim(`Plugins directory: ${pluginsDir}`));
     process.exit(1);
   }
   unlinkSync(target);

package/dist/{plugin-loader-FCOMVOX7.js → plugin-loader-STTGYIL5.js}

@@ -3,10 +3,14 @@ import { existsSync, readdirSync, mkdirSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
 import { pathToFileURL } from "url";
-var PLUGINS_DIR = join(homedir(), ".engram", "plugins");
-function ensurePluginsDir() {
-  if (!existsSync(PLUGINS_DIR)) {
-    mkdirSync(PLUGINS_DIR, { recursive: true });
+function getPluginsDir() {
+  return join(homedir(), ".engram", "plugins");
+}
+var PLUGINS_DIR = getPluginsDir();
+function ensurePluginsDir(dir) {
+  const target = dir ?? getPluginsDir();
+  if (!existsSync(target)) {
+    mkdirSync(target, { recursive: true });
   }
 }
 function validatePlugin(mod) {
@@ -48,20 +52,21 @@ function validatePlugin(mod) {
   }
   return { plugin: candidate, reason: "" };
 }
-async function loadPlugins() {
+async function loadPlugins(dir) {
+  const pluginsDir = dir ?? getPluginsDir();
   const loaded = [];
   const failed = [];
-  if (!existsSync(PLUGINS_DIR)) {
+  if (!existsSync(pluginsDir)) {
     return { loaded, failed };
   }
   let files;
   try {
-    files = readdirSync(PLUGINS_DIR).filter((f) => f.endsWith(".mjs") || f.endsWith(".js"));
+    files = readdirSync(pluginsDir).filter((f) => f.endsWith(".mjs") || f.endsWith(".js"));
   } catch {
     return { loaded, failed };
   }
   for (const file of files) {
-    const fullPath = join(PLUGINS_DIR, file);
+    const fullPath = join(pluginsDir, file);
     try {
       const mod = await import(pathToFileURL(fullPath).href);
       const { plugin, reason } = validatePlugin(mod);
@@ -81,9 +86,9 @@ async function loadPlugins() {
   return { loaded, failed };
 }
 var _cache = null;
-async function getLoadedPlugins() {
+async function getLoadedPlugins(dir) {
   if (_cache === null) {
-    _cache = await loadPlugins();
+    _cache = await loadPlugins(dir);
   }
   return _cache;
 }
@@ -95,6 +100,7 @@ export {
   _resetPluginCache,
   ensurePluginsDir,
   getLoadedPlugins,
+  getPluginsDir,
   loadPlugins,
   validatePlugin
 };

package/dist/{server-VBRTTECZ.js → server-6AOI7NQP.js}

@@ -1325,6 +1325,13 @@ function createHttpServer(projectRoot, port) {
             "Cache-Control": "no-cache"
           });
           res.end(buildDashboardHtml());
+        } else if (req.method === "GET" && path === "/favicon.ico") {
+          const svg = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100"><rect width="100" height="100" rx="20" fill="#0a0a0b"/><text x="50" y="62" font-size="56" text-anchor="middle" fill="#10b981" font-family="Menlo,monospace">&#9670;</text></svg>';
+          res.writeHead(200, {
+            "Content-Type": "image/svg+xml",
+            "Cache-Control": "public, max-age=86400"
+          });
+          res.end(svg);
         } else {
           json(res, 404, { error: "Not found" });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "engramx",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "The context spine for AI coding agents. 8 providers + pluggable context sources, 3-layer memory cache, web dashboard, multi-IDE support (Claude Code, Cursor, Continue, Zed, Aider, Windsurf, Neovim, Emacs). 88.1% measured session-level token savings. Local SQLite, zero native deps, zero cloud.",
   "repository": {
     "type": "git",