@yinuo-ngm/mcp-server 0.1.1 → 0.1.3

package/lib/standard/validators/component.validator.js

@@ -0,0 +1,94 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateComponentNaming = validateComponentNaming;
+exports.validateComponentBoundary = validateComponentBoundary;
+const path = __importStar(require("path"));
+const frontend_standard_schema_1 = require("../frontend-standard.schema");
+const angular_structure_validator_1 = require("./angular-structure.validator");
+function isComponentTs(file) {
+    return file.path.endsWith(".component.ts") || file.path.endsWith(".page.ts");
+}
+function hasAllowedSuffix(filePath, standard) {
+    const base = path.basename(filePath).replace(/\.ts$/, "");
+    return standard.naming.componentSuffixes.some((suffix) => base.endsWith(`.${suffix}`) || base.endsWith(`-${suffix}`));
+}
+function validateComponentNaming(files, standard) {
+    const findings = files
+        .filter(isComponentTs)
+        .filter((file) => !hasAllowedSuffix(file.path, standard))
+        .map((file) => ({
+        ruleId: "angular.component-naming",
+        severity: "warning",
+        message: "Component file name does not use an expected page/component/dialog/drawer/table/form suffix.",
+        file: file.path,
+        suggestion: "Rename the component file or adjust naming.componentSuffixes in frontend-standard.json.",
+    }));
+    return (0, frontend_standard_schema_1.summarizeFindings)(findings);
+}
+function validateComponentBoundary(files, standard) {
+    const findings = [...(0, angular_structure_validator_1.validatePagePlacement)(files, standard)];
+    for (const file of files.filter((item) => item.path.endsWith(".ts"))) {
+        const text = file.text ?? "";
+        if (isComponentTs(file) && file.lineCount && file.lineCount > standard.structure.maxComponentFileLines) {
+            findings.push({
+                ruleId: "angular.component-size",
+                severity: "warning",
+                message: `Component file has ${file.lineCount} lines, above configured limit ${standard.structure.maxComponentFileLines}.`,
+                file: file.path,
+                suggestion: "Split large component logic into services, child components, or focused helpers.",
+            });
+        }
+        if (/\bany\b/.test(text)) {
+            findings.push({
+                ruleId: "typescript.no-obvious-any",
+                severity: "warning",
+                message: "File contains obvious any usage.",
+                file: file.path,
+                suggestion: "Replace any with explicit DTO, model, generic, or unknown at external boundaries.",
+            });
+        }
+        if (/https?:\/\/(?!127\.0\.0\.1|localhost|::1)[^\s'"`]+/.test(text)) {
+            findings.push({
+                ruleId: "angular.no-hardcoded-api-url",
+                severity: "warning",
+                message: "File appears to contain a hardcoded remote API URL.",
+                file: file.path,
+                suggestion: "Move API origins into environment/runtime configuration or an API client service.",
+            });
+        }
+    }
+    return (0, frontend_standard_schema_1.summarizeFindings)(findings);
+}

package/lib/standard/validators/git.validator.d.ts

@@ -0,0 +1,8 @@
+import type { FrontendStandard } from "../frontend-standard.schema";
+export declare function validateBranchName(branchName: string, standard: FrontendStandard): import("../frontend-standard.schema").StandardCheckResult;
+export declare function validateCommitMessage(message: string, standard: FrontendStandard): import("../frontend-standard.schema").StandardCheckResult;
+export declare function generateCommitMessage(input: {
+    type?: string;
+    scope?: string;
+    summary: string;
+}, standard: FrontendStandard): string;

package/lib/standard/validators/git.validator.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateBranchName = validateBranchName;
+exports.validateCommitMessage = validateCommitMessage;
+exports.generateCommitMessage = generateCommitMessage;
+const frontend_standard_schema_1 = require("../frontend-standard.schema");
+function validateBranchName(branchName, standard) {
+    const matched = standard.git.branchPatterns.some((pattern) => new RegExp(pattern).test(branchName));
+    const findings = matched ? [] : [{
+            ruleId: "git.branch-name",
+            severity: "error",
+            message: `Branch name does not match allowed frontend workflow patterns: ${branchName}`,
+            suggestion: "Use feature/{issueId}-{short-name}, fix/{issueId}-{short-name}, refactor/{module}-{short-name}, or hotfix/{date}-{short-name}.",
+        }];
+    return (0, frontend_standard_schema_1.summarizeFindings)(findings);
+}
+function validateCommitMessage(message, standard) {
+    const matched = new RegExp(standard.git.commitPattern).test(message);
+    const findings = matched ? [] : [{
+            ruleId: "git.commit-message",
+            severity: "error",
+            message: `Commit message does not match conventional frontend format: ${message}`,
+            suggestion: "Use feat(scope): message, fix(scope): message, refactor(scope): message, docs(scope): message, test(scope): message, or chore(scope): message.",
+        }];
+    return (0, frontend_standard_schema_1.summarizeFindings)(findings);
+}
+function generateCommitMessage(input, standard) {
+    const type = input.type && standard.naming.commitTypes.includes(input.type) ? input.type : "chore";
+    const scope = (input.scope ?? "frontend").trim().toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-|-$/g, "") || "frontend";
+    const summary = input.summary.trim().replace(/\s+/g, " ");
+    return `${type}(${scope}): ${summary}`;
+}

