agent-guardrails 0.3.4 → 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/package.json

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