agent-guardrails 0.3.3 → 0.3.5

package/README.md

@@ -138,6 +138,20 @@ npx agent-guardrails setup --agent <your-agent>
 - `openhands`
 - `openclaw`
 
+### 更新 / Update
+
+如果通过 **npm 全局安装**：
+```bash
+npm update -g agent-guardrails
+```
+
+如果通过 **npx / MCP 使用**（不需要改配置文件）：
+```bash
+# 清除 npx 缓存，下次启动时自动拉取最新版
+npm cache clean --force
+# 然后重启你的 AI 工具（Claude Code / Cursor 等）即可
+```
+
 ---
 
 ## 文档 / Documentation
@@ -573,6 +587,23 @@ The daemon monitors file changes and automatically runs guardrail checks:
 | Background process | Foreground process |
 | Best for active development | Best for pre-commit/CI |
 
+### MCP Integration / MCP 集成
+
+AI agents can read daemon results via the `read_daemon_status` MCP tool — no polling needed:
+
+```json
+{
+  "mcpServers": {
+    "agent-guardrails": {
+      "command": "npx",
+      "args": ["agent-guardrails", "mcp"]
+    }
+  }
+}
+```
+
+The agent calls `read_daemon_status` after code changes to check the latest guardrail result, including findings, risks, and cost hints.
+
 ---
 
 ## CLI Fallback Quick Start

package/lib/commands/daemon.js

@@ -23,6 +23,38 @@ const DAEMON_LOG_FILE = ".agent-guardrails/daemon.log";
 const DAEMON_CONFIG_FILE = ".agent-guardrails/daemon.json";
 const DAEMON_INFO_FILE = ".agent-guardrails/daemon-info.json";
 
+/**
+ * 注入/移除 AGENTS.md 中的守护进程规则
+ */
+
+const DAEMON_AGENTS_MARKER_START = "<!-- agent-guardrails:daemon:start -->";
+const DAEMON_AGENTS_MARKER_END = "<!-- agent-guardrails:daemon:end -->";
+const DAEMON_AGENTS_BLOCK = `\n${DAEMON_AGENTS_MARKER_START}
+## Daemon Mode / 守护模式
+
+Daemon 正在运行。每次修改文件后，请调用 \`read_daemon_status\` MCP 工具检查 guardrail 结果。如果有 error 级别的 finding，在继续之前先修复。
+${DAEMON_AGENTS_MARKER_END}\n`;
+
+function injectDaemonRule(repoRoot) {
+  const agentsFile = path.join(repoRoot, "AGENTS.md");
+  if (!fs.existsSync(agentsFile)) return;
+  let content = fs.readFileSync(agentsFile, "utf8");
+  if (content.includes(DAEMON_AGENTS_MARKER_START)) return; // 已存在
+  content = content.trimEnd() + DAEMON_AGENTS_BLOCK;
+  fs.writeFileSync(agentsFile, content, "utf8");
+}
+
+function removeDaemonRule(repoRoot) {
+  const agentsFile = path.join(repoRoot, "AGENTS.md");
+  if (!fs.existsSync(agentsFile)) return;
+  let content = fs.readFileSync(agentsFile, "utf8");
+  const startIdx = content.indexOf(DAEMON_AGENTS_MARKER_START);
+  const endIdx = content.indexOf(DAEMON_AGENTS_MARKER_END);
+  if (startIdx === -1 || endIdx === -1) return;
+  content = content.slice(0, startIdx).trimEnd() + "\n" + content.slice(endIdx + DAEMON_AGENTS_MARKER_END.length).trimStart() + "\n";
+  fs.writeFileSync(agentsFile, content, "utf8");
+}
+
 /**
  * 默认守护配置
  */
@@ -219,6 +251,7 @@ export async function startDaemon(repoRoot, options = {}) {
   const pid = await waitForPidFile(pidFile, 5000);
 
   if (pid) {
+    injectDaemonRule(repoRoot);
     console.log(`${t("daemon.started")}`);
     console.log(`  PID: ${pid}`);
     console.log(`\n${t("daemon.logFile")}: ${DAEMON_LOG_FILE}`);
@@ -276,6 +309,8 @@ export async function stopDaemon(repoRoot, options = {}) {
       fs.unlinkSync(pidFile);
     }
 
+    removeDaemonRule(repoRoot);
+
     console.log(`\n${t("daemon.stopped")}`);
     return { success: true };
   } catch (error) {

package/lib/daemon/worker.js

@@ -197,6 +197,18 @@ export async function createCheckRunner(repoRoot, config, log, t) {
       .then((result) => {
         const ok = result?.ok;
         log(ok ? "Check passed" : "Check completed with issues");
+
+        // 保存结构化结果供 MCP 读取
+        try {
+          const resultFile = path.join(repoRoot, ".agent-guardrails", "daemon-result.json");
+          const dir = path.dirname(resultFile);
+          if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+          fs.writeFileSync(resultFile, JSON.stringify({
+            timestamp: new Date().toISOString(),
+            ok: !!ok,
+            result
+          }, null, 2));
+        } catch { /* ignore */ }
       })
       .catch((err) => {
         log(`Check error: ${err.message}`);

package/lib/mcp/server.js

@@ -1,3 +1,5 @@
+import fs from "node:fs";
+import path from "node:path";
 import { executeCheck } from "../commands/check.js";
 import {
   finishAgentNativeLoop,
@@ -193,6 +195,20 @@ const TOOL_DEFINITIONS = [
       required: ["task"],
       additionalProperties: false
     }
+  },
+  {
+    name: "read_daemon_status",
+    description: "Read the latest daemon check result and status. Returns daemon running state, check count, and the structured result of the most recent guardrail check. Call this after code changes to check if the daemon detected any issues.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        repoRoot: {
+          type: "string",
+          description: "Absolute path to the repository root."
+        }
+      },
+      additionalProperties: false
+    }
   }
 ];
 
@@ -428,6 +444,35 @@ async function callTool(name, args, defaultRepoRoot) {
     });
   }
 
+  if (name === "read_daemon_status") {
+    const repoRoot = args.repoRoot || defaultRepoRoot;
+    const { isDaemonRunning, getDaemonConfig } = await import("../commands/daemon.js");
+    const status = isDaemonRunning(repoRoot);
+    const config = getDaemonConfig(repoRoot);
+
+    const resultPath = path.join(repoRoot, ".agent-guardrails", "daemon-result.json");
+    let lastResult = null;
+    try {
+      if (fs.existsSync(resultPath)) {
+        lastResult = JSON.parse(fs.readFileSync(resultPath, "utf8"));
+      }
+    } catch { /* ignore */ }
+
+    return createJsonResult({
+      running: status.running,
+      pid: status.pid || null,
+      startTime: status.startTime || null,
+      checksRun: status.checksRun || 0,
+      lastCheck: status.lastCheck || null,
+      config: {
+        watchPaths: config.watchPaths,
+        checkInterval: config.checkInterval,
+        blockOnHighRisk: config.blockOnHighRisk
+      },
+      lastResult
+    });
+  }
+
   throw createError(-32601, `Unknown tool "${name}".`);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-guardrails",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "mcpName": "io.github.logi-cmd/agent-guardrails",
   "description": "Production guardrails for AI coding agents",
   "type": "module",