package/lib/standard/validators/review.validator.d.ts

@@ -0,0 +1,15 @@
+import type { FrontendStandard, StandardFinding } from "../frontend-standard.schema";
+import type { SourceFile } from "../project-scan";
+export declare function detectReviewRisks(files: SourceFile[], changedFiles: string[], standard: FrontendStandard): import("../frontend-standard.schema").StandardCheckResult;
+export declare function reviewChecklist(changedFiles: string[]): string[];
+export declare function generateReviewMarkdown(input: {
+    taskId: string;
+    changedFiles: string[];
+    checks: Array<{
+        title: string;
+        status: string;
+        findings: StandardFinding[];
+    }>;
+    risks: StandardFinding[];
+    checklist: string[];
+}): string;

package/lib/standard/validators/review.validator.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectReviewRisks = detectReviewRisks;
+exports.reviewChecklist = reviewChecklist;
+exports.generateReviewMarkdown = generateReviewMarkdown;
+const frontend_standard_schema_1 = require("../frontend-standard.schema");
+function detectReviewRisks(files, changedFiles, standard) {
+    const changedSet = new Set(changedFiles.map((item) => item.replace(/\\/g, "/")));
+    const findings = [];
+    for (const file of files.filter((item) => changedSet.has(item.path))) {
+        const text = file.text ?? "";
+        for (const keyword of standard.review.riskKeywords) {
+            if (text.toLowerCase().includes(keyword.toLowerCase()) || file.path.toLowerCase().includes(keyword.toLowerCase())) {
+                findings.push({
+                    ruleId: "review.risk-keyword",
+                    severity: "warning",
+                    message: `Changed file matches review risk keyword: ${keyword}`,
+                    file: file.path,
+                    suggestion: "Add explicit human review notes for permission, security, data loss, lifecycle, or migration impact.",
+                });
+                break;
+            }
+        }
+        if (file.path.endsWith("package.json")) {
+            findings.push({
+                ruleId: "review.package-json-change",
+                severity: "warning",
+                message: "package.json changed.",
+                file: file.path,
+                suggestion: "Confirm scripts, dependencies, package exports, and release impact.",
+            });
+        }
+    }
+    return (0, frontend_standard_schema_1.summarizeFindings)(findings);
+}
+function reviewChecklist(changedFiles) {
+    return [
+        "确认变更范围只覆盖本次任务需要的文件。",
+        "确认无 token/password/secret/cookie/authorization 泄漏。",
+        "确认 UI、API、任务运行时或配置写入契约没有意外破坏。",
+        "确认新增或变更逻辑已有对应测试计划。",
+        changedFiles.length > 0 ? `确认 ${changedFiles.length} 个变更文件都已人工扫过。` : "确认当前没有检测到 Git 变更文件。",
+    ];
+}
+function generateReviewMarkdown(input) {
+    const lines = [
+        `# Review Report ${input.taskId}`,
+        "",
+        "## Changed Files",
+        ...(input.changedFiles.length ? input.changedFiles.map((file) => `- ${file}`) : ["- No changed files detected."]),
+        "",
+        "## Automated Checks",
+    ];
+    for (const check of input.checks) {
+        lines.push(`- ${check.title}: ${check.status}`);
+        for (const finding of check.findings.slice(0, 20)) {
+            lines.push(`  - [${finding.severity}] ${finding.file ? `${finding.file}: ` : ""}${finding.message}`);
+        }
+    }
+    lines.push("", "## Risks");
+    lines.push(...(input.risks.length ? input.risks.map((risk) => `- [${risk.severity}] ${risk.file ? `${risk.file}: ` : ""}${risk.message}`) : ["- No automated risks detected."]));
+    lines.push("", "## Suggestions");
+    lines.push(...input.checklist.map((item) => `- ${item}`));
+    lines.push("", "## Manual Confirmation");
+    lines.push("- [ ] Scope is correct.", "- [ ] Tests or verification are sufficient.", "- [ ] No sensitive data is included.");
+    return lines.join("\n");
+}

