mcp-ai-agent-guidelines 0.5.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (114) hide show
  1. package/README.md +89 -12
  2. package/dist/index.js +421 -4
  3. package/dist/index.js.map +1 -1
  4. package/dist/prompts/index.d.ts.map +1 -1
  5. package/dist/prompts/index.js +164 -0
  6. package/dist/prompts/index.js.map +1 -1
  7. package/dist/tools/analysis/gap-frameworks-analyzers.d.ts +7 -0
  8. package/dist/tools/analysis/gap-frameworks-analyzers.d.ts.map +1 -0
  9. package/dist/tools/analysis/gap-frameworks-analyzers.js +216 -0
  10. package/dist/tools/analysis/gap-frameworks-analyzers.js.map +1 -0
  11. package/dist/tools/analysis/strategy-frameworks-builder.d.ts +7 -0
  12. package/dist/tools/analysis/strategy-frameworks-builder.d.ts.map +1 -0
  13. package/dist/tools/analysis/strategy-frameworks-builder.js +326 -0
  14. package/dist/tools/analysis/strategy-frameworks-builder.js.map +1 -0
  15. package/dist/tools/design/adr-generator.d.ts +31 -0
  16. package/dist/tools/design/adr-generator.d.ts.map +1 -0
  17. package/dist/tools/design/adr-generator.js +343 -0
  18. package/dist/tools/design/adr-generator.js.map +1 -0
  19. package/dist/tools/design/confirmation-module.d.ts +79 -0
  20. package/dist/tools/design/confirmation-module.d.ts.map +1 -0
  21. package/dist/tools/design/confirmation-module.js +520 -0
  22. package/dist/tools/design/confirmation-module.js.map +1 -0
  23. package/dist/tools/design/confirmation-prompt-builder.d.ts +71 -0
  24. package/dist/tools/design/confirmation-prompt-builder.d.ts.map +1 -0
  25. package/dist/tools/design/confirmation-prompt-builder.js +542 -0
  26. package/dist/tools/design/confirmation-prompt-builder.js.map +1 -0
  27. package/dist/tools/design/constraint-consistency-enforcer.d.ts +140 -0
  28. package/dist/tools/design/constraint-consistency-enforcer.d.ts.map +1 -0
  29. package/dist/tools/design/constraint-consistency-enforcer.js +488 -0
  30. package/dist/tools/design/constraint-consistency-enforcer.js.map +1 -0
  31. package/dist/tools/design/constraint-manager.d.ts +412 -0
  32. package/dist/tools/design/constraint-manager.d.ts.map +1 -0
  33. package/dist/tools/design/constraint-manager.js +494 -0
  34. package/dist/tools/design/constraint-manager.js.map +1 -0
  35. package/dist/tools/design/coverage-enforcer.d.ts +59 -0
  36. package/dist/tools/design/coverage-enforcer.d.ts.map +1 -0
  37. package/dist/tools/design/coverage-enforcer.js +486 -0
  38. package/dist/tools/design/coverage-enforcer.js.map +1 -0
  39. package/dist/tools/design/cross-session-consistency-enforcer.d.ts +54 -0
  40. package/dist/tools/design/cross-session-consistency-enforcer.d.ts.map +1 -0
  41. package/dist/tools/design/cross-session-consistency-enforcer.js +674 -0
  42. package/dist/tools/design/cross-session-consistency-enforcer.js.map +1 -0
  43. package/dist/tools/design/design-assistant.d.ts +75 -0
  44. package/dist/tools/design/design-assistant.d.ts.map +1 -0
  45. package/dist/tools/design/design-assistant.js +1017 -0
  46. package/dist/tools/design/design-assistant.js.map +1 -0
  47. package/dist/tools/design/design-phase-workflow.d.ts +51 -0
  48. package/dist/tools/design/design-phase-workflow.d.ts.map +1 -0
  49. package/dist/tools/design/design-phase-workflow.js +423 -0
  50. package/dist/tools/design/design-phase-workflow.js.map +1 -0
  51. package/dist/tools/design/index.d.ts +19 -0
  52. package/dist/tools/design/index.d.ts.map +1 -0
  53. package/dist/tools/design/index.js +16 -0
  54. package/dist/tools/design/index.js.map +1 -0
  55. package/dist/tools/design/methodology-selector.d.ts +32 -0
  56. package/dist/tools/design/methodology-selector.d.ts.map +1 -0
  57. package/dist/tools/design/methodology-selector.js +664 -0
  58. package/dist/tools/design/methodology-selector.js.map +1 -0
  59. package/dist/tools/design/pivot-module.d.ts +37 -0
  60. package/dist/tools/design/pivot-module.d.ts.map +1 -0
  61. package/dist/tools/design/pivot-module.js +280 -0
  62. package/dist/tools/design/pivot-module.js.map +1 -0
  63. package/dist/tools/design/roadmap-generator.d.ts +95 -0
  64. package/dist/tools/design/roadmap-generator.d.ts.map +1 -0
  65. package/dist/tools/design/roadmap-generator.js +709 -0
  66. package/dist/tools/design/roadmap-generator.js.map +1 -0
  67. package/dist/tools/design/spec-generator.d.ts +71 -0
  68. package/dist/tools/design/spec-generator.d.ts.map +1 -0
  69. package/dist/tools/design/spec-generator.js +1021 -0
  70. package/dist/tools/design/spec-generator.js.map +1 -0
  71. package/dist/tools/design/strategic-pivot-prompt-builder.d.ts +33 -0
  72. package/dist/tools/design/strategic-pivot-prompt-builder.d.ts.map +1 -0
  73. package/dist/tools/design/strategic-pivot-prompt-builder.js +505 -0
  74. package/dist/tools/design/strategic-pivot-prompt-builder.js.map +1 -0
  75. package/dist/tools/design/types.d.ts +402 -0
  76. package/dist/tools/design/types.d.ts.map +1 -0
  77. package/dist/tools/design/types.js +3 -0
  78. package/dist/tools/design/types.js.map +1 -0
  79. package/dist/tools/guidelines-validator.d.ts.map +1 -1
  80. package/dist/tools/guidelines-validator.js +12 -1
  81. package/dist/tools/guidelines-validator.js.map +1 -1
  82. package/dist/tools/iterative-coverage-enhancer.d.ts +7 -0
  83. package/dist/tools/iterative-coverage-enhancer.d.ts.map +1 -0
  84. package/dist/tools/iterative-coverage-enhancer.js +383 -0
  85. package/dist/tools/iterative-coverage-enhancer.js.map +1 -0
  86. package/dist/tools/mermaid-diagram-generator.d.ts.map +1 -1
  87. package/dist/tools/mermaid-diagram-generator.js +13 -1
  88. package/dist/tools/mermaid-diagram-generator.js.map +1 -1
  89. package/dist/tools/model-compatibility-checker.d.ts.map +1 -1
  90. package/dist/tools/model-compatibility-checker.js +4 -2
  91. package/dist/tools/model-compatibility-checker.js.map +1 -1
  92. package/dist/tools/{domain-neutral-prompt-builder.d.ts → prompt/domain-neutral-prompt-builder.d.ts} +50 -50
  93. package/dist/tools/prompt/domain-neutral-prompt-builder.d.ts.map +1 -0
  94. package/dist/tools/{domain-neutral-prompt-builder.js → prompt/domain-neutral-prompt-builder.js} +2 -2
  95. package/dist/tools/prompt/domain-neutral-prompt-builder.js.map +1 -0
  96. package/dist/tools/prompt/hierarchical-prompt-builder.d.ts.map +1 -0
  97. package/dist/tools/{hierarchical-prompt-builder.js → prompt/hierarchical-prompt-builder.js} +2 -2
  98. package/dist/tools/prompt/hierarchical-prompt-builder.js.map +1 -0
  99. package/dist/tools/prompt/security-hardening-prompt-builder.d.ts +7 -0
  100. package/dist/tools/prompt/security-hardening-prompt-builder.d.ts.map +1 -0
  101. package/dist/tools/prompt/security-hardening-prompt-builder.js +317 -0
  102. package/dist/tools/prompt/security-hardening-prompt-builder.js.map +1 -0
  103. package/dist/tools/{spark-prompt-builder.d.ts → prompt/spark-prompt-builder.d.ts} +30 -30
  104. package/dist/tools/prompt/spark-prompt-builder.d.ts.map +1 -0
  105. package/dist/tools/{spark-prompt-builder.js → prompt/spark-prompt-builder.js} +2 -2
  106. package/dist/tools/prompt/spark-prompt-builder.js.map +1 -0
  107. package/package.json +15 -6
  108. package/dist/tools/domain-neutral-prompt-builder.d.ts.map +0 -1
  109. package/dist/tools/domain-neutral-prompt-builder.js.map +0 -1
  110. package/dist/tools/hierarchical-prompt-builder.d.ts.map +0 -1
  111. package/dist/tools/hierarchical-prompt-builder.js.map +0 -1
  112. package/dist/tools/spark-prompt-builder.d.ts.map +0 -1
  113. package/dist/tools/spark-prompt-builder.js.map +0 -1
  114. /package/dist/tools/{hierarchical-prompt-builder.d.ts → prompt/hierarchical-prompt-builder.d.ts} +0 -0
