@devflow-tools/mcp-server 0.3.1 → 0.4.0

package/README.md

@@ -0,0 +1,59 @@
+# @devflow-tools/mcp-server
+
+MCP (Model Context Protocol) server for DevFlow — provides AI agents with code context, symbol search, dependency graphs, workflows, memory, and knowledge.
+
+## Installation
+
+```bash
+npm install -g @devflow-tools/mcp-server
+```
+
+Or use with `npx`:
+
+```bash
+npx @devflow-tools/mcp-server
+```
+
+## Configuration
+
+Add to your MCP client config (`.claude/mcp.json`, `claude_desktop_config.json`, etc.):
+
+```json
+{
+  "mcpServers": {
+    "devflow": {
+      "command": "npx",
+      "args": ["@devflow-tools/mcp-server"]
+    }
+  }
+}
+```
+
+Or let `devflow init` handle it automatically.
+
+## MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_project_context` | Get minimal context for a coding task |
+| `search_symbol` | Search code by symbol name |
+| `get_dependency_graph` | Get file/component dependencies |
+| `run_workflow` | Execute standardized dev workflows |
+| `get_memory` | Get project conventions and preferences |
+| `get_knowledge` | Search technical documentation |
+
+## Modes
+
+- **Local mode** — when DevFlow server is unreachable, falls back to direct CodeGraph queries
+- **Remote mode** — proxies to DevFlow REST API server
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `DEVFLOW_SERVER_URL` | `http://127.0.0.1:3100` | DevFlow server URL |
+| `DEVFLOW_PROJECT_ROOT` | `cwd` | Project root directory |
+
+## License
+
+MIT

package/dist/command-registry.json

