minimal-agent 0.3.1 → 0.3.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minimal-agent",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "最小化 Agent 系统 —— 10 工具 + 插件系统 + workflow DSL + 自动压缩 + OpenAI 兼容 + Ink TUI；NodeNext + tsc 原地编译，dev 用 Bun .ts、install 用 Node .js（学习/教学用）",
   "license": "SEE LICENSE IN LICENSE",
   "author": "Bill Wang <leiwang0359@gmail.com>",

package/src/plugins/pluginLoader.js

@@ -13,6 +13,9 @@
  *
  *  契约：
  *   - 两个文件都不存在 → 缓存 null（纯 markdown 声明式插件）
+ *   - 两个文件都存在 + plugin.ts mtime > plugin.js mtime → console.warn
+ *     提示 stale（dev 模式跑过 build 后又改 .ts 源码的常见坑），加载行为
+ *     不变仍优先 plugin.js
  *   - import 失败（语法错 / 运行时抛错）→ console.warn + 缓存 null
  *   - import 成功但 default 不是对象 → 缓存 null
  *   - 缓存 key = pluginRoot 绝对路径
@@ -20,7 +23,7 @@
  *  框架 hot-reload 由测试调用 _resetPluginLoader() 实现。
  * ============================================================
  */
-import { existsSync } from 'node:fs';
+import { existsSync, statSync } from 'node:fs';
 import { join } from 'node:path';
 import { pathToFileURL } from 'node:url';
 const loaderCache = new Map();
@@ -41,9 +44,25 @@ export async function loadPluginApi(pluginRoot) {
         return loaderCache.get(pluginRoot) ?? null;
     }
     // prefer plugin.js（install / Node 兼容），fallback plugin.ts（dev / 用户 Bun 插件）
-    const pluginEntry = ['plugin.js', 'plugin.ts']
-        .map((f) => join(pluginRoot, f))
-        .find((p) => existsSync(p));
+    const jsPath = join(pluginRoot, 'plugin.js');
+    const tsPath = join(pluginRoot, 'plugin.ts');
+    const jsExists = existsSync(jsPath);
+    const tsExists = existsSync(tsPath);
+    // dev 模式 stale 检测：两文件都存在 + .ts 比 .js 新 → 用户改了源码但没清编译产物
+    if (jsExists && tsExists) {
+        try {
+            const jsMtime = statSync(jsPath).mtimeMs;
+            const tsMtime = statSync(tsPath).mtimeMs;
+            if (tsMtime > jsMtime) {
+                console.warn(`[minimal-agent] 检测到 stale plugin.js（${pluginRoot}）：plugin.ts 比 plugin.js 新，` +
+                    `加载器仍优先吃 plugin.js。如果你刚改过源码却没生效，请跑 \`bun run clean\` 删掉原地编译产物。`);
+            }
+        }
+        catch {
+            // stat 失败静默，不影响加载
+        }
+    }
+    const pluginEntry = jsExists ? jsPath : tsExists ? tsPath : undefined;
     if (!pluginEntry) {
         loaderCache.set(pluginRoot, null);
         return null;