@mandujs/mcp 0.30.0 → 0.31.0

package/src/tools/guard.ts

@@ -10,6 +10,8 @@ import {
   applyHealing,
   healAll,
   explainRule,
+  // Follow-up E — type-aware lint bridge
+  runTsgolint,
   type GuardConfig,
   type ViolationType,
   type GuardPreset,
@@ -20,7 +22,7 @@ export const guardToolDefinitions: Tool[] = [
   {
     name: "mandu.guard.check",
     description:
-      "Run guard checks to validate spec integrity, generated files, and slot files",
+      "Run guard checks to validate spec integrity, generated files, and slot files. Set typeAware=true to additionally run `oxlint --type-aware` (tsgolint) and merge its results.",
     annotations: {
       readOnlyHint: true,
     },
@@ -31,6 +33,11 @@ export const guardToolDefinitions: Tool[] = [
           type: "boolean",
           description: "If true, attempt to automatically fix violations",
         },
+        typeAware: {
+          type: "boolean",
+          description:
+            "If true, invoke `oxlint --type-aware` after the architecture check and include its violations in the response under `typeAware`. When the config has `guard.typeAware` set, this defaults to true; set false to opt out for a single call.",
+        },
       },
       required: [],
     },
@@ -119,7 +126,10 @@ export function guardTools(projectRoot: string) {
 
   const handlers: Record<string, (args: Record<string, unknown>) => Promise<unknown>> = {
     "mandu.guard.check": async (args: Record<string, unknown>) => {
-      const { autoCorrect = false } = args as { autoCorrect?: boolean };
+      const { autoCorrect = false, typeAware: typeAwareArg } = args as {
+        autoCorrect?: boolean;
+        typeAware?: boolean;
+      };
 
       // Load manifest
       const manifestResult = await loadManifest(paths.manifestPath);
@@ -133,12 +143,53 @@ export function guardTools(projectRoot: string) {
       // Run guard check
       const checkResult = await runGuardCheck(manifestResult.data, projectRoot);
 
+      // Follow-up E — resolve type-aware defaulting from config, then
+      // run the bridge when enabled. Result envelope is always included
+      // in the tool response so MCP clients have a single stable shape.
+      let projectConfig: Awaited<ReturnType<typeof readConfig>> | undefined;
+      try {
+        projectConfig = await readConfig(projectRoot);
+      } catch {
+        projectConfig = undefined;
+      }
+      const typeAwareCfg = (
+        projectConfig?.guard as
+          | { typeAware?: Record<string, unknown> }
+          | undefined
+      )?.typeAware;
+      const typeAwareEnabled =
+        typeAwareArg !== undefined ? typeAwareArg : typeAwareCfg !== undefined;
+
+      let typeAwareResponse: Record<string, unknown> | undefined;
+      if (typeAwareEnabled) {
+        const bridge = await runTsgolint({
+          projectRoot,
+          rules: typeAwareCfg?.rules as string[] | undefined,
+          severity: typeAwareCfg?.severity as
+            | "off"
+            | "warn"
+            | "error"
+            | undefined,
+          configPath: typeAwareCfg?.configPath as string | undefined,
+        });
+        typeAwareResponse = {
+          skipped: bridge.skipped,
+          summary: bridge.summary,
+          violations: bridge.violations,
+        };
+      }
+
       if (checkResult.passed) {
         return {
-          passed: true,
+          passed: typeAwareResponse
+            ? (typeAwareResponse.violations as Array<{ severity: string }>).filter(
+                (v) => v.severity === "error",
+              ).length === 0
+            : true,
           violations: [],
           message: "All guard checks passed",
           relatedSkills: ["mandu-guard-guide", "mandu-debug"],
+          ...(typeAwareResponse ? { typeAware: typeAwareResponse } : {}),
         };
       }
 
@@ -161,6 +212,7 @@ export function guardTools(projectRoot: string) {
             rolledBack: autoCorrectResult.rolledBack,
             changeId: autoCorrectResult.changeId,
           },
+          ...(typeAwareResponse ? { typeAware: typeAwareResponse } : {}),
         };
       }
 
@@ -175,6 +227,7 @@ export function guardTools(projectRoot: string) {
         message: `Found ${checkResult.violations.length} violation(s)`,
         tip: "Use autoCorrect: true to attempt automatic fixes",
         relatedSkills: ["mandu-guard-guide", "mandu-debug"],
+        ...(typeAwareResponse ? { typeAware: typeAwareResponse } : {}),
       };
     },
 

package/src/tools/index.ts

@@ -65,6 +65,8 @@ export { runTestsTools, runTestsToolDefinitions } from "./run-tests.js";
 export { deployPreviewTools, deployPreviewToolDefinitions } from "./deploy-preview.js";
 export { aiBriefTools, aiBriefToolDefinitions } from "./ai-brief.js";
 export { loopCloseTools, loopCloseToolDefinitions } from "./loop-close.js";
+// #243 — docs search/get for agents grounding answers in real framework docs
+export { docsTools, docsToolDefinitions } from "./docs.js";
 // Phase 18.ι — AI refactor MCP tools
 export {
   rewriteGeneratedBarrelTools,
@@ -135,6 +137,7 @@ import { runTestsTools, runTestsToolDefinitions } from "./run-tests.js";
 import { deployPreviewTools, deployPreviewToolDefinitions } from "./deploy-preview.js";
 import { aiBriefTools, aiBriefToolDefinitions } from "./ai-brief.js";
 import { loopCloseTools, loopCloseToolDefinitions } from "./loop-close.js";
+import { docsTools, docsToolDefinitions } from "./docs.js";
 // Phase 18.ι — AI refactor MCP tools
 import {
   rewriteGeneratedBarrelTools,
@@ -250,6 +253,7 @@ const TOOL_MODULES: ToolModule[] = [
   { category: "deploy-preview", definitions: deployPreviewToolDefinitions, handlers: deployPreviewTools },
   { category: "ai-brief", definitions: aiBriefToolDefinitions, handlers: aiBriefTools },
   { category: "loop-close", definitions: loopCloseToolDefinitions, handlers: loopCloseTools },
+  { category: "docs", definitions: docsToolDefinitions, handlers: docsTools },
   // Phase 18.ι — AI refactor tools (destructive writes; dry-run by default)
   {
     category: "refactor-barrel",