@@ -0,0 +1,235 @@
+{
+  "version": 1,
+  "commands": {
+    "devflow:context": {
+      "mcpTools": [
+        "get_project_context",
+        "search_symbol"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:graph": {
+      "mcpTools": [
+        "get_dependency_graph"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore"
+      ]
+    },
+    "devflow:knowledge": {
+      "mcpTools": [
+        "get_knowledge"
+      ],
+      "blockedNative": [
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:memory": {
+      "mcpTools": [
+        "get_memory"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore"
+      ]
+    },
+    "devflow:workflow": {
+      "mcpTools": [
+        "run_workflow"
+      ],
+      "blockedNative": []
+    },
+    "devflow:react": {
+      "mcpTools": [
+        "react_diagnose_bug",
+        "react_new_feature",
+        "react_audit_performance",
+        "react_review_hooks",
+        "react_refactor_component",
+        "react_new_component"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:vue": {
+      "mcpTools": [
+        "vue_diagnose_bug",
+        "vue_new_component",
+        "vue_debug_reactivity"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:tailwind": {
+      "mcpTools": [
+        "tailwind_new_component"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:taro": {
+      "mcpTools": [
+        "taro_new_page"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:nest": {
+      "mcpTools": [
+        "nest_new_module",
+        "nest_diagnose_bug"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:graphql": {
+      "mcpTools": [
+        "graphql_new_graphql_type",
+        "graphql_diagnose_bug"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:docker": {
+      "mcpTools": [
+        "docker_dockerize_project"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:performance": {
+      "mcpTools": [
+        "performance_audit_performance"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:nextjs": {
+      "mcpTools": [
+        "nextjs_new_page",
+        "nextjs_diagnose_bug"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:electron": {
+      "mcpTools": [
+        "electron_diagnose_bug"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    }
+  }
+}

package/dist/enforcer/audit-chain.d.ts

@@ -0,0 +1,10 @@
+import type { Decision } from "./types.js";
+import type { IDataProvider } from "@devflow-tools/sdk";
+export declare function hashArgs(args: Record<string, unknown>): string;
+export declare function appendAuditEntry(provider: IDataProvider, toolName: string, argsHash: string, decision: Decision, ruleId: string | null, sessionId: string): Promise<void>;
+export declare function verifyAuditChain(provider: IDataProvider): Promise<{
+    valid: boolean;
+    brokenAt: number | null;
+}>;
+export declare function rebuildAuditChain(provider: IDataProvider): Promise<void>;
+//# sourceMappingURL=audit-chain.d.ts.map

package/dist/enforcer/audit-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-chain.d.ts","sourceRoot":"","sources":["../../src/enforcer/audit-chain.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAG9D;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAiBpH;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAc9E"}

package/dist/enforcer/audit-chain.js

@@ -0,0 +1,56 @@
+import { createHmac, createHash } from "node:crypto";
+export function hashArgs(args) {
+    const normalized = JSON.stringify(args, Object.keys(args).sort());
+    return createHash("sha256").update(normalized).digest("hex");
+}
+export async function appendAuditEntry(provider, toolName, argsHash, decision, ruleId, sessionId) {
+    const secret = await provider.auditGetSecret();
+    const allEntries = await provider.auditGetAll();
+    const prevHash = allEntries.length > 0
+        ? allEntries[allEntries.length - 1].signature
+        : createHash("sha256").update("genesis").digest("hex");
+    const ts = Date.now();
+    const seq = allEntries.length + 1;
+    const payload = `${seq}|${ts}|${toolName}|${argsHash}|${decision}|${ruleId ?? ""}|${sessionId}|${prevHash}`;
+    const signature = createHmac("sha256", secret).update(payload).digest("hex");
+    await provider.auditAppend({
+        seq,
+        ts,
+        tool: toolName,
+        argsHash,
+        decision,
+        ruleId,
+        sessionId,
+        prevHash,
+        signature,
+    });
+}
+export async function verifyAuditChain(provider) {
+    const secret = await provider.auditGetSecret();
+    const entries = await provider.auditGetAll();
+    let prevHash = createHash("sha256").update("genesis").digest("hex");
+    for (const entry of entries) {
+        if (entry.prevHash !== prevHash) {
+            return { valid: false, brokenAt: entry.seq };
+        }
+        const payload = `${entry.seq}|${entry.ts}|${entry.tool}|${entry.argsHash}|${entry.decision}|${entry.ruleId ?? ""}|${entry.sessionId}|${prevHash}`;
+        const expectedSig = createHmac("sha256", secret).update(payload).digest("hex");
+        if (entry.signature !== expectedSig) {
+            return { valid: false, brokenAt: entry.seq };
+        }
+        prevHash = entry.signature;
+    }
+    return { valid: true, brokenAt: null };
+}
+export async function rebuildAuditChain(provider) {
+    const secret = await provider.auditGetSecret();
+    const entries = await provider.auditGetAll();
+    let prevHash = createHash("sha256").update("genesis").digest("hex");
+    for (const entry of entries) {
+        const payload = `${entry.seq}|${entry.ts}|${entry.tool}|${entry.argsHash}|${entry.decision}|${entry.ruleId ?? ""}|${entry.sessionId}|${prevHash}`;
+        const signature = createHmac("sha256", secret).update(payload).digest("hex");
+        await provider.sqlExecute("UPDATE devflow_audit_chain SET prev_hash = ?, signature = ? WHERE seq = ?", [prevHash, signature, entry.seq]);
+        prevHash = signature;
+    }
+}
+//# sourceMappingURL=audit-chain.js.map

package/dist/enforcer/audit-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-chain.js","sourceRoot":"","sources":["../../src/enforcer/audit-chain.ts"],"names":[],"mappings":"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"}

package/dist/enforcer/constitutional.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from "./types.js";
+export declare const CONSTITUTIONAL_RULES: Rule[];
+//# sourceMappingURL=constitutional.d.ts.map

package/dist/enforcer/constitutional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constitutional.d.ts","sourceRoot":"","sources":["../../src/enforcer/constitutional.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,eAAO,MAAM,oBAAoB,EAAE,IAAI,EAyBtC,CAAC"}

package/dist/enforcer/constitutional.js

@@ -0,0 +1,27 @@
+export const CONSTITUTIONAL_RULES = [
+    {
+        id: "C001",
+        name: "必须携带 Session Token",
+        level: "constitutional",
+        condition: { requireFields: ["_devflow_token"] },
+        action: "deny",
+        message: "缺少 Session Token。请通过 /devflow: 命令启动会话，或运行 devflow session token 获取令牌。",
+    },
+    {
+        id: "C002",
+        name: "Token 已过期",
+        level: "constitutional",
+        condition: {},
+        action: "deny",
+        message: "Session Token 已过期（超过 1 小时）。请重新运行 devflow session token 获取新令牌。",
+    },
+    {
+        id: "C003",
+        name: "速率限制",
+        level: "constitutional",
+        condition: { maxCallsPerMinute: 60 },
+        action: "warn",
+        message: "调用频率过高，请稍后重试。",
+    },
+];
+//# sourceMappingURL=constitutional.js.map

package/dist/enforcer/constitutional.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constitutional.js","sourceRoot":"","sources":["../../src/enforcer/constitutional.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,oBAAoB,GAAW;IAC1C;QACE,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,gBAAgB;QACvB,SAAS,EAAE,EAAE,aAAa,EAAE,CAAC,gBAAgB,CAAC,EAAE;QAChD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,uEAAuE;KACjF;IACD;QACE,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,gBAAgB;QACvB,SAAS,EAAE,EAAE;QACb,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,+DAA+D;KACzE;IACD;QACE,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,gBAAgB;QACvB,SAAS,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE;QACpC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,eAAe;KACzB;CACF,CAAC"}

package/dist/enforcer/index.d.ts

@@ -0,0 +1,13 @@
+import type { MCPContext, EnforceResult } from "./types.js";
+import type { IDataProvider } from "@devflow-tools/sdk";
+import { issueReceipt } from "./receipt.js";
+export declare function parseJwtPayload(token: string): Record<string, unknown> | null;
+export type { MCPContext, EnforceResult };
+export { verifyAuditChain, rebuildAuditChain, hashArgs } from "./audit-chain.js";
+export { issueReceipt, verifyReceipt, isReceiptExpired } from "./receipt.js";
+export { CONSTITUTIONAL_RULES } from "./constitutional.js";
+export declare function enforce(toolName: string, args: Record<string, unknown>, provider: IDataProvider): Promise<{
+    result: EnforceResult;
+    receipt?: ReturnType<typeof issueReceipt>;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/enforcer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/enforcer/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAU7E;AAED,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC;AAE1C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,wBAAsB,OAAO,CAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAA;CAAE,CAAC,CAuD/E"}

package/dist/enforcer/index.js

@@ -0,0 +1,70 @@
+import { loadRules, evaluateAll } from "./rule-engine.js";
+import { hashArgs, appendAuditEntry } from "./audit-chain.js";
+import { issueReceipt } from "./receipt.js";
+export function parseJwtPayload(token) {
+    try {
+        const parts = token.split(".");
+        if (parts.length !== 3)
+            return null;
+        const payloadB64 = parts[1];
+        const json = Buffer.from(payloadB64, "base64url").toString("utf-8");
+        return JSON.parse(json);
+    }
+    catch {
+        return null;
+    }
+}
+export { verifyAuditChain, rebuildAuditChain, hashArgs } from "./audit-chain.js";
+export { issueReceipt, verifyReceipt, isReceiptExpired } from "./receipt.js";
+export { CONSTITUTIONAL_RULES } from "./constitutional.js";
+export async function enforce(toolName, args, provider) {
+    // Dual-path token injection: args first, env fallback
+    if (!args._devflow_token) {
+        const envToken = process.env.DEVFLOW_SESSION_TOKEN;
+        if (envToken) {
+            const parsed = parseJwtPayload(envToken);
+            if (parsed) {
+                args = { ...args, _devflow_token: parsed };
+            }
+        }
+    }
+    const sessionId = args._devflow_token?.sub ?? "anon";
+    const ctx = {
+        toolName,
+        args,
+        sessionId,
+        tokenPayload: args._devflow_token,
+    };
+    // C002: Check token expiry (hardcoded in enforce for performance — no rule lookup needed)
+    if (ctx.tokenPayload) {
+        const now = Math.floor(Date.now() / 1000);
+        if (ctx.tokenPayload.exp && now > ctx.tokenPayload.exp) {
+            const argsHash = hashArgs(args);
+            await appendAuditEntry(provider, toolName, argsHash, "deny", "C002", sessionId);
+            return {
+                result: {
+                    allowed: false,
+                    message: "Session Token 已过期（超过 1 小时）。请重新运行 devflow session token 获取新令牌。",
+                },
+            };
+        }
+    }
+    // Load and evaluate all rules
+    const rules = await loadRules(provider);
+    const { decision, rule } = evaluateAll(rules, ctx);
+    const argsHash = hashArgs(args);
+    await appendAuditEntry(provider, toolName, argsHash, decision, rule?.id ?? null, sessionId);
+    if (decision === "deny" && rule) {
+        return { result: { allowed: false, rule, message: rule.message } };
+    }
+    if (decision === "warn" && rule) {
+        const secret = await provider.auditGetSecret();
+        const receipt = issueReceipt(toolName, args, secret);
+        return { result: { allowed: true, warning: rule.message, rule }, receipt };
+    }
+    // ALLOW
+    const secret = await provider.auditGetSecret();
+    const receipt = issueReceipt(toolName, args, secret);
+    return { result: { allowed: true }, receipt };
+}
+//# sourceMappingURL=index.js.map

package/dist/enforcer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/enforcer/index.ts"],"names":[],"mappings":"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"}

package/dist/enforcer/receipt.d.ts

@@ -0,0 +1,5 @@
+import type { Receipt } from "./types.js";
+export declare function issueReceipt(toolName: string, query: unknown, secret: string): Receipt;
+export declare function verifyReceipt(receipt: Receipt, toolName: string, query: unknown, secret: string): boolean;
+export declare function isReceiptExpired(receipt: Receipt): boolean;
+//# sourceMappingURL=receipt.d.ts.map

package/dist/enforcer/receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.d.ts","sourceRoot":"","sources":["../../src/enforcer/receipt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAI1C,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAQtF;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAOzG;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE1D"}

package/dist/enforcer/receipt.js

@@ -0,0 +1,24 @@
+import { createHmac, createHash } from "node:crypto";
+const RECEIPT_TTL_MS = 30_000;
+export function issueReceipt(toolName, query, secret) {
+    const ts = Date.now();
+    const exp = ts + RECEIPT_TTL_MS;
+    const queryHash = createHash("sha256").update(JSON.stringify(query)).digest("hex");
+    const payload = `${toolName}|${ts}|${exp}|${queryHash}`;
+    const hmac = createHmac("sha256", secret).update(payload).digest("hex");
+    return { tool: toolName, ts, exp, queryHash, hmac };
+}
+export function verifyReceipt(receipt, toolName, query, secret) {
+    if (Date.now() > receipt.exp)
+        return false;
+    const queryHash = createHash("sha256").update(JSON.stringify(query)).digest("hex");
+    if (receipt.queryHash !== queryHash)
+        return false;
+    const payload = `${toolName}|${receipt.ts}|${receipt.exp}|${queryHash}`;
+    const expectedHmac = createHmac("sha256", secret).update(payload).digest("hex");
+    return receipt.hmac === expectedHmac;
+}
+export function isReceiptExpired(receipt) {
+    return Date.now() > receipt.exp;
+}
+//# sourceMappingURL=receipt.js.map

package/dist/enforcer/receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.js","sourceRoot":"","sources":["../../src/enforcer/receipt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGrD,MAAM,cAAc,GAAG,MAAM,CAAC;AAE9B,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,KAAc,EAAE,MAAc;IAC3E,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,MAAM,GAAG,GAAG,EAAE,GAAG,cAAc,CAAC;IAChC,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnF,MAAM,OAAO,GAAG,GAAG,QAAQ,IAAI,EAAE,IAAI,GAAG,IAAI,SAAS,EAAE,CAAC;IACxD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAExE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAgB,EAAE,QAAgB,EAAE,KAAc,EAAE,MAAc;IAC9F,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnF,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,OAAO,GAAG,GAAG,QAAQ,IAAI,OAAO,CAAC,EAAE,IAAI,OAAO,CAAC,GAAG,IAAI,SAAS,EAAE,CAAC;IACxE,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChF,OAAO,OAAO,CAAC,IAAI,KAAK,YAAY,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;AAClC,CAAC"}

package/dist/enforcer/rule-engine.d.ts

@@ -0,0 +1,9 @@
+import type { Rule, Decision, MCPContext } from "./types.js";
+import type { IDataProvider } from "@devflow-tools/sdk";
+export declare function loadRules(provider: IDataProvider): Promise<Rule[]>;
+export declare function evaluateRule(rule: Rule, ctx: MCPContext): Decision;
+export declare function evaluateAll(rules: Rule[], ctx: MCPContext): {
+    decision: Decision;
+    rule?: Rule;
+};
+//# sourceMappingURL=rule-engine.d.ts.map

package/dist/enforcer/rule-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-engine.d.ts","sourceRoot":"","sources":["../../src/enforcer/rule-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAiB,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKxD,wBAAsB,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAGxE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,GAAG,QAAQ,CAgDlE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,UAAU,GAAG;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,IAAI,CAAA;CAAE,CAc/F"}

package/dist/enforcer/rule-engine.js

@@ -0,0 +1,67 @@
+import { CONSTITUTIONAL_RULES } from "./constitutional.js";
+const rateCounters = new Map();
+export async function loadRules(provider) {
+    const projectRules = await provider.ruleGetAll();
+    return [...CONSTITUTIONAL_RULES, ...projectRules];
+}
+export function evaluateRule(rule, ctx) {
+    const cond = rule.condition;
+    // Tool filter
+    if (cond.tools && !cond.tools.includes("*") && !cond.tools.includes(ctx.toolName)) {
+        return "allow";
+    }
+    // Required fields check
+    if (cond.requireFields) {
+        for (const field of cond.requireFields) {
+            if (!(field in ctx.args))
+                return rule.action;
+        }
+    }
+    // Forbidden patterns check
+    if (cond.forbidPatterns) {
+        for (const pattern of cond.forbidPatterns) {
+            for (const val of Object.values(ctx.args)) {
+                if (typeof val === "string" && new RegExp(pattern).test(val)) {
+                    return rule.action;
+                }
+            }
+        }
+    }
+    // Param pattern check
+    if (cond.paramPatterns) {
+        for (const [key, pattern] of Object.entries(cond.paramPatterns)) {
+            const val = String(ctx.args[key] ?? "");
+            if (new RegExp(pattern).test(val))
+                return rule.action;
+        }
+    }
+    // Rate limit check
+    if (cond.maxCallsPerMinute) {
+        const key = `${ctx.toolName}:${ctx.sessionId ?? "anon"}`;
+        const now = Date.now();
+        let entry = rateCounters.get(key);
+        if (!entry || now > entry.resetAt) {
+            entry = { count: 0, resetAt: now + 60_000 };
+            rateCounters.set(key, entry);
+        }
+        entry.count++;
+        if (entry.count > cond.maxCallsPerMinute)
+            return rule.action;
+    }
+    return "allow";
+}
+export function evaluateAll(rules, ctx) {
+    // Constitutional rules first (sorted by level priority)
+    const sorted = [...rules].sort((a, b) => {
+        const order = { constitutional: 0, project: 1, session: 2 };
+        return order[a.level] - order[b.level];
+    });
+    for (const rule of sorted) {
+        const decision = evaluateRule(rule, ctx);
+        if (decision !== "allow") {
+            return { decision, rule };
+        }
+    }
+    return { decision: "allow" };
+}
+//# sourceMappingURL=rule-engine.js.map

package/dist/enforcer/rule-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-engine.js","sourceRoot":"","sources":["../../src/enforcer/rule-engine.ts"],"names":[],"mappings":"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"}

package/dist/enforcer/types.d.ts

@@ -0,0 +1,2 @@
+export type { Rule, RuleCondition, Decision, EnforceResult, MCPContext, AuditEntry, Receipt, } from "@devflow-tools/sdk";
+//# sourceMappingURL=types.d.ts.map

package/dist/enforcer/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/enforcer/types.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,IAAI,EACJ,aAAa,EACb,QAAQ,EACR,aAAa,EACb,UAAU,EACV,UAAU,EACV,OAAO,GACR,MAAM,oBAAoB,CAAC"}

package/dist/enforcer/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/enforcer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/enforcer/types.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { startServer } from "./server.js";
 async function main() {
-    const projectRoot = process.cwd();
+    const projectRoot = process.env.DEVFLOW_PROJECT_ROOT || process.cwd();
     await startServer({ mode: "stdio", projectRoot });
 }
 main().catch((err) => {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,KAAK,UAAU,IAAI;IACjB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAClC,MAAM,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;IACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,KAAK,UAAU,IAAI;IACjB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtE,MAAM,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;IACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -3,4 +3,6 @@ export interface MCPServerOptions {
     projectRoot: string;
 }
 export declare function startServer(options: MCPServerOptions): Promise<void>;
+export declare const KNOWN_PREFIXES: Set<string>;
+export declare function getCommandFromTool(toolName: string): string;
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkE1E"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4H1E;AAwBD,eAAO,MAAM,cAAc,aAGzB,CAAC;AAEH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiB3D"}

package/dist/server.js

@@ -3,7 +3,11 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { DevFlowApiClient, loadPlugins } from "@devflow-tools/sdk";
 import { getCoreTools, getPluginTools } from "./tools.js";
+import { createHmac, createHash } from "node:crypto";
+import { join } from "node:path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 export async function startServer(options) {
+    ensureSessionToken(options.projectRoot);
     const server = new Server({ name: "devflow-mcp", version: "0.1.0" }, { capabilities: { tools: {} } });
     const serverUrl = process.env.DEVFLOW_SERVER_URL ?? "http://127.0.0.1:3100";
     const apiKey = process.env.DEVFLOW_API_KEY ?? "dev-key-000000";
@@ -21,35 +25,87 @@ export async function startServer(options) {
     server.setRequestHandler(ListToolsRequestSchema, async () => ({
         tools: allTools,
     }));
+    // Cache the local engines reference for telemetry recording
+    let localEngines = null;
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const { name, arguments: args } = request.params;
         const argObj = (args ?? {});
+        const startTime = Date.now();
         try {
             let result;
             if (useRemote) {
                 result = await routeToServer(client, name, argObj);
+                // Sync receipt even in remote mode
+                syncReceiptToHook(options.projectRoot, name);
             }
             else {
-                // Dynamic import — only loads CodeGraph/better-sqlite3 when needed
-                const [{ createEngines }, { createToolHandlers, createPluginHandlers }] = await Promise.all([
-                    import("@devflow-tools/context-engine"),
-                    import("./tools.js"),
-                ]);
-                const engines = await createEngines(options.projectRoot);
-                console.error("[devflow-mcp] Warning: DevFlow server not reachable at http://localhost:3100");
-                console.error("[devflow-mcp] Running in local mode — telemetry will not be recorded.");
-                console.error("[devflow-mcp] Run `devflow server start` to enable full functionality.");
-                const handlers = createToolHandlers(engines);
-                const pHnd = createPluginHandlers(engines, plugins);
+                // Dynamic import — only loads CodeGraph when first needed
+                if (!localEngines) {
+                    const [{ createEngines }] = await Promise.all([
+                        import("@devflow-tools/context-engine"),
+                    ]);
+                    localEngines = await createEngines(options.projectRoot);
+                    // Register plugin workflow templates with the workflow engine
+                    for (const plugin of plugins) {
+                        for (const template of (plugin.workflow?.templates ?? [])) {
+                            localEngines.workflow.register(template);
+                        }
+                    }
+                    console.error(`[devflow-mcp] Warning: DevFlow server not reachable at ${serverUrl}`);
+                    console.error("[devflow-mcp] Running in local mode.");
+                }
+                // L1: Enforcer check before execution
+                const { enforce } = await import("./enforcer/index.js");
+                const enforcement = await enforce(name, argObj, localEngines.data);
+                if (!enforcement.result.allowed) {
+                    return {
+                        content: [{ type: "text", text: JSON.stringify({
+                                    _devflow: { v: 1, tool: name, ts: Date.now(), marker: "devflow-mcp-v1" },
+                                    error: enforcement.result.message,
+                                    rule: enforcement.result.rule?.id,
+                                }) }],
+                        isError: true,
+                    };
+                }
+                const { createToolHandlers, createPluginHandlers } = await import("./tools.js");
+                const handlers = createToolHandlers(localEngines);
+                const pHnd = createPluginHandlers(localEngines, plugins);
                 const allHandlers = { ...handlers, ...pHnd };
                 const handler = allHandlers[name];
                 if (!handler)
                     throw new Error(`Unknown tool: ${name}`);
                 result = await handler(argObj);
+                // Sync receipt to hook receipt file (bridges MCP → PreToolUse hook)
+                syncReceiptToHook(options.projectRoot, name);
+                // Layer 4: Record tool call in local telemetry
+                const durationMs = Date.now() - startTime;
+                try {
+                    await localEngines.data.recordToolCall(name, argObj, durationMs);
+                }
+                catch { }
+                // Attach receipt and warning to result
+                if (enforcement.receipt) {
+                    result = { ...result, _receipt: enforcement.receipt };
+                }
+                if (enforcement.result.warning) {
+                    result = { ...result, _warning: enforcement.result.warning };
+                }
             }
-            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            // Layer 3: Append _devflow response marker to prove MCP tool was used
+            const marked = wrapWithDevflowMarker(name, result);
+            return { content: [{ type: "text", text: JSON.stringify(marked, null, 2) }] };
         }
         catch (err) {
+            // Layer 4: Record failed tool call
+            const durationMs = Date.now() - startTime;
+            if (!useRemote && localEngines) {
+                try {
+                    await localEngines.data.recordToolCall(name, argObj, durationMs, err.message);
+                }
+                catch {
+                    // Telemetry recording failure must not break error reporting
+                }
+            }
             return {
                 content: [{ type: "text", text: `Error: ${err.message}` }],
                 isError: true,
@@ -59,6 +115,90 @@ export async function startServer(options) {
     const transport = new StdioServerTransport();
     await server.connect(transport);
 }
+function ensureSessionToken(projectRoot) {
+    if (process.env.DEVFLOW_SESSION_TOKEN)
+        return;
+    const header = Buffer.from(JSON.stringify({ alg: "HS256", typ: "JWT" })).toString("base64url");
+    const now = Math.floor(Date.now() / 1000);
+    const payload = {
+        sub: `devflow-mcp-${Date.now().toString(36)}`,
+        project: projectRoot.split("/").pop() ?? "unknown",
+        iat: now,
+        exp: now + 86400,
+        scope: ["context", "knowledge", "memory", "workflow", "graph"],
+    };
+    const payloadB64 = Buffer.from(JSON.stringify(payload)).toString("base64url");
+    const secret = "devflow-local-mcp-secret-v1";
+    const signature = createHmac("sha256", secret)
+        .update(`${header}.${payloadB64}`)
+        .digest("base64url");
+    process.env.DEVFLOW_SESSION_TOKEN = `${header}.${payloadB64}.${signature}`;
+    console.error("[devflow-mcp] Auto-generated session token (no env token provided).");
+}
+export const KNOWN_PREFIXES = new Set([
+    "react", "vue", "nest", "nextjs", "graphql",
+    "docker", "tailwind", "taro", "electron", "performance",
+]);
+export function getCommandFromTool(toolName) {
+    const core = {
+        get_project_context: "context",
+        search_symbol: "context",
+        get_dependency_graph: "graph",
+        get_knowledge: "knowledge",
+        get_memory: "memory",
+        run_workflow: "workflow",
+    };
+    if (core[toolName])
+        return `devflow:${core[toolName]}`;
+    const prefix = toolName.split("_")[0];
+    if (KNOWN_PREFIXES.has(prefix)) {
+        return `devflow:${prefix}`;
+    }
+    return "";
+}
+function syncReceiptToHook(projectRoot, toolName) {
+    try {
+        const tmpDir = process.env.TMPDIR || "/tmp";
+        const receiptDir = join(tmpDir, ".devflow-receipts");
+        const sessionId = createHash("sha256").update(projectRoot).digest("hex").slice(0, 16);
+        const receiptFile = join(receiptDir, `${sessionId}.json`);
+        if (!existsSync(receiptDir)) {
+            mkdirSync(receiptDir, { recursive: true });
+        }
+        let data = {};
+        if (existsSync(receiptFile)) {
+            try {
+                data = JSON.parse(readFileSync(receiptFile, "utf-8"));
+            }
+            catch {
+                // Corrupt file, start fresh
+            }
+        }
+        data.lastMcpCall = Date.now();
+        data.bypassCount = 0;
+        const cmd = getCommandFromTool(toolName);
+        if (cmd)
+            data.activeCommand = cmd;
+        writeFileSync(receiptFile, JSON.stringify(data));
+    }
+    catch {
+        // Receipt sync failure must not break tool execution
+    }
+}
+function wrapWithDevflowMarker(toolName, result) {
+    const marker = {
+        _devflow: {
+            v: 1,
+            tool: toolName,
+            ts: Date.now(),
+            marker: "devflow-mcp-v1",
+        },
+    };
+    if (result && typeof result === "object" && !Array.isArray(result)) {
+        return { ...result, ...marker };
+    }
+    return { result, ...marker };
+}
 async function routeToServer(client, toolName, args) {
     switch (toolName) {
         case "get_project_context":

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAO7E,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAyB;IACzD,kBAAkB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAExC,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,EACzC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,uBAAuB,CAAC;IAC5E,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,gBAAgB,CAAC;IAE/D,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC;QAClC,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,MAAM;KACP,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IAEtC,MAAM,SAAS,GAAG,MAAM,WAAW,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAE/C,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,CAAC,GAAG,SAAS,EAAE,GAAG,WAAW,CAAC,CAAC;IAEhD,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,QAAQ;KAChB,CAAC,CAAC,CAAC;IAEJ,4DAA4D;IAC5D,IAAI,YAAY,GAA6F,IAAI,CAAC;IAElH,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,MAAM,MAAM,GAAG,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;QACvD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,IAAI,CAAC;YACH,IAAI,MAAe,CAAC;YAEpB,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;gBACnD,mCAAmC;gBACnC,iBAAiB,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,0DAA0D;gBAC1D,IAAI,CAAC,YAAY,EAAE,CAAC;oBAClB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;wBAC5C,MAAM,CAAC,+BAA+B,CAAC;qBACxC,CAAC,CAAC;oBACH,YAAY,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;oBAExD,8DAA8D;oBAC9D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;wBAC7B,KAAK,MAAM,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;4BAC1D,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;wBAC3C,CAAC;oBACH,CAAC;oBAED,OAAO,CAAC,KAAK,CAAC,0DAA0D,SAAS,EAAE,CAAC,CAAC;oBACrF,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;gBACxD,CAAC;gBAED,sCAAsC;gBACtC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;gBACxD,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;gBACnE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBAChC,OAAO;wBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oCACtD,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE;oCACxE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,OAAO;oCACjC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE;iCAClC,CAAC,EAAE,CAAC;wBACL,OAAO,EAAE,IAAI;qBACd,CAAC;gBACJ,CAAC;gBAED,MAAM,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;gBAChF,MAAM,QAAQ,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;gBAClD,MAAM,IAAI,GAAG,oBAAoB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;gBACzD,MAAM,WAAW,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,EAAE,CAAC;gBAC7C,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;gBAClC,IAAI,CAAC,OAAO;oBAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;gBACvD,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;gBAE/B,oEAAoE;gBACpE,iBAAiB,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;gBAE7C,+CAA+C;gBAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;gBAC1C,IAAI,CAAC;oBAAC,MAAM,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAA,CAAC;gBAElF,uCAAuC;gBACvC,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;oBACxB,MAAM,GAAG,EAAE,GAAI,MAAiB,EAAE,QAAQ,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC;gBACpE,CAAC;gBACD,IAAI,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBAC/B,MAAM,GAAG,EAAE,GAAI,MAAiB,EAAE,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC3E,CAAC;YACH,CAAC;YAED,sEAAsE;YACtE,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACnD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACzF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,mCAAmC;YACnC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAC1C,IAAI,CAAC,SAAS,IAAI,YAAY,EAAE,CAAC;gBAC/B,IAAI,CAAC;oBACH,MAAM,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;gBAC3F,CAAC;gBAAC,MAAM,CAAC;oBACP,6DAA6D;gBAC/D,CAAC;YACH,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAW,GAAa,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC9E,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,kBAAkB,CAAC,WAAmB;IAC7C,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB;QAAE,OAAO;IAE9C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC/F,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG;QACd,GAAG,EAAE,eAAe,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;QAC7C,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,SAAS;QAClD,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG,GAAG,KAAK;QAChB,KAAK,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC;KAC/D,CAAC;IACF,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,6BAA6B,CAAC;IAC7C,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC;SAC3C,MAAM,CAAC,GAAG,MAAM,IAAI,UAAU,EAAE,CAAC;SACjC,MAAM,CAAC,WAAW,CAAC,CAAC;IAEvB,OAAO,CAAC,GAAG,CAAC,qBAAqB,GAAG,GAAG,MAAM,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;IAC3E,OAAO,CAAC,KAAK,CAAC,qEAAqE,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IACpC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS;IAC3C,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa;CACxD,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,MAAM,IAAI,GAA2B;QACnC,mBAAmB,EAAE,SAAS;QAC9B,aAAa,EAAE,SAAS;QACxB,oBAAoB,EAAE,OAAO;QAC7B,aAAa,EAAE,WAAW;QAC1B,UAAU,EAAE,QAAQ;QACpB,YAAY,EAAE,UAAU;KACzB,CAAC;IACF,IAAI,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,WAAW,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;IAEvD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,IAAI,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,OAAO,WAAW,MAAM,EAAE,CAAC;IAC7B,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,iBAAiB,CAAC,WAAmB,EAAE,QAAgB;IAC9D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC;QAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtF,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,SAAS,OAAO,CAAC,CAAC;QAE1D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,IAAI,GAA4B,EAAE,CAAC;QACvC,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;YACxD,CAAC;YAAC,MAAM,CAAC;gBACP,4BAA4B;YAC9B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;QACrB,MAAM,GAAG,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,GAAG;YAAE,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC;QAClC,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,qDAAqD;IACvD,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,QAAgB,EAAE,MAAe;IAC9D,MAAM,MAAM,GAAG;QACb,QAAQ,EAAE;YACR,CAAC,EAAE,CAAC;YACJ,IAAI,EAAE,QAAQ;YACd,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,MAAM,EAAE,gBAAgB;SACzB;KACF,CAAC;IAEF,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,OAAO,EAAE,GAAI,MAAkC,EAAE,GAAG,MAAM,EAAE,CAAC;IAC/D,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;AAC/B,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,MAAwB,EAAE,QAAgB,EAAE,IAA6B;IACpG,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,qBAAqB;YACxB,OAAO,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,KAAe,EAAG,IAAI,CAAC,IAAwB,IAAI,MAAM,CAAC,CAAC;QAC7F,KAAK,eAAe;YAClB,OAAO,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,MAAgB,CAAC,CAAC;QACpD,KAAK,sBAAsB;YACzB,OAAO,MAAM,CAAC,QAAQ,CAAE,IAAI,CAAC,MAAiB,IAAI,KAAK,EAAG,IAAI,CAAC,KAAgB,IAAI,CAAC,CAAC,CAAC;QACxF,KAAK,cAAc;YACjB,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,IAAc,EAAE,IAAI,CAAC,KAAgC,CAAC,CAAC;QACxF,KAAK,YAAY;YACf,OAAO,MAAM,CAAC,SAAS,EAAE,CAAC;QAC5B,KAAK,eAAe;YAClB,OAAO,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,KAAe,EAAG,IAAI,CAAC,KAAgB,IAAI,KAAK,CAAC,CAAC;QACvF,KAAK,sBAAsB;YACzB,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAClC;YACE,OAAO,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC"}

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,oBAAoB,CAAC;AAEnE,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,wBAAgB,YAAY,IAAI,OAAO,EAAE,CAyGxC;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;AAE/F,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,GAAG,YAAY,CA6EnE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,OAAO,EAAE,CAqBlE;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,EAClB,OAAO,EAAE,aAAa,EAAE,GACvB,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAcrE"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,oBAAoB,CAAC;AAEnE,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,wBAAgB,YAAY,IAAI,OAAO,EAAE,CA0GxC;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;AAE/F,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,GAAG,YAAY,CA2HnE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,OAAO,EAAE,CAqBlE;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,EAClB,OAAO,EAAE,aAAa,EAAE,GACvB,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAuBrE"}

package/dist/tools.js

@@ -8,6 +8,7 @@ export function getCoreTools() {
                 properties: {
                     query: { type: "string", description: "自然语言查询" },
                     mode: { type: "string", enum: ["fast", "deep"], default: "fast" },
+                    expandedTerms: { type: "string", description: "Agent 预翻译的英文关键词（空格分隔），用于提升中文查询的搜索效果" },
                 },
                 required: ["query"],
             },
@@ -106,33 +107,79 @@ export function getCoreTools() {
 }
 export function createToolHandlers(engines) {
     return {
-        get_project_context: async ({ query, mode }) => {
-            return engines.context.build({
+        get_project_context: async ({ query, mode, expandedTerms }) => {
+            const result = await engines.context.build({
                 query: query,
                 mode: mode ?? "fast",
+                expandedTerms: expandedTerms,
             });
+            return {
+                ...result,
+                _devflow_unique: {
+                    search_method: "bm25_semantic",
+                    confidence_scored: true,
+                    memory_injected: true,
+                    token_estimated: true,
+                },
+            };
         },
         search_symbol: async ({ symbol }) => {
-            return engines.indexer.findSymbol(symbol);
+            const result = await engines.indexer.findSymbol(symbol);
+            return {
+                ...result,
+                _devflow_unique: {
+                    index_backed: true,
+                    kind_annotated: true,
+                },
+            };
         },
         get_dependency_graph: async ({ target, depth }) => {
             const t = target ?? "all";
             const d = depth ?? 2;
-            if (t === "all") {
-                return engines.graph.export();
-            }
-            return engines.graph.getSubGraph(t, d);
+            const result = t === "all" ? engines.graph.export() : engines.graph.getSubGraph(t, d);
+            return {
+                ...result,
+                _devflow_unique: {
+                    layer_annotated: true,
+                    architecture_grouped: true,
+                    query_depth: d,
+                },
+            };
         },
         run_workflow: async ({ type, input }) => {
-            return engines.workflow.run(type, { input });
+            const result = await engines.workflow.run(type, { input });
+            return {
+                ...result,
+                _devflow_unique: {
+                    dag_orchestrated: true,
+                    step_tracked: true,
+                    workflow_type: type,
+                },
+            };
         },
         get_memory: async () => {
-            return engines.memory.getAll();
+            const result = await engines.memory.getAll();
+            return {
+                ...result,
+                _devflow_unique: {
+                    memory_version: 1,
+                    structured_storage: true,
+                    project_context_included: true,
+                },
+            };
         },
         get_knowledge: async ({ query, scope }) => {
-            return engines.knowledge.search(query, {
+            const result = await engines.knowledge.search(query, {
                 sources: scope === "all" ? undefined : [scope],
             });
+            return {
+                ...result,
+                _devflow_unique: {
+                    source_versioned: true,
+                    code_examples_included: true,
+                    search_scope: scope,
+                },
+            };
         },
         devflow_report_event: async (args) => {
             const truncate = (s, max) => {
@@ -213,7 +260,16 @@ export function createPluginHandlers(engines, plugins) {
                 continue;
             const toolName = `${prefix}_${mcpTrigger.tool}`;
             handlers[toolName] = async (args) => {
-                return engines.workflow.run(template.name, args);
+                const result = await engines.workflow.run(template.name, args);
+                return {
+                    ...result,
+                    _devflow_unique: {
+                        dag_orchestrated: true,
+                        step_tracked: true,
+                        plugin_name: prefix,
+                        template_name: template.name,
+                    },
+                };
             };
         }
     }

package/dist/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devflow-tools/mcp-server",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {
@@ -8,17 +8,18 @@
   },
   "scripts": {
     "build": "tsc -b",
+    "postbuild": "NODE_OPTIONS='--experimental-sqlite' npx tsx scripts/generate-registry.ts",
     "test": "cgnode ../../node_modules/.bin/vitest run",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@devflow-tools/context-engine": "^0.3.0",
-    "@devflow-tools/knowledge-engine": "^0.3.0",
-    "@devflow-tools/memory-engine": "^0.3.0",
-    "@devflow-tools/sdk": "^0.3.0",
-    "@devflow-tools/telemetry": "^0.3.0",
-    "@devflow-tools/workflow-engine": "^0.3.0",
+    "@devflow-tools/context-engine": "^0.4.0",
+    "@devflow-tools/knowledge-engine": "^0.4.0",
+    "@devflow-tools/memory-engine": "^0.4.0",
+    "@devflow-tools/sdk": "^0.4.0",
+    "@devflow-tools/telemetry": "^0.4.0",
+    "@devflow-tools/workflow-engine": "^0.4.0",
     "@modelcontextprotocol/sdk": "^1.0.0"
   },
   "devDependencies": {
@@ -29,5 +30,5 @@
     "dist",
     "bin"
   ],
-  "gitHead": "2d52bb1401b6501a527cac7de0f664c18bf60dcf"
+  "gitHead": "c76bcf3a2bb8ac12b871738d6661979eb45090c6"
 }