package/README.md CHANGED
@@ -1,15 +1,20 @@
1
- ## MCP AI Agent Guidelines Server
1
+ # MCP AI Agent Guidelines Server
2
2
 
3
3
  > [!CAUTION]
4
- > **Disclaimer -- Experimental / Early Stage:** This project references third‑party models, tools, pricing, and docs that evolve quickly. Treat outputs as recommendations and verify against official docs and your own benchmarks before production use.
4
+ > **Disclaimer -- Experimental / Early Stage:** This _research demonstrator_ project references third‑party models, tools, pricing, and docs that evolve quickly. Treat outputs as recommendations and verify against official docs and your own benchmarks before production use.
5
5
 
6
- [![CI/CD Pipeline](https://github.com/Anselmoo/mcp-ai-agent-guidelines/actions/workflows/ci-cd.yml/badge.svg)](https://github.com/Anselmoo/mcp-ai-agent-guidelines/actions/workflows/ci-cd.yml)
7
- [![codecov](https://codecov.io/gh/Anselmoo/mcp-ai-agent-guidelines/branch/main/graph/badge.svg)](https://codecov.io/gh/Anselmoo/mcp-ai-agent-guidelines)
8
- [![Coverage Status](https://img.shields.io/codecov/c/github/Anselmoo/mcp-ai-agent-guidelines/main?label=coverage&logo=codecov)](https://codecov.io/gh/Anselmoo/mcp-ai-agent-guidelines)
9
- [![NPM version](https://badge.fury.io/js/mcp-ai-agent-guidelines.svg)](https://badge.fury.io/js/mcp-ai-agent-guidelines)
10
- [![Node.js 20+](https://img.shields.io/badge/node-20%2B-green.svg)](https://nodejs.org/en/download/)
11
- [![Docker](https://img.shields.io/badge/docker-available-blue.svg)](https://github.com/Anselmoo/mcp-ai-agent-guidelines/pkgs/container/mcp-ai-agent-guidelines)
12
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
6
+ [![CI/CD Pipeline](https://img.shields.io/github/actions/workflow/status/Anselmoo/mcp-ai-agent-guidelines/ci-cd.yml?branch=main&label=CI%2FCD&logo=github-actions&logoColor=white)](https://github.com/Anselmoo/mcp-ai-agent-guidelines/actions/workflows/ci-cd.yml)
7
+ [![Coverage Status](https://img.shields.io/codecov/c/github/Anselmoo/mcp-ai-agent-guidelines/main?label=coverage&logo=codecov&logoColor=white)](https://codecov.io/gh/Anselmoo/mcp-ai-agent-guidelines)
8
+ [![NPM Version](https://img.shields.io/npm/v/mcp-ai-agent-guidelines?label=npm&logo=npm&logoColor=white&color=red)](https://www.npmjs.com/package/mcp-ai-agent-guidelines)
9
+ [![Node.js Version](https://img.shields.io/node/v/mcp-ai-agent-guidelines?label=node&logo=node.js&logoColor=white&color=green)](https://nodejs.org/en/download/)
10
+ [![Docker](https://img.shields.io/badge/docker-available-blue?logo=docker&logoColor=white)](https://github.com/Anselmoo/mcp-ai-agent-guidelines/pkgs/container/mcp-ai-agent-guidelines)
11
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow?logo=opensourceinitiative&logoColor=white)](./LICENSE)
12
+
13
+ [![GitHub Stars](https://img.shields.io/github/stars/Anselmoo/mcp-ai-agent-guidelines?style=social)](https://github.com/Anselmoo/mcp-ai-agent-guidelines/stargazers)
14
+ [![GitHub Forks](https://img.shields.io/github/forks/Anselmoo/mcp-ai-agent-guidelines?style=social)](https://github.com/Anselmoo/mcp-ai-agent-guidelines/network/members)
15
+ [![GitHub Issues](https://img.shields.io/github/issues/Anselmoo/mcp-ai-agent-guidelines?label=issues&logo=github&logoColor=white)](https://github.com/Anselmoo/mcp-ai-agent-guidelines/issues)
16
+ [![NPM Downloads](https://img.shields.io/npm/dt/mcp-ai-agent-guidelines?label=downloads&logo=npm&logoColor=white&color=blue)](https://www.npmjs.com/package/mcp-ai-agent-guidelines)
17
+ [![GitHub Last Commit](https://img.shields.io/github/last-commit/Anselmoo/mcp-ai-agent-guidelines?logo=github&logoColor=white)](https://github.com/Anselmoo/mcp-ai-agent-guidelines/commits/main)
13
18
 
14
19
  A Model Context Protocol (MCP) server offering professional tools and templates for hierarchical prompting, code hygiene, visualization, memory optimization, and agile planning.
15
20
 
@@ -46,6 +51,7 @@ Explore generated demo reports in the repository:
46
51
  - Guidelines Validation: [demos/demo-code-analysis.guidelines.md](./demos/demo-code-analysis.guidelines.md)
47
52
  - Hierarchical Prompt (Refactor plan): [demos/demo-code-analysis.hierarchical.prompt.md](./demos/demo-code-analysis.hierarchical.prompt.md)
48
53
  - Domain-neutral Prompt Template: [demos/demo-code-analysis.domain-neutral.prompt.md](./demos/demo-code-analysis.domain-neutral.prompt.md)
54
+ - Security Hardening Prompt: [demos/demo-code-analysis.security-hardening.prompt.md](./demos/demo-code-analysis.security-hardening.prompt.md)
49
55
  - Spark Prompt Card: [demos/demo-code-analysis.spark.prompt.md](./demos/demo-code-analysis.spark.prompt.md)
50
56
  - Memory Context Optimization: [demos/demo-code-analysis.memory.md](./demos/demo-code-analysis.memory.md)
51
57
  - Architecture Diagram (Mermaid): [demos/demo-code-analysis.diagram.md](./demos/demo-code-analysis.diagram.md)
@@ -78,8 +84,8 @@ Scripts:
78
84
 
79
85
  Use buttons below to add this MCP server to VS Code (User Settings → mcp.servers):
80
86
 
81
- [![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-NPX-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=ai-agent-guidelines&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22mcp-ai-agent-guidelines%22%5D%7D)
82
- [![Install with NPX in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-NPX-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=ai-agent-guidelines&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22mcp-ai-agent-guidelines%22%5D%7D&quality=insiders)
87
+ [![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-NPX-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=ai-agent-guidelines&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22mcp-ai-agent-guidelines%3Alatest%22%5D%7D)
88
+ [![Install with NPX in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-NPX-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=ai-agent-guidelines&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22mcp-ai-agent-guidelines%3Alatest%22%5D%7D&quality=insiders)
83
89
  [![Install with Docker in VS Code](https://img.shields.io/badge/VS_Code-Docker-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=ai-agent-guidelines&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22--rm%22%2C%22-i%22%2C%22ghcr.io%2Fanselmoo%2Fmcp-ai-agent-guidelines%3Alatest%22%5D%7D)
84
90
  [![Install with Docker in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Docker-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=ai-agent-guidelines&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22--rm%22%2C%22-i%22%2C%22ghcr.io%2Fanselmoo%2Fmcp-ai-agent-guidelines%3Alatest%22%5D%7D&quality=insiders)
85
91
 
@@ -167,6 +173,33 @@ Usage: `code-hygiene-analyzer`
167
173
 
168
174
  </details>
169
175
 
176
+ <details>
177
+ <summary><strong>Security Hardening Prompt Builder</strong> — Build specialized security analysis and vulnerability assessment prompts</summary>
178
+
179
+ Usage: `security-hardening-prompt-builder`
180
+
181
+ | Parameter | Required | Description |
182
+ | --------- | -------- | ----------- |
183
+ | `codeContext` | ✅ | Code context or description to analyze for security |
184
+ | `securityFocus` | ❌ | Security analysis focus (vulnerability-analysis, security-hardening, compliance-check, threat-modeling, penetration-testing) |
185
+ | `securityRequirements` | ❌ | Specific security requirements to check |
186
+ | `complianceStandards` | ❌ | Compliance standards (OWASP-Top-10, NIST-Cybersecurity-Framework, ISO-27001, SOC-2, GDPR, HIPAA, PCI-DSS) |
187
+ | `language` | ❌ | Programming language of the code |
188
+ | `riskTolerance` | ❌ | Risk tolerance level (low, medium, high) |
189
+ | `analysisScope` | ❌ | Security areas to focus on (input-validation, authentication, authorization, etc.) |
190
+ | `outputFormat` | ❌ | Output format (detailed, checklist, annotated-code) |
191
+
192
+ **Security Focus Areas:**
193
+ - 🔍 Vulnerability analysis with OWASP Top 10 coverage
194
+ - 🛡️ Security hardening recommendations
195
+ - 📋 Compliance checking against industry standards
196
+ - ⚠️ Threat modeling and risk assessment
197
+ - 🧪 Penetration testing guidance
198
+
199
+ **Compliance Standards:** OWASP Top 10, NIST Cybersecurity Framework, ISO 27001, SOC 2, GDPR, HIPAA, PCI-DSS
200
+
201
+ </details>
202
+
170
203
  <details>
171
204
  <summary><strong>Mermaid Diagram Generator</strong> — Generate professional diagrams from text descriptions</summary>
172
205
 
@@ -240,10 +273,21 @@ Usage: `guidelines-validator`
240
273
 
241
274
  ## Versioning
242
275
 
243
- - Package version: `0.1.0` (matches internal resource versions).
276
+ - Package version: `0.7.0` (matches internal resource versions).
244
277
  - Tags `vX.Y.Z` trigger CI for NPM and Docker releases.
245
278
  - Pin exact versions for production stability.
246
279
 
280
+ ### Release Setup
281
+
282
+ Use the [Release Setup Issue Form](.github/ISSUE_TEMPLATE/release-setup.yml) to streamline the release process:
283
+
284
+ - **Automated version management**: Update version numbers across the codebase
285
+ - **GitHub Copilot compatible**: Structured form enables bot automation
286
+ - **Quality gates**: Pre-release checklist ensures reliability
287
+ - **CI/CD integration**: Supports existing NPM and Docker publishing workflow
288
+
289
+ To create a new release, [open a release setup issue](../../issues/new?template=release-setup.yml) with the target version and release details.
290
+
247
291
  ## Development
248
292
 
249
293
  Prerequisites:
@@ -281,6 +325,38 @@ npm run test:coverage:unit # Unit test coverage (text-summary, lcov, html)
281
325
  npm run quality # Type-check + Biome check
282
326
  ```
283
327
 
328
+ ### Git Hooks with Lefthook 🪝
329
+
330
+ This project uses [Lefthook](https://github.com/evilmartians/lefthook) for fast, reliable Git hooks that enforce code quality and security standards.
331
+
332
+ **Mandatory for GitHub Copilot Agent**: All quality gates must pass before commits and pushes.
333
+
334
+ Setup (automatic via `npm install`):
335
+ ```bash
336
+ npm run hooks:install # Install lefthook git hooks
337
+ npm run hooks:uninstall # Remove lefthook git hooks
338
+ npx lefthook run pre-commit # Run pre-commit checks manually
339
+ npx lefthook run pre-push # Run pre-push checks manually
340
+ ```
341
+
342
+ **Pre-commit hooks** (fast, parallel execution):
343
+ - 🔒 **Security**: Gitleaks secret detection
344
+ - 🟨 **Code Quality**: Biome formatting & linting
345
+ - 🔷 **Type Safety**: TypeScript type checking
346
+ - 🧹 **Code Hygiene**: Trailing whitespace & EOF fixes
347
+
348
+ **Pre-push hooks** (comprehensive validation):
349
+ - 🧪 **Testing**: Full test suite (unit, integration, demo, MCP)
350
+ - ⚡ **Quality**: Type checking + Biome validation
351
+
352
+ **Why Lefthook?**
353
+ - ⚡ **Fast**: Written in Go, parallel execution
354
+ - 🔄 **Reliable**: Better error handling than pre-commit
355
+ - 🤖 **CI Integration**: Mandatory quality gates for GitHub Copilot Agent
356
+ - 📝 **Simple**: Single YAML configuration file
357
+
358
+ Configuration: [`lefthook.yml`](./lefthook.yml)
359
+
284
360
  ### Coverage reporting
285
361
 
286
362
  - CI publishes a coverage summary in the job’s Summary and uploads `coverage/` as an artifact.
@@ -342,3 +418,4 @@ MIT © Anselmoo — see [LICENSE](./LICENSE).
342
418
  - Model Context Protocol team for the spec
343
419
  - Anthropic for prompt caching research
344
420
  - Mermaid community for diagram tooling
421
+ # Test change for Docker fix
package/dist/index.js CHANGED
@@ -18,15 +18,20 @@ import { CallToolRequestSchema, GetPromptRequestSchema, ListPromptsRequestSchema
18
18
  import { getPrompt, listPrompts } from "./prompts/index.js";
19
19
  // Import resources
20
20
  import { getResource, listResources } from "./resources/index.js";
21
+ import { gapFrameworksAnalyzers } from "./tools/analysis/gap-frameworks-analyzers.js";
22
+ import { strategyFrameworksBuilder } from "./tools/analysis/strategy-frameworks-builder.js";
21
23
  import { codeHygieneAnalyzer } from "./tools/code-hygiene-analyzer.js";
22
- import { domainNeutralPromptBuilder } from "./tools/domain-neutral-prompt-builder.js";
24
+ import { designAssistant, } from "./tools/design/index.js";
23
25
  import { guidelinesValidator } from "./tools/guidelines-validator.js";
24
- // Import tool implementations
25
- import { hierarchicalPromptBuilder } from "./tools/hierarchical-prompt-builder.js";
26
+ import { iterativeCoverageEnhancer } from "./tools/iterative-coverage-enhancer.js";
26
27
  import { memoryContextOptimizer } from "./tools/memory-context-optimizer.js";
27
28
  import { mermaidDiagramGenerator } from "./tools/mermaid-diagram-generator.js";
28
29
  import { modelCompatibilityChecker } from "./tools/model-compatibility-checker.js";
29
- import { sparkPromptBuilder } from "./tools/spark-prompt-builder.js";
30
+ import { domainNeutralPromptBuilder } from "./tools/prompt/domain-neutral-prompt-builder.js";
31
+ // Import tool implementations
32
+ import { hierarchicalPromptBuilder } from "./tools/prompt/hierarchical-prompt-builder.js";
33
+ import { securityHardeningPromptBuilder } from "./tools/prompt/security-hardening-prompt-builder.js";
34
+ import { sparkPromptBuilder } from "./tools/prompt/spark-prompt-builder.js";
30
35
  import { sprintTimelineCalculator } from "./tools/sprint-timeline-calculator.js";
31
36
  const server = new Server({
32
37
  name: "ai-agent-guidelines",
@@ -134,6 +139,102 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
134
139
  required: ["context", "goal"],
135
140
  },
136
141
  },
142
+ {
143
+ name: "strategy-frameworks-builder",
144
+ description: "Compose strategy analysis sections from selected frameworks (SWOT, BSC, VRIO, etc.) with compliant aliases for certain trademarks",
145
+ inputSchema: {
146
+ type: "object",
147
+ properties: {
148
+ frameworks: {
149
+ type: "array",
150
+ items: {
151
+ type: "string",
152
+ enum: [
153
+ "asIsToBe",
154
+ "whereToPlayHowToWin",
155
+ "balancedScorecard",
156
+ "swot",
157
+ "objectives",
158
+ "portersFiveForces",
159
+ "mckinsey7S",
160
+ "marketAnalysis",
161
+ "strategyMap",
162
+ "visionToMission",
163
+ "stakeholderTheory",
164
+ "values",
165
+ "gapAnalysis",
166
+ "ansoffMatrix",
167
+ "pest",
168
+ "bcgMatrix",
169
+ "blueOcean",
170
+ "scenarioPlanning",
171
+ "vrio",
172
+ "goalBasedPlanning",
173
+ "gartnerQuadrant",
174
+ ],
175
+ },
176
+ description: "Framework identifiers to include",
177
+ },
178
+ context: { type: "string", description: "Business context" },
179
+ objectives: { type: "array", items: { type: "string" } },
180
+ market: { type: "string" },
181
+ stakeholders: { type: "array", items: { type: "string" } },
182
+ constraints: { type: "array", items: { type: "string" } },
183
+ includeReferences: { type: "boolean" },
184
+ includeMetadata: { type: "boolean" },
185
+ inputFile: { type: "string" },
186
+ },
187
+ required: ["frameworks", "context"],
188
+ },
189
+ },
190
+ {
191
+ name: "gap-frameworks-analyzers",
192
+ description: "Analyze gaps between current and desired states using various frameworks (capability, performance, maturity, etc.)",
193
+ inputSchema: {
194
+ type: "object",
195
+ properties: {
196
+ frameworks: {
197
+ type: "array",
198
+ items: {
199
+ type: "string",
200
+ enum: [
201
+ "capability",
202
+ "performance",
203
+ "maturity",
204
+ "skills",
205
+ "technology",
206
+ "process",
207
+ "market",
208
+ "strategic",
209
+ "operational",
210
+ "cultural",
211
+ "security",
212
+ "compliance",
213
+ ],
214
+ },
215
+ description: "Gap analysis framework types to include",
216
+ },
217
+ currentState: {
218
+ type: "string",
219
+ description: "Current state description",
220
+ },
221
+ desiredState: {
222
+ type: "string",
223
+ description: "Desired state description",
224
+ },
225
+ context: { type: "string", description: "Analysis context" },
226
+ objectives: { type: "array", items: { type: "string" } },
227
+ timeframe: { type: "string" },
228
+ stakeholders: { type: "array", items: { type: "string" } },
229
+ constraints: { type: "array", items: { type: "string" } },
230
+ includeReferences: { type: "boolean" },
231
+ includeMetadata: { type: "boolean" },
232
+ includeActionPlan: { type: "boolean" },
233
+ inputFile: { type: "string" },
234
+ },
235
+ required: ["frameworks", "currentState", "desiredState", "context"],
236
+ },
237
+ },
137
238
  {
138
239
  name: "spark-prompt-builder",
139
240
  description: "Build a generic UI/UX product prompt from structured inputs (title, features, colors, typography, etc.)",
@@ -334,6 +435,81 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
334
435
  required: ["codeContent", "language"],
335
436
  },
336
437
  },
438
+ {
439
+ name: "iterative-coverage-enhancer",
440
+ description: "Iteratively analyze code coverage, detect dead code, generate test suggestions, and adapt coverage thresholds for continuous improvement",
441
+ inputSchema: {
442
+ type: "object",
443
+ properties: {
444
+ projectPath: {
445
+ type: "string",
446
+ description: "Path to the project root directory",
447
+ },
448
+ language: {
449
+ type: "string",
450
+ description: "Primary programming language",
451
+ },
452
+ framework: {
453
+ type: "string",
454
+ description: "Framework or technology stack",
455
+ },
456
+ analyzeCoverageGaps: {
457
+ type: "boolean",
458
+ description: "Analyze and identify coverage gaps",
459
+ },
460
+ detectDeadCode: {
461
+ type: "boolean",
462
+ description: "Detect unused code for elimination",
463
+ },
464
+ generateTestSuggestions: {
465
+ type: "boolean",
466
+ description: "Generate test suggestions for uncovered code",
467
+ },
468
+ adaptThresholds: {
469
+ type: "boolean",
470
+ description: "Recommend adaptive coverage threshold adjustments",
471
+ },
472
+ currentCoverage: {
473
+ type: "object",
474
+ description: "Current coverage metrics",
475
+ properties: {
476
+ statements: { type: "number", minimum: 0, maximum: 100 },
477
+ functions: { type: "number", minimum: 0, maximum: 100 },
478
+ lines: { type: "number", minimum: 0, maximum: 100 },
479
+ branches: { type: "number", minimum: 0, maximum: 100 },
480
+ },
481
+ },
482
+ targetCoverage: {
483
+ type: "object",
484
+ description: "Target coverage goals",
485
+ properties: {
486
+ statements: { type: "number", minimum: 0, maximum: 100 },
487
+ functions: { type: "number", minimum: 0, maximum: 100 },
488
+ lines: { type: "number", minimum: 0, maximum: 100 },
489
+ branches: { type: "number", minimum: 0, maximum: 100 },
490
+ },
491
+ },
492
+ outputFormat: {
493
+ type: "string",
494
+ enum: ["markdown", "json", "text"],
495
+ description: "Output format for the report",
496
+ },
497
+ includeReferences: {
498
+ type: "boolean",
499
+ description: "Include references and best practice links",
500
+ },
501
+ includeCodeExamples: {
502
+ type: "boolean",
503
+ description: "Include code examples in suggestions",
504
+ },
505
+ generateCIActions: {
506
+ type: "boolean",
507
+ description: "Generate CI/CD integration actions",
508
+ },
509
+ },
510
+ required: [],
511
+ },
512
+ },
337
513
  {
338
514
  name: "mermaid-diagram-generator",
339
515
  description: "Generate Mermaid diagrams from text descriptions following best practices",
@@ -514,6 +690,160 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
514
690
  required: ["title", "summary"],
515
691
  },
516
692
  },
693
+ {
694
+ name: "security-hardening-prompt-builder",
695
+ description: "Build specialized security hardening and vulnerability analysis prompts for AI-guided security assessment",
696
+ inputSchema: {
697
+ type: "object",
698
+ properties: {
699
+ codeContext: {
700
+ type: "string",
701
+ description: "The code context or description to analyze for security",
702
+ },
703
+ securityFocus: {
704
+ type: "string",
705
+ enum: [
706
+ "vulnerability-analysis",
707
+ "security-hardening",
708
+ "compliance-check",
709
+ "threat-modeling",
710
+ "penetration-testing",
711
+ ],
712
+ description: "Primary security analysis focus",
713
+ },
714
+ securityRequirements: {
715
+ type: "array",
716
+ items: { type: "string" },
717
+ description: "Specific security requirements to check",
718
+ },
719
+ complianceStandards: {
720
+ type: "array",
721
+ items: {
722
+ type: "string",
723
+ enum: [
724
+ "OWASP-Top-10",
725
+ "NIST-Cybersecurity-Framework",
726
+ "ISO-27001",
727
+ "SOC-2",
728
+ "GDPR",
729
+ "HIPAA",
730
+ "PCI-DSS",
731
+ ],
732
+ },
733
+ description: "Compliance standards to evaluate against",
734
+ },
735
+ language: {
736
+ type: "string",
737
+ description: "Programming language of the code",
738
+ },
739
+ framework: {
740
+ type: "string",
741
+ description: "Framework or technology stack",
742
+ },
743
+ riskTolerance: {
744
+ type: "string",
745
+ enum: ["low", "medium", "high"],
746
+ description: "Risk tolerance level for security assessment",
747
+ },
748
+ analysisScope: {
749
+ type: "array",
750
+ items: {
751
+ type: "string",
752
+ enum: [
753
+ "input-validation",
754
+ "authentication",
755
+ "authorization",
756
+ "data-encryption",
757
+ "session-management",
758
+ "error-handling",
759
+ "logging-monitoring",
760
+ "dependency-security",
761
+ "configuration-security",
762
+ "api-security",
763
+ ],
764
+ },
765
+ description: "Specific security areas to focus analysis on",
766
+ },
767
+ includeCodeExamples: {
768
+ type: "boolean",
769
+ description: "Include secure code examples in output",
770
+ },
771
+ includeMitigations: {
772
+ type: "boolean",
773
+ description: "Include specific mitigation recommendations",
774
+ },
775
+ includeTestCases: {
776
+ type: "boolean",
777
+ description: "Include security test cases",
778
+ },
779
+ prioritizeFindings: {
780
+ type: "boolean",
781
+ description: "Prioritize findings by severity",
782
+ },
783
+ outputFormat: {
784
+ type: "string",
785
+ enum: ["detailed", "checklist", "annotated-code"],
786
+ description: "Preferred output format for security assessment",
787
+ },
788
+ mode: { type: "string" },
789
+ model: { type: "string" },
790
+ tools: { type: "array", items: { type: "string" } },
791
+ includeFrontmatter: { type: "boolean" },
792
+ includeDisclaimer: { type: "boolean" },
793
+ includeReferences: { type: "boolean" },
794
+ includeTechniqueHints: { type: "boolean" },
795
+ includePitfalls: { type: "boolean" },
796
+ includeMetadata: { type: "boolean" },
797
+ inputFile: { type: "string" },
798
+ forcePromptMdStyle: { type: "boolean" },
799
+ techniques: {
800
+ type: "array",
801
+ items: {
802
+ type: "string",
803
+ enum: [
804
+ "zero-shot",
805
+ "few-shot",
806
+ "chain-of-thought",
807
+ "self-consistency",
808
+ "in-context-learning",
809
+ "generate-knowledge",
810
+ "prompt-chaining",
811
+ "tree-of-thoughts",
812
+ "meta-prompting",
813
+ "rag",
814
+ "react",
815
+ "art",
816
+ ],
817
+ },
818
+ description: "Optional list of technique hints to include",
819
+ },
820
+ autoSelectTechniques: {
821
+ type: "boolean",
822
+ description: "Automatically select appropriate techniques",
823
+ },
824
+ provider: {
825
+ type: "string",
826
+ enum: [
827
+ "gpt-5",
828
+ "gpt-4.1",
829
+ "claude-4",
830
+ "claude-3.7",
831
+ "gemini-2.5",
832
+ "o4-mini",
833
+ "o3-mini",
834
+ "other",
835
+ ],
836
+ description: "Model family for tailored tips",
837
+ },
838
+ style: {
839
+ type: "string",
840
+ enum: ["markdown", "xml"],
841
+ description: "Preferred prompt formatting style",
842
+ },
843
+ },
844
+ required: ["codeContext"],
845
+ },
846
+ },
517
847
  {
518
848
  name: "sprint-timeline-calculator",
519
849
  description: "Calculate optimal development cycles and sprint timelines",
@@ -604,6 +934,74 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
604
934
  required: ["practiceDescription", "category"],
605
935
  },
606
936
  },
937
+ {
938
+ name: "design-assistant",
939
+ description: "Deterministic, context-driven design assistant with constraint framework for structured design sessions",
940
+ inputSchema: {
941
+ type: "object",
942
+ properties: {
943
+ action: {
944
+ type: "string",
945
+ enum: [
946
+ "start-session",
947
+ "advance-phase",
948
+ "validate-phase",
949
+ "evaluate-pivot",
950
+ "generate-artifacts",
951
+ "enforce-coverage",
952
+ "enforce-consistency",
953
+ "get-status",
954
+ "load-constraints",
955
+ ],
956
+ description: "Action to perform",
957
+ },
958
+ sessionId: {
959
+ type: "string",
960
+ description: "Unique session identifier",
961
+ },
962
+ config: {
963
+ type: "object",
964
+ description: "Design session configuration (required for start-session)",
965
+ properties: {
966
+ sessionId: { type: "string" },
967
+ context: { type: "string" },
968
+ goal: { type: "string" },
969
+ requirements: { type: "array", items: { type: "string" } },
970
+ coverageThreshold: { type: "number", default: 85 },
971
+ enablePivots: { type: "boolean", default: true },
972
+ templateRefs: { type: "array", items: { type: "string" } },
973
+ outputFormats: { type: "array", items: { type: "string" } },
974
+ },
975
+ },
976
+ content: {
977
+ type: "string",
978
+ description: "Content to validate or analyze",
979
+ },
980
+ phaseId: {
981
+ type: "string",
982
+ description: "Target phase ID for advance or validate actions",
983
+ },
984
+ constraintId: {
985
+ type: "string",
986
+ description: "Specific constraint ID for consistency enforcement",
987
+ },
988
+ constraintConfig: {
989
+ type: "object",
990
+ description: "Custom constraint configuration in YAML/JSON format",
991
+ },
992
+ artifactTypes: {
993
+ type: "array",
994
+ items: {
995
+ type: "string",
996
+ enum: ["adr", "specification", "roadmap"],
997
+ },
998
+ description: "Types of artifacts to generate",
999
+ default: ["adr", "specification", "roadmap"],
1000
+ },
1001
+ },
1002
+ required: ["action", "sessionId"],
1003
+ },
1004
+ },
607
1005
  ],
608
1006
  };
609
1007
  });
@@ -613,12 +1011,20 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
613
1011
  switch (name) {
614
1012
  case "hierarchical-prompt-builder":
615
1013
  return hierarchicalPromptBuilder(args);
1014
+ case "strategy-frameworks-builder":
1015
+ return strategyFrameworksBuilder(args);
1016
+ case "gap-frameworks-analyzers":
1017
+ return gapFrameworksAnalyzers(args);
616
1018
  case "spark-prompt-builder":
617
1019
  return sparkPromptBuilder(args);
618
1020
  case "domain-neutral-prompt-builder":
619
1021
  return domainNeutralPromptBuilder(args);
1022
+ case "security-hardening-prompt-builder":
1023
+ return securityHardeningPromptBuilder(args);
620
1024
  case "code-hygiene-analyzer":
621
1025
  return codeHygieneAnalyzer(args);
1026
+ case "iterative-coverage-enhancer":
1027
+ return iterativeCoverageEnhancer(args);
622
1028
  case "mermaid-diagram-generator":
623
1029
  return mermaidDiagramGenerator(args);
624
1030
  case "memory-context-optimizer":
@@ -629,6 +1035,17 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
629
1035
  return modelCompatibilityChecker(args);
630
1036
  case "guidelines-validator":
631
1037
  return guidelinesValidator(args);
1038
+ case "design-assistant": {
1039
+ const result = await designAssistant.processRequest(args);
1040
+ return {
1041
+ content: [
1042
+ {
1043
+ type: "text",
1044
+ text: JSON.stringify(result, null, 2),
1045
+ },
1046
+ ],
1047
+ };
1048
+ }
632
1049
  default:
633
1050
  throw new Error(`Unknown tool: ${name}`);
634
1051
  }