package/lib/standard/validators/test.validator.d.ts

@@ -0,0 +1,19 @@
+import type { FrontendStandard, StandardFinding } from "../frontend-standard.schema";
+import type { SourceFile } from "../project-scan";
+export declare function detectMissingSpecs(files: SourceFile[], standard: FrontendStandard): import("../frontend-standard.schema").StandardCheckResult;
+export declare function validateSpecNaming(files: SourceFile[]): import("../frontend-standard.schema").StandardCheckResult;
+export declare function generateSpecPlan(files: SourceFile[], standard: FrontendStandard): {
+    plan: {
+        sourceFile: string | undefined;
+        suggestedSpecFile: string | undefined;
+        focus: string;
+    }[];
+    status: import("../frontend-standard.schema").CheckStatus;
+    findings: StandardFinding[];
+    summary: {
+        passed: number;
+        warnings: number;
+        errors: number;
+        nextSteps: string[];
+    };
+};

package/lib/standard/validators/test.validator.js

@@ -0,0 +1,89 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectMissingSpecs = detectMissingSpecs;
+exports.validateSpecNaming = validateSpecNaming;
+exports.generateSpecPlan = generateSpecPlan;
+const path = __importStar(require("path"));
+const frontend_standard_schema_1 = require("../frontend-standard.schema");
+function specPathFor(filePath) {
+    return filePath.replace(/\.ts$/, ".spec.ts");
+}
+function hasFile(files, filePath) {
+    return files.some((file) => file.path === filePath);
+}
+function detectMissingSpecs(files, standard) {
+    const findings = [];
+    const tsFiles = files.filter((file) => file.path.endsWith(".ts") && !file.path.endsWith(".spec.ts"));
+    for (const file of tsFiles) {
+        const base = path.basename(file.path);
+        const needsServiceSpec = standard.testing.requireServiceSpec && base.endsWith(".service.ts");
+        const needsUtilSpec = standard.testing.requireUtilSpec && (base.endsWith(".util.ts") || base.endsWith(".utils.ts"));
+        const suggestsComponentSpec = standard.testing.suggestComponentSpec && base.endsWith(".component.ts") && (file.lineCount ?? 0) >= 120;
+        if ((needsServiceSpec || needsUtilSpec || suggestsComponentSpec) && !hasFile(files, specPathFor(file.path))) {
+            findings.push({
+                ruleId: needsServiceSpec ? "test.missing-service-spec" : needsUtilSpec ? "test.missing-util-spec" : "test.missing-component-spec",
+                severity: "warning",
+                message: `Missing suggested spec file for ${file.path}.`,
+                file: file.path,
+                suggestion: `Add ${specPathFor(file.path)} or document why this file is covered elsewhere.`,
+            });
+        }
+    }
+    return (0, frontend_standard_schema_1.summarizeFindings)(findings);
+}
+function validateSpecNaming(files) {
+    const findings = files
+        .filter((file) => file.path.endsWith(".test.ts") || file.path.endsWith(".tests.ts"))
+        .map((file) => ({
+        ruleId: "test.naming",
+        severity: "warning",
+        message: "Angular frontend tests should use .spec.ts naming.",
+        file: file.path,
+        suggestion: "Rename frontend test files to .spec.ts where Angular tooling expects it.",
+    }));
+    return (0, frontend_standard_schema_1.summarizeFindings)(findings);
+}
+function generateSpecPlan(files, standard) {
+    const missing = detectMissingSpecs(files, standard);
+    return {
+        ...missing,
+        plan: missing.findings.map((finding) => ({
+            sourceFile: finding.file,
+            suggestedSpecFile: finding.suggestion?.match(/Add ([^ ]+)/)?.[1],
+            focus: finding.ruleId.includes("service") ? "service behavior and API contracts" : finding.ruleId.includes("util") ? "pure utility inputs and edge cases" : "component inputs, outputs, and key rendering states",
+        })),
+    };
+}

package/lib/tool-catalog.d.ts

@@ -0,0 +1,2 @@
+export { toolCatalog, capabilityCatalog, } from "./catalog";
+export type { ToolCatalogEntry, CapabilityCatalogEntry, } from "./catalog/types";

package/lib/tool-catalog.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.capabilityCatalog = exports.toolCatalog = void 0;
+var catalog_1 = require("./catalog");
+Object.defineProperty(exports, "toolCatalog", { enumerable: true, get: function () { return catalog_1.toolCatalog; } });
+Object.defineProperty(exports, "capabilityCatalog", { enumerable: true, get: function () { return catalog_1.capabilityCatalog; } });

package/lib/tools/angular/angular-standard.tools.d.ts

@@ -0,0 +1,2 @@
+import type { McpToolDefinition } from "../index";
+export declare function angularStandardTools(): McpToolDefinition[];

package/lib/tools/angular/angular-standard.tools.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.angularStandardTools = angularStandardTools;
+const zod_1 = require("zod");
+const result_1 = require("../../utils/result");
+const project_files_1 = require("../../filesystem/project-files");
+const frontend_standard_service_1 = require("../../standard/frontend-standard.service");
+const angular_structure_validator_1 = require("../../standard/validators/angular-structure.validator");
+const component_validator_1 = require("../../standard/validators/component.validator");
+const projectSchema = zod_1.z.object({
+    projectId: zod_1.z.string().trim().min(1).optional(),
+    projectPath: zod_1.z.string().trim().min(1).optional(),
+}).strict();
+function angularStandardTools() {
+    return [
+        {
+            name: "ngm_angular_validate_structure",
+            description: "Validate configured Angular pages/components/services/models directory structure.",
+            riskLevel: "read",
+            inputSchema: projectSchema,
+            async handler(args, context) {
+                const project = await (0, project_files_1.resolveProjectRoot)(context, args);
+                const loaded = await (0, frontend_standard_service_1.loadFrontendStandard)(project);
+                const files = await (0, frontend_standard_service_1.scanFrontendProject)(project.projectRoot);
+                return (0, result_1.ok)("ngm_angular_validate_structure", (0, angular_structure_validator_1.validateAngularStructure)(files, loaded.standard));
+            },
+        },
+        {
+            name: "ngm_angular_validate_component_naming",
+            description: "Validate Angular component file suffix naming for page/component/dialog/drawer/table/form conventions.",
+            riskLevel: "read",
+            inputSchema: projectSchema,
+            async handler(args, context) {
+                const project = await (0, project_files_1.resolveProjectRoot)(context, args);
+                const loaded = await (0, frontend_standard_service_1.loadFrontendStandard)(project);
+                const files = await (0, frontend_standard_service_1.scanFrontendProject)(project.projectRoot);
+                return (0, result_1.ok)("ngm_angular_validate_component_naming", (0, component_validator_1.validateComponentNaming)(files, loaded.standard));
+            },
+        },
+        {
+            name: "ngm_angular_validate_component_boundary",
+            description: "Detect large components, obvious any usage, hardcoded remote API URLs, and page placement issues.",
+            riskLevel: "read",
+            inputSchema: projectSchema,
+            async handler(args, context) {
+                const project = await (0, project_files_1.resolveProjectRoot)(context, args);
+                const loaded = await (0, frontend_standard_service_1.loadFrontendStandard)(project);
+                const files = await (0, frontend_standard_service_1.scanFrontendProject)(project.projectRoot);
+                return (0, result_1.ok)("ngm_angular_validate_component_boundary", (0, component_validator_1.validateComponentBoundary)(files, loaded.standard));
+            },
+        },
+    ];
+}

package/lib/tools/angular/index.d.ts

@@ -0,0 +1 @@
+export { angularStandardTools } from "./angular-standard.tools";

package/lib/tools/angular/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.angularStandardTools = void 0;
+var angular_standard_tools_1 = require("./angular-standard.tools");
+Object.defineProperty(exports, "angularStandardTools", { enumerable: true, get: function () { return angular_standard_tools_1.angularStandardTools; } });

package/lib/tools/capability.tools.d.ts

@@ -0,0 +1,2 @@
+import type { McpToolDefinition } from "./index";
+export declare function capabilityTools(): McpToolDefinition[];

package/lib/tools/capability.tools.js

@@ -0,0 +1,205 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.capabilityTools = capabilityTools;
+const zod_1 = require("zod");
+const result_1 = require("../utils/result");
+const tool_catalog_1 = require("./tool-catalog");
+const tool_policy_1 = require("../policy/tool-policy");
+const tool_names_1 = require("../registry/tool-names");
+const routeTaskSchema = zod_1.z.object({
+    query: zod_1.z.string().trim().min(1),
+}).strict();
+function hasAny(text, words) {
+    return words.some((word) => text.includes(word));
+}
+function unique(values) {
+    return [...new Set(values)];
+}
+function routeTask(query) {
+    const text = query.toLowerCase();
+    const localExecution = hasAny(text, [
+        "start",
+        "stop",
+        "restart",
+        "run script",
+        "package.json",
+        "npm",
+        "pnpm",
+        "yarn",
+        "启动",
+        "停止",
+        "重启",
+        "脚本",
+        "运行命令",
+    ]);
+    const runtime = hasAny(text, ["node", "runtime", "nvm", "volta", "version", "版本", "运行时"]);
+    const nginx = hasAny(text, ["nginx", "proxy", "upstream", "server block", "reload", "代理", "端口转发"]);
+    const workspace = hasAny(text, [
+        "workspace",
+        "monorepo",
+        "packages/",
+        "package",
+        "mcp",
+        "tool",
+        "codegraph",
+        "api debugging",
+        "api 调试",
+        "design handoff",
+        "代码上下文",
+        "工作区",
+        "仓库",
+        "能力",
+    ]);
+    const frontendStandard = hasAny(text, [
+        "frontend",
+        "angular",
+        "ng-zorro",
+        "standard",
+        "review",
+        "commit",
+        "branch",
+        "spec",
+        "workflow",
+        "前端",
+        "规范",
+        "评审",
+        "提交",
+        "分支",
+        "测试",
+        "组件",
+        "流程",
+    ]);
+    const hubV2 = hasAny(text, [
+        "issue",
+        "issues",
+        "rd",
+        "研发项",
+        "需求文档",
+        "项目文档",
+        "协作",
+        "project token",
+        "hub v2",
+        "hub-v2",
+    ]);
+    const hubDocs = hasAny(text, ["doc", "docs", "document", "文档", "需求文档", "项目文档"]);
+    if ((localExecution || runtime || nginx || workspace || frontendStandard) && !hasAny(text, ["查一下某个研发项的需求文档"])) {
+        const skills = ["ngm-router"];
+        const tools = [tool_names_1.MCP_TOOL_NAMES.NGM_CAPABILITIES];
+        if (workspace) {
+            skills.push("ngm-workspace");
+            tools.push(tool_names_1.MCP_TOOL_NAMES.NGM_WORKSPACE_SUMMARY, tool_names_1.MCP_TOOL_NAMES.NGM_WORKSPACE_MCP_TOOLS, tool_names_1.MCP_TOOL_NAMES.NGM_WORKSPACE_CAPABILITY_MAP);
+        }
+        if (localExecution) {
+            skills.push("ngm-project");
+            tools.push(tool_names_1.MCP_TOOL_NAMES.NGM_PROJECT_FIND, tool_names_1.MCP_TOOL_NAMES.NGM_PROJECT_READ_PACKAGE_JSON, tool_names_1.MCP_TOOL_NAMES.NGM_TASK_LIST);
+        }
+        if (runtime) {
+            skills.push("ngm-runtime");
+            tools.push(tool_names_1.MCP_TOOL_NAMES.NGM_RUNTIME_CURRENT, tool_names_1.MCP_TOOL_NAMES.NGM_RUNTIME_DETECT_REQUIREMENT, tool_names_1.MCP_TOOL_NAMES.NGM_RUNTIME_RESOLVE_FOR_PROJECT);
+        }
+        if (nginx) {
+            skills.push("ngm-nginx");
+            tools.push(tool_names_1.MCP_TOOL_NAMES.NGM_NGINX_STATUS, tool_names_1.MCP_TOOL_NAMES.NGM_NGINX_SERVERS_LIST, tool_names_1.MCP_TOOL_NAMES.NGM_NGINX_CONFIG_VALIDATE);
+        }
+        if (frontendStandard) {
+            skills.push("ngm-frontend-standard");
+            tools.push(tool_names_1.MCP_TOOL_NAMES.NGM_STANDARD_GET, tool_names_1.MCP_TOOL_NAMES.NGM_STANDARD_VALIDATE_PROJECT, tool_names_1.MCP_TOOL_NAMES.NGM_WORKFLOW_VALIDATE_BEFORE_WRITE, tool_names_1.MCP_TOOL_NAMES.NGM_REVIEW_GENERATE_CHECKLIST);
+        }
+        if (skills.length === 1) {
+            skills.push("ngm-workspace");
+            tools.push(tool_names_1.MCP_TOOL_NAMES.NGM_WORKSPACE_SUMMARY);
+        }
+        return {
+            skills: unique(skills),
+            tools: unique(tools),
+            reason: "The request mentions local ng-manager engineering control or workspace context.",
+        };
+    }
+    if (hubV2) {
+        const skills = ["ngm-router", "hub-v2-api"];
+        const tools = [tool_names_1.MCP_TOOL_NAMES.HUB_V2_PROJECTS_LIST];
+        if (hubDocs) {
+            skills.push("hub-v2-docs");
+            tools.push(tool_names_1.MCP_TOOL_NAMES.HUB_V2_DOCS_LIST, tool_names_1.MCP_TOOL_NAMES.HUB_V2_DOCS_GET, tool_names_1.MCP_TOOL_NAMES.HUB_V2_DOCS_GET_BY_SLUG);
+        }
+        if (hasAny(text, ["issue", "issues", "问题"])) {
+            tools.push(tool_names_1.MCP_TOOL_NAMES.HUB_V2_ISSUES_LIST, tool_names_1.MCP_TOOL_NAMES.HUB_V2_ISSUES_GET);
+        }
+        if (hasAny(text, ["rd", "研发项"])) {
+            tools.push(tool_names_1.MCP_TOOL_NAMES.HUB_V2_RD_LIST, tool_names_1.MCP_TOOL_NAMES.HUB_V2_RD_GET);
+        }
+        return {
+            skills: unique(skills),
+            tools: unique(tools),
+            reason: "The request appears to target Hub V2 collaboration data.",
+        };
+    }
+    return {
+        skills: ["ngm-router", "ngm-workspace"],
+        tools: [tool_names_1.MCP_TOOL_NAMES.NGM_CAPABILITIES, tool_names_1.MCP_TOOL_NAMES.NGM_WORKSPACE_SUMMARY, tool_names_1.MCP_TOOL_NAMES.NGM_WORKSPACE_CAPABILITY_MAP],
+        reason: "No narrower domain was detected; start with local workspace capability discovery.",
+    };
+}
+function capabilityTools() {
+    return [
+        {
+            name: tool_names_1.MCP_TOOL_NAMES.NGM_CAPABILITIES,
+            description: "List ng-manager MCP capability groups, matching skills, tool names, and currently blocked local actions.",
+            riskLevel: "read",
+            inputSchema: zod_1.z.object({}).strict(),
+            handler() {
+                return (0, result_1.ok)(tool_names_1.MCP_TOOL_NAMES.NGM_CAPABILITIES, {
+                    capabilities: tool_catalog_1.capabilityCatalog,
+                    tools: tool_catalog_1.toolCatalog,
+                    blockedLocalActions: tool_catalog_1.blockedLocalActions,
+                });
+            },
+        },
+        {
+            name: tool_names_1.MCP_TOOL_NAMES.NGM_DOCTOR,
+            description: "Inspect ng-manager MCP server readiness, policy flags, Hub V2 configuration, and registered tool coverage. Prefer this read-only MCP diagnostic before shell checks because it reports the same controlled server/audit/policy view agents use.",
+            riskLevel: "read",
+            inputSchema: zod_1.z.object({}).strict(),
+            handler() {
+                const policy = (0, tool_policy_1.createDefaultToolPolicy)();
+                const counts = tool_catalog_1.toolCatalog.reduce((acc, tool) => {
+                    acc[tool.riskLevel] = (acc[tool.riskLevel] ?? 0) + 1;
+                    return acc;
+                }, {});
+                return (0, result_1.ok)(tool_names_1.MCP_TOOL_NAMES.NGM_DOCTOR, {
+                    status: "OK",
+                    runtime: {
+                        node: process.version,
+                        platform: `${process.platform} ${process.arch}`,
+                        cwd: process.cwd(),
+                    },
+                    policy,
+                    tools: {
+                        total: tool_catalog_1.toolCatalog.length,
+                        counts,
+                    },
+                    localServer: {
+                        discovery: ["runtime lock file", "NGM_MCP_SERVER_URL", "NGM_SERVER_URL"],
+                    },
+                    notes: [
+                        "Read tools are enabled by default.",
+                        "Confirmed write tools require NGM_MCP_ALLOW_WRITE=true.",
+                        "Confirmed execute tools require NGM_MCP_ALLOW_EXECUTE=true.",
+                    ],
+                });
+            },
+        },
+        {
+            name: tool_names_1.MCP_TOOL_NAMES.NGM_ROUTE_TASK,
+            description: "Route a user request to Hub V2 or NGM local skills and recommend read-only MCP tools.",
+            riskLevel: "read",
+            inputSchema: routeTaskSchema,
+            handler(args) {
+                return (0, result_1.ok)(tool_names_1.MCP_TOOL_NAMES.NGM_ROUTE_TASK, {
+                    query: args.query,
+                    ...routeTask(args.query),
+                });
+            },
+        },
+    ];
+}

package/lib/tools/controlled/index.d.ts

@@ -0,0 +1,2 @@
+import type { McpToolDefinition } from "../index";
+export declare function controlledTools(): McpToolDefinition[];

package/lib/tools/controlled/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.controlledTools = controlledTools;
+const nginx_control_tools_1 = require("../nginx/nginx-control.tools");
+const project_control_tools_1 = require("../project/project-control.tools");
+const runtime_control_tools_1 = require("../runtime/runtime-control.tools");
+function controlledTools() {
+    return [
+        ...(0, project_control_tools_1.projectControlTools)(),
+        ...(0, runtime_control_tools_1.runtimeControlTools)(),
+        ...(0, nginx_control_tools_1.nginxControlTools)(),
+    ];
+}

package/lib/tools/controlled/local-server.d.ts

@@ -0,0 +1,6 @@
+import type { LocalServerAvailability, LocalServerClient, ToolContext } from "../../context/tool-context";
+export declare function localServerAvailability(context: ToolContext): Promise<LocalServerAvailability>;
+export declare function requireLocalServer(context: ToolContext): Promise<{
+    server?: LocalServerClient;
+    availability: LocalServerAvailability;
+}>;