mcp-adr-analysis-server 2.7.24 → 2.7.26

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 (63) hide show
  1. package/README.md +1 -32
  2. package/dist/.tsbuildinfo +1 -1
  3. package/dist/src/index.d.ts +0 -4
  4. package/dist/src/index.d.ts.map +1 -1
  5. package/dist/src/index.js +0 -57
  6. package/dist/src/index.js.map +1 -1
  7. package/dist/src/tools/bootstrap-validation-loop-tool.d.ts +0 -178
  8. package/dist/src/tools/bootstrap-validation-loop-tool.d.ts.map +1 -1
  9. package/dist/src/tools/bootstrap-validation-loop-tool.js +0 -1580
  10. package/dist/src/tools/bootstrap-validation-loop-tool.js.map +1 -1
  11. package/dist/src/tools/tool-catalog.d.ts.map +1 -1
  12. package/dist/src/tools/tool-catalog.js +2 -22
  13. package/dist/src/tools/tool-catalog.js.map +1 -1
  14. package/dist/src/utils/ai-executor.d.ts +1 -1
  15. package/dist/src/utils/ai-executor.js +1 -1
  16. package/dist/src/utils/config.d.ts +0 -3
  17. package/dist/src/utils/config.d.ts.map +1 -1
  18. package/dist/src/utils/config.js +0 -13
  19. package/dist/src/utils/config.js.map +1 -1
  20. package/dist/src/utils/research-orchestrator.d.ts +0 -28
  21. package/dist/src/utils/research-orchestrator.d.ts.map +1 -1
  22. package/dist/src/utils/research-orchestrator.js +15 -252
  23. package/dist/src/utils/research-orchestrator.js.map +1 -1
  24. package/dist/src/utils/server-context-generator.d.ts.map +1 -1
  25. package/dist/src/utils/server-context-generator.js +0 -1
  26. package/dist/src/utils/server-context-generator.js.map +1 -1
  27. package/package.json +1 -3
  28. package/dist/src/tools/llm-web-search-tool.d.ts +0 -59
  29. package/dist/src/tools/llm-web-search-tool.d.ts.map +0 -1
  30. package/dist/src/tools/llm-web-search-tool.js +0 -165
  31. package/dist/src/tools/llm-web-search-tool.js.map +0 -1
  32. package/dist/src/utils/dag-executor.d.ts +0 -106
  33. package/dist/src/utils/dag-executor.d.ts.map +0 -1
  34. package/dist/src/utils/dag-executor.js +0 -453
  35. package/dist/src/utils/dag-executor.js.map +0 -1
  36. package/dist/src/utils/deployment-task-integration.d.ts +0 -260
  37. package/dist/src/utils/deployment-task-integration.d.ts.map +0 -1
  38. package/dist/src/utils/deployment-task-integration.js +0 -393
  39. package/dist/src/utils/deployment-task-integration.js.map +0 -1
  40. package/dist/src/utils/dynamic-deployment-intelligence.d.ts +0 -117
  41. package/dist/src/utils/dynamic-deployment-intelligence.d.ts.map +0 -1
  42. package/dist/src/utils/dynamic-deployment-intelligence.js +0 -445
  43. package/dist/src/utils/dynamic-deployment-intelligence.js.map +0 -1
  44. package/dist/src/utils/pattern-contribution-helper.d.ts +0 -60
  45. package/dist/src/utils/pattern-contribution-helper.d.ts.map +0 -1
  46. package/dist/src/utils/pattern-contribution-helper.js +0 -308
  47. package/dist/src/utils/pattern-contribution-helper.js.map +0 -1
  48. package/dist/src/utils/pattern-loader.d.ts +0 -183
  49. package/dist/src/utils/pattern-loader.d.ts.map +0 -1
  50. package/dist/src/utils/pattern-loader.js +0 -198
  51. package/dist/src/utils/pattern-loader.js.map +0 -1
  52. package/dist/src/utils/pattern-to-dag-converter.d.ts +0 -62
  53. package/dist/src/utils/pattern-to-dag-converter.d.ts.map +0 -1
  54. package/dist/src/utils/pattern-to-dag-converter.js +0 -265
  55. package/dist/src/utils/pattern-to-dag-converter.js.map +0 -1
  56. package/dist/src/utils/resource-extractor.d.ts +0 -57
  57. package/dist/src/utils/resource-extractor.d.ts.map +0 -1
  58. package/dist/src/utils/resource-extractor.js +0 -323
  59. package/dist/src/utils/resource-extractor.js.map +0 -1
  60. package/dist/src/utils/system-card-manager.d.ts +0 -194
  61. package/dist/src/utils/system-card-manager.d.ts.map +0 -1
  62. package/dist/src/utils/system-card-manager.js +0 -336
  63. package/dist/src/utils/system-card-manager.js.map +0 -1
package/README.md CHANGED
@@ -32,7 +32,6 @@ The **Model Context Protocol (MCP)** is an open standard that enables seamless i
32
32
  | **Tree-sitter** | An incremental parsing library that provides AST (Abstract Syntax Tree) analysis for 50+ languages. Used for semantic code understanding, extracting function signatures, and identifying architectural patterns. |
33
33
  | **Knowledge Graph** | A graph database maintained by the server that tracks relationships between ADRs, code implementations, and architectural decisions. Enables intelligent code linking and impact analysis. |
34
34
  | **Smart Code Linking** | AI-powered discovery of code files related to ADRs and architectural decisions, using keyword extraction and semantic search. |
35
- | **Firecrawl** | Web page extraction/search service used by optional research tools (`FIRECRAWL_API_KEY`). |
36
35
  | **ADR Aggregator** | Optional SaaS integration for syncing and sharing ADR context across teams (`ADR_AGGREGATOR_API_KEY`). |
37
36
 
38
37
  </details>
@@ -232,7 +231,7 @@ const relatedCode = await findRelatedCode(
232
231
  ## 🛠️ Technology Stack
233
232
 
234
233
  **Runtime:** Node.js 20+ • **Language:** TypeScript • **Framework:** MCP SDK • **Testing:** Vitest (~49% statements, enforced floor)
235
- **Search:** [ripgrep](https://github.com/BurntSushi/ripgrep) (fast recursive text search) + fast-glob (file matching) • **AI Integration:** OpenRouter.ai • **Web Research:** [Firecrawl](https://firecrawl.dev/) (web page extraction API) • **Code Analysis:** [tree-sitter](https://tree-sitter.github.io/tree-sitter/) (incremental code parser) + Smart Code Linking
234
+ **Search:** [ripgrep](https://github.com/BurntSushi/ripgrep) (fast recursive text search) + fast-glob (file matching) • **AI Integration:** OpenRouter.ai • **Code Analysis:** [tree-sitter](https://tree-sitter.github.io/tree-sitter/) (incremental code parser) + Smart Code Linking
236
235
 
237
236
  📖 **[Technical Details →](docs/explanation/server-architecture.md)** | **[CE-MCP Migration Playbook →](docs/how-to-guides/ce-mcp-migration-playbook.md)**
238
237
 
@@ -256,36 +255,6 @@ npm run test:coverage # Coverage report
256
255
 
257
256
  📖 **[Testing Guide →](docs/how-to-guides/troubleshooting.md)**
258
257
 
259
- ## 🔥 Firecrawl Integration (Optional — Skip for Getting Started)
260
-
261
- **Enhanced web research capabilities for comprehensive architectural analysis.**
262
-
263
- > **Note:** You don't need Firecrawl for basic ADR analysis. The server works fully without it. Only configure Firecrawl if you need web research features like the `perform_research` tool with external sources.
264
-
265
- <details>
266
- <summary><b>When is Firecrawl useful?</b></summary>
267
-
268
- - **ADR research** — automatically pull best practices from official docs when generating ADRs
269
- - **Technology evaluation** — compare frameworks by crawling their documentation and changelogs
270
- - **Security audits** — check CVE databases and security advisories for your dependencies
271
- - **Migration planning** — gather migration guides and breaking-change notes from upstream projects
272
-
273
- </details>
274
-
275
- ```bash
276
- # Option 1: Cloud service (recommended)
277
- export FIRECRAWL_ENABLED="true"
278
- export FIRECRAWL_API_KEY="fc-your-api-key-here"
279
-
280
- # Option 2: Self-hosted
281
- export FIRECRAWL_ENABLED="true"
282
- export FIRECRAWL_BASE_URL="http://localhost:3000"
283
-
284
- # Option 3: Disabled (default - server works without web search)
285
- ```
286
-
287
- 📖 **[Firecrawl Setup Guide →](docs/reference/environment-config.md#firecrawl-configuration)**
288
-
289
258
  ## 🌐 ADR Aggregator Integration (Optional)
290
259
 
291
260
  [ADR Aggregator](https://adraggregator.com) is a platform for cross-team ADR visibility and governance. It provides: