@vfarcic/dot-ai 0.167.0 β†’ 0.169.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.
package/README.md CHANGED
@@ -1,6 +1,5 @@
1
1
  # DevOps AI Toolkit
2
2
 
3
- <!-- docs-exclude-start -->
4
3
  <div align="center">
5
4
 
6
5
  <p align="center">
@@ -16,116 +15,37 @@
16
15
  [![GitHub stars](https://img.shields.io/github/stars/vfarcic/dot-ai.svg?style=social&label=Star)](https://github.com/vfarcic/dot-ai)
17
16
 
18
17
  </div>
19
- <!-- docs-exclude-end -->
20
18
 
21
19
  **AI-powered platform engineering and DevOps automation through intelligent Kubernetes operations and conversational workflows.**
22
20
 
23
- <!-- docs-exclude-start -->
24
- πŸ“š [Quick Start](./docs/quick-start.md) | πŸ”§ [MCP Setup](./docs/setup/mcp-setup.md) | πŸ› οΈ [Features & Tools](./docs/guides/mcp-tools-overview.md)
25
- <!-- docs-exclude-end -->
26
21
  ---
27
22
 
28
- ## What is DevOps AI Toolkit?
29
-
30
- DevOps AI Toolkit brings AI-powered intelligence to platform engineering, Kubernetes operations, and development workflows. It provides intelligent Kubernetes deployment recommendations through capability discovery and semantic matching, AI-powered issue remediation, automated repository setup with governance and security files, and shared prompt libraries for consistent development workflowsβ€”all through natural language conversation.
31
-
32
- Built on the Model Context Protocol (MCP), it integrates seamlessly with Claude Code, Cursor, and VS Code to provide conversational interaction for complex DevOps and development tasks.
33
-
34
- ![DevOps AI Toolkit Infographic](docs/img/index.jpeg)
35
-
36
- ## Mission
37
-
38
- DevOps AI Toolkit democratizes platform engineering and cloud native operations by making complex workflows accessible through AI-powered automation. We eliminate the expertise barrier that prevents teams from adopting best practices in Kubernetes operations, repository governance, and standardized development workflowsβ€”making professional-grade DevOps accessible through natural language interaction.
39
-
40
- ## Who Should Use This?
41
-
42
- **DevOps AI Toolkit is for teams who want to**:
43
- - Manage cloud resources (AWS, Azure, GCP) using Kubernetes as a control plane (developers, platform engineers)
44
- - Quickly diagnose and fix cluster and infrastructure issues (SREs, DevOps engineers)
45
- - Standardize resource provisioning with organizational patterns and policies (security engineers, platform teams)
46
- - Bootstrap repositories with governance and security files (project maintainers)
47
- - Access curated development prompts through native slash commands (development teams)
48
-
49
- ## Scope
50
-
51
- ### In Scope
52
- - AI-powered resource provisioning recommendations using Kubernetes as control plane
53
- - Intelligent issue remediation and root cause analysis
54
- - Organizational pattern and policy management with semantic search
55
- - MCP-based integration with AI coding assistants
56
- - Multi-provider AI model support (Claude, GPT, Gemini)
57
- - Project setup with governance, legal, and security files
58
-
59
- ### Out of Scope
60
- - Kubernetes cluster provisioning/management (delegates to existing tools)
61
- - CI/CD pipeline execution (provides recommendations only)
62
- - Application runtime monitoring (integrates with existing observability tools)
63
-
64
- ## Key Features
65
-
66
- ### πŸ” Resource Provisioning Intelligence
67
- Automatically discovers cluster resources using semantic capability management. AI understands what each resource actually does, providing intelligent recommendations for provisioning resources across clouds using Kubernetes as a control plane. When no matching capability exists, automatically discovers and installs third-party tools (Prometheus, Argo CD, Crossplane, etc.) via Helm charts from ArtifactHub.
68
- πŸ“– [Deployment Guide](./docs/guides/mcp-recommendation-guide.md) | [Capability Management](./docs/guides/mcp-capability-management-guide.md)
69
-
70
- ### πŸ› οΈ Issue Remediation
71
- AI-powered root cause analysis with multi-step investigation, executable remediation commands, and safety mechanisms for manual or automatic execution.
72
- πŸ“– [Learn more β†’](./docs/guides/mcp-remediate-guide.md)
73
-
74
- ### πŸ›οΈ Pattern & Policy Management
75
- Capture organizational knowledge and governance policies that automatically enhance AI recommendations with best practices and compliance requirements. Uses vector search for intelligent semantic matching.
76
- πŸ“– [Pattern Management](./docs/guides/pattern-management-guide.md) | [Policy Management](./docs/guides/policy-management-guide.md)
77
-
78
- ### πŸ“¦ Project Setup & Governance
79
- Generate 25+ governance, legal, and automation files (LICENSE, CODE_OF_CONDUCT, CONTRIBUTING, SECURITY, GitHub workflows, Renovate, OpenSSF Scorecard) for repository standardization.
80
- πŸ“– [Learn more β†’](./docs/guides/mcp-project-setup-guide.md)
81
-
82
- ### πŸ’¬ Shared Prompts Library
83
- Access curated prompts as native slash commands (`/dot-ai:prompt-name`) in your coding agent for consistent workflows across projects:
84
- - **PRD Management**: Create, track, and complete Product Requirements Documents (`prd-create`, `prd-next`, `prd-done`, etc.)
85
- - **Dockerfile Generation**: Generate production-ready, secure multi-stage Dockerfiles for any project (`generate-dockerfile`)
86
- - **CI/CD Generation**: Generate intelligent CI/CD workflows through interactive conversation (`generate-cicd`)
87
-
88
- πŸ“– [Learn more β†’](./docs/guides/mcp-prompts-guide.md)
23
+ <div align="center">
89
24
 
90
- ### ⚑ AI Integration
91
- Works with Claude Code, Cursor, VS Code via Model Context Protocol. Supports multiple AI providers (Claude, GPT, Gemini, Host LLM) for flexibility and cost optimization.
92
- πŸ“– [AI Model Configuration](./docs/setup/mcp-setup.md#ai-model-configuration)
25
+ ## [Read the Documentation](https://devopstoolkit.ai/docs/mcp/)
93
26
 
94
- ## Quick Start
27
+ </div>
95
28
 
96
- Get started in 3 steps:
97
- 1. Configure MCP server (Docker or npm)
98
- 2. Connect your AI coding assistant (Claude Code, Cursor, VS Code)
99
- 3. Start using conversational workflows
29
+ ---
100
30
 
101
- ## Documentation
31
+ ## Overview
102
32
 
103
- ### Getting Started
104
- - **[Quick Start Guide](docs/quick-start.md)** - Get started in minutes
105
- - **[MCP Setup Guide](docs/setup/mcp-setup.md)** - Complete configuration instructions
106
- - **[Tools Overview](docs/guides/mcp-tools-overview.md)** - All available tools and features
33
+ DevOps AI Toolkit brings AI-powered intelligence to platform engineering, Kubernetes operations, and development workflows. Built on the Model Context Protocol (MCP), it integrates seamlessly with Claude Code, Cursor, and VS Code.
107
34
 
108
- ### Deployment Options
109
- - **[Docker Setup](docs/setup/docker-setup.md)** - Recommended for local development
110
- - **[Kubernetes Setup](docs/setup/kubernetes-setup.md)** - Production deployment with Ingress
111
- - **[ToolHive Setup](docs/setup/kubernetes-toolhive-setup.md)** - Operator-managed deployment
112
- - **[NPX Setup](docs/setup/npx-setup.md)** - Quick trials with Node.js
35
+ **Key capabilities:**
36
+ - Intelligent Kubernetes deployment recommendations
37
+ - AI-powered issue remediation and root cause analysis
38
+ - Organizational pattern and policy management
39
+ - Automated repository setup with governance files
40
+ - Shared prompt libraries for consistent workflows
113
41
 
114
- ### Feature Guides
115
- - **[Resource Provisioning](docs/guides/mcp-recommendation-guide.md)** - AI-powered deployment recommendations
116
- - **[Capability Management](docs/guides/mcp-capability-management-guide.md)** - Semantic resource discovery
117
- - **[Issue Remediation](docs/guides/mcp-remediate-guide.md)** - AI-powered troubleshooting
118
- - **[Pattern Management](docs/guides/pattern-management-guide.md)** - Organizational deployment patterns
119
- - **[Policy Management](docs/guides/policy-management-guide.md)** - Governance and compliance
120
- - **[Project Setup](docs/guides/mcp-project-setup-guide.md)** - Repository governance automation
42
+ [Read the Documentation](https://devopstoolkit.ai/docs/mcp/)
121
43
 
122
- <!-- docs-exclude-start -->
123
44
  ## Support
124
45
 
125
46
  - **[Support Guide](SUPPORT.md)** - How to get help and where to ask questions
126
47
  - **GitHub Issues**: [Bug reports and feature requests](https://github.com/vfarcic/dot-ai/issues)
127
48
  - **GitHub Discussions**: [Community Q&A and discussions](https://github.com/vfarcic/dot-ai/discussions)
128
- - **Troubleshooting**: See [Troubleshooting Guide](./docs/setup/mcp-setup.md#troubleshooting) for common problems
129
49
 
130
50
  ## Contributing & Governance
131
51
 
@@ -142,7 +62,7 @@ We welcome contributions from the community! Please review:
142
62
 
143
63
  Your feedback shapes dot-ai's future! After using the tools, you may occasionally see a feedback prompt - we'd love to hear what's working and what could be better.
144
64
 
145
- πŸ“ **[Share your feedback](https://forms.gle/dJcDXtsxhCCwgxtT6)**
65
+ [Share your feedback](https://forms.gle/dJcDXtsxhCCwgxtT6)
146
66
 
147
67
  ## License
148
68
 
@@ -155,7 +75,6 @@ DevOps AI Toolkit is built on:
155
75
  - [Vercel AI SDK](https://sdk.vercel.ai/) for unified AI provider interface
156
76
  - [Kubernetes](https://kubernetes.io/) for the cloud native foundation
157
77
  - [CNCF](https://www.cncf.io/) for the cloud native ecosystem
158
- <!-- docs-exclude-end -->
159
78
 
160
79
  ---
161
80
 
@@ -1 +1 @@
1
- {"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/interfaces/mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAkDtC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;CACxC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAC,CAAkC;IACrD,OAAO,CAAC,aAAa,CAAC,CAAgC;IACtD,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,aAAa,CAAgB;gBAEzB,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe;IAyCjD;;OAEG;IACH,OAAO,CAAC,YAAY;IA8BpB;;OAEG;IACH,OAAO,CAAC,aAAa;IA6HrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAqCvB,OAAO,CAAC,qBAAqB;YAgBf,qBAAqB;IAyBnC,OAAO,CAAC,iBAAiB;IAInB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAkBd,mBAAmB;YAMnB,kBAAkB;YAuHlB,gBAAgB;IAexB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B,OAAO,IAAI,OAAO;CAGnB"}
1
+ {"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/interfaces/mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAkDtC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;CACxC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAC,CAAkC;IACrD,OAAO,CAAC,aAAa,CAAC,CAAgC;IACtD,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,aAAa,CAAgB;gBAEzB,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe;IAyCjD;;OAEG;IACH,OAAO,CAAC,YAAY;IA8BpB;;OAEG;IACH,OAAO,CAAC,aAAa;IA6HrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAqCvB,OAAO,CAAC,qBAAqB;YAgBf,qBAAqB;IAyBnC,OAAO,CAAC,iBAAiB;IAInB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAkBd,mBAAmB;YAMnB,kBAAkB;YA+HlB,gBAAgB;IAexB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B,OAAO,IAAI,OAAO;CAGnB"}
@@ -264,6 +264,13 @@ class MCPServer {
264
264
  endSpan(204);
265
265
  return;
266
266
  }
267
+ // Health check endpoint (unauthenticated, for Kubernetes probes)
268
+ if (req.url === '/healthz' && req.method === 'GET') {
269
+ res.writeHead(200, { 'Content-Type': 'application/json' });
270
+ res.end(JSON.stringify({ status: 'ok' }));
271
+ endSpan(200);
272
+ return;
273
+ }
267
274
  // Check Bearer token authentication (only when DOT_AI_AUTH_TOKEN is set)
268
275
  // Skip authentication for OpenAPI specification endpoint (public documentation)
269
276
  const isOpenApiEndpoint = req.url?.startsWith('/api/v1/openapi');
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vfarcic/dot-ai",
3
- "version": "0.167.0",
3
+ "version": "0.169.0",
4
4
  "description": "AI-powered development productivity platform that enhances software development workflows through intelligent automation and AI-driven assistance",
5
5
  "mcpName": "io.github.vfarcic/dot-ai",
6
6
  "main": "dist/index.js",