add go mod to tools

2025-10-20 10:17:06 +01:00
209 changed files with 1790 additions and 29001 deletions
@@ -1,31 +0,0 @@
-# EditorConfig for go-micro
-# https://editorconfig.org
-
-root = true
-
-[*]
-charset = utf-8
-end_of_line = lf
-insert_final_newline = true
-trim_trailing_whitespace = true
-
-[*.go]
-indent_style = tab
-indent_size = 4
-
-[*.{yml,yaml}]
-indent_style = space
-indent_size = 2
-
-[*.{json,proto}]
-indent_style = space
-indent_size = 2
-
-[*.md]
-trim_trailing_whitespace = false
-indent_style = space
-indent_size = 2
-
-[Makefile]
-indent_style = tab
-
@@ -1 +0,0 @@
-github: asim
@@ -1,51 +1,25 @@
 ---
 name: Bug report
-about: Create a report to help us improve
-title: '[BUG] '
-labels: bug
-assignees: ''
+about: For reporting bugs in go-micro
+title: "[BUG]"
+labels: ""
+assignees: ""
 ---

 ## Describe the bug
-A clear and concise description of what the bug is.

-## To Reproduce
-Steps to reproduce the behavior:
-1. Create service with '...'
-2. Configure plugin '...'
-3. Run command '...'
-4. See error
+1. What are you trying to do?
+2. What did you expect to happen?
+3. What happens instead?

-## Expected behavior
-A clear and concise description of what you expected to happen.
+## How to reproduce the bug

-## Code sample
-```go
-// Minimal reproducible code
-```
+If possible, please include a minimal code snippet here.

 ## Environment
- Go Micro version: [e.g. v5.3.0]
- Go version: [run `go version`]
- OS/Platform: [e.g. Ubuntu 22.04, macOS 14, Docker]
- Plugins/Integrations: [e.g. consul registry, nats broker, redis cache]

-## Logs
+Go Version: please paste `go version` output here
+
+```go
+please paste `go env` output here
 ```
-Paste relevant logs here (use -v flag for verbose output)
-```
-
-## Checklist
- [ ] I've searched existing issues and this is not a duplicate
- [ ] I've provided a minimal code sample that reproduces the issue
- [ ] I've included my environment details
- [ ] I've checked the documentation
-
-## Additional context
-Add any other context about the problem here.
-
-## Helpful Resources
- [Troubleshooting Guide](https://github.com/micro/go-micro/tree/master/internal/website/docs/getting-started.md)
- [Examples](https://github.com/micro/go-micro/tree/master/examples)
- [API Reference](https://pkg.go.dev/go-micro.dev/v5)
- [Discord Community](https://discord.gg/jwTYuUVAGh)
@@ -0,0 +1,16 @@
+---
+name: Feature request / Enhancement
+about: If you have a need not served by go-micro
+title: "[FEATURE]"
+labels: ""
+assignees: ""
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.
@@ -1,42 +0,0 @@
---
-name: Feature request
-about: Suggest an idea for this project
-title: '[FEATURE] '
-labels: enhancement
-assignees: ''
---
-
-## Is your feature request related to a problem?
-A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
-
-## Describe the solution you'd like
-A clear and concise description of what you want to happen.
-
-## Describe alternatives you've considered
-A clear and concise description of any alternative solutions or features you've considered.
-
-## Use case
-Describe how this feature would be used in practice. What problem does it solve?
-
-**Example:**
-```go
-// Show how the feature would be used
-```
-
-## Implementation ideas (optional)
-If you have thoughts on how this could be implemented, share them here.
-
-## Additional context
-Add any other context, code examples, or screenshots about the feature request here.
-
-## Checklist
- [ ] I've searched existing issues and this is not a duplicate
- [ ] I've checked the roadmap and this isn't already planned
- [ ] I've provided a clear use case
- [ ] I'd be willing to submit a PR for this feature (optional)
-
-## Helpful Resources
- [Roadmap](https://github.com/micro/go-micro/blob/master/ROADMAP.md)
- [Contributing Guide](https://github.com/micro/go-micro/blob/master/CONTRIBUTING.md)
- [Architecture Docs](https://github.com/micro/go-micro/tree/master/internal/website/docs/architecture.md)
- [Discord Community](https://discord.gg/jwTYuUVAGh)
@@ -1,61 +0,0 @@
---
-name: Performance issue
-about: Report a performance problem or regression
-title: '[PERFORMANCE] '
-labels: performance
-assignees: ''
---
-
-## Performance Issue
-
-**Symptom:**
-Describe the performance problem (e.g., high latency, memory leak, CPU usage)
-
-**Expected Performance:**
-What performance did you expect?
-
-## Benchmarks
-
-Please provide benchmarks or profiling data:
-
-```bash
-# CPU profiling
-go test -cpuprofile=cpu.prof -bench=.
-
-# Memory profiling
-go test -memprofile=mem.prof -bench=.
-
-# Results
-```
-
-**Before/After comparison (if applicable):**
- Before: X req/sec, Y ms latency
- After: X req/sec, Y ms latency
-
-## Code Sample
-
-```go
-// Minimal code that demonstrates the performance issue
-```
-
-## Environment
- Go Micro version: [e.g. v5.3.0]
- Go version: [run `go version`]
- Hardware: [e.g. 4 CPU, 8GB RAM]
- OS: [e.g. Ubuntu 22.04]
- Load: [e.g. 1000 req/sec, 100 concurrent connections]
-
-## Profiling Data
-
-Attach pprof profiles if available:
- CPU profile
- Memory profile
- Goroutine dump
-
-## Additional Context
-
-Add any other context about the performance issue.
-
-## Resources
- [Performance Guide](https://github.com/micro/go-micro/tree/master/internal/website/docs/performance.md)
- [Benchmarking](https://pkg.go.dev/testing#hdr-Benchmarks)
@@ -1,31 +1,13 @@
 ---
 name: Question
-about: Ask a question about using Go Micro
-title: '[QUESTION] '
-labels: question
-assignees: ''
+about: Ask a question about go-micro
+title: ""
+labels: ""
+assignees: ""
 ---

-## Your question
-A clear and concise question about Go Micro usage.
+Before asking, please check if your question has already been answered:

-## What have you tried?
-Describe what you've already attempted or researched.
-
-## Code sample (if applicable)
-```go
-// Your code here
-```
-
-## Context
-Provide any additional context that might help answer your question.
-
-## Resources you've checked
- [ ] [Getting Started Guide](https://github.com/micro/go-micro/tree/master/internal/website/docs/getting-started.md)
- [ ] [Examples](https://github.com/micro/go-micro/tree/master/internal/website/docs/examples)
- [ ] [API Documentation](https://pkg.go.dev/go-micro.dev/v5)
- [ ] Searched existing issues
-
-## Helpful links
- [Documentation](https://github.com/micro/go-micro/tree/master/internal/website/docs)
- [Plugins Guide](https://github.com/micro/go-micro/tree/master/internal/website/docs/plugins.md)
+1. Check the documentation - https://micro.mu/docs/
+2. Check the examples and plugins - https://github.com/micro/examples & https://github.com/micro/go-plugins
+3. Search existing issues
@@ -0,0 +1,11 @@
+# Pull Request template
+
+Please, go through these steps before clicking submit on this PR.
+
+1. Make sure this PR targets the `develop` branch. We follow the git-flow branching model.
+2. Give a descriptive title to your PR.
+3. Provide a description of your changes.
+4. Make sure you have some relevant tests.
+5. Put `closes #XXXX` in your comment to auto-close the issue that your PR fixes (if applicable).
+
+## PLEASE REMOVE THIS TEMPLATE BEFORE SUBMITTING
@@ -31,44 +31,3 @@ jobs:
        env:
          IN_TRAVIS_CI: yes
          RICHGO_FORCE_COLOR: 1
-  
-  etcd-integration:
-    name: Etcd Integration Tests
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-    services:
-      etcd:
-        image: quay.io/coreos/etcd:v3.5.2
-        env:
-          ETCD_LISTEN_CLIENT_URLS: http://0.0.0.0:2379
-          ETCD_ADVERTISE_CLIENT_URLS: http://0.0.0.0:2379
-        ports:
-          - 2379:2379
-        options: >-
-          --health-cmd "etcdctl endpoint health"
-          --health-interval 10s
-          --health-timeout 5s
-          --health-retries 5
-    steps:
-      - uses: actions/checkout@v3
-      - name: Set up Go
-        uses: actions/setup-go@v3
-        with:
-          go-version: 1.24
-          check-latest: true
-          cache: true
-      - name: Get dependencies
-        run: |
-          go install github.com/kyoh86/richgo@latest
-          go get -v -t -d ./...
-      - name: Wait for etcd
-        run: |
-          timeout 30 bash -c 'until curl -s http://localhost:2379/health; do sleep 1; done'
-      - name: Run etcd integration tests
-        run: richgo test -v -race ./registry/etcd/...
-        env:
-          ETCD_ADDRESS: localhost:2379
-          IN_TRAVIS_CI: yes
-          RICHGO_FORCE_COLOR: 1
-
@@ -1,11 +1,8 @@
 # Develop tools
+/.vscode/
 /.idea/
 /.trunk

-# VS Code workspace files (keep settings for consistency)
-/.vscode/*
-!/.vscode/settings.json
-
 # Binaries for programs and plugins
 *.exe
 *.exe~
@@ -33,7 +30,6 @@ _cgo_export.*

 # Output of the go coverage tool, specifically when used with LiteIDE
 *.out
-coverage.html

 # vim temp files
 *~
@@ -43,17 +39,3 @@ coverage.html
 # go work files
 go.work
 go.work.sum
-
-# Build artifacts
-dist/
-bin/
-
-# Example binaries (go build in examples/)
-examples/**/server/server
-examples/**/client/client
-examples/mcp/documented/documented
-examples/mcp/hello/hello
-
-# IDE-specific files
-.DS_Store
-/micro
@@ -0,0 +1,29 @@
+labelType: long
+coverThreshold: 70
+buildStyle:
+  bold: true
+  foreground: yellow
+startStyle:
+  foreground: lightBlack
+passStyle:
+  foreground: green
+failStyle:
+  bold: true
+  foreground: "#821515"
+skipStyle:
+  foreground: lightBlack
+passPackageStyle:
+  foreground: green
+  hide: false
+failPackageStyle:
+  bold: true
+  foreground: "#821515"
+coveredStyle:
+  foreground: green
+uncoveredStyle:
+  bold: true
+  foreground: yellow
+fileStyle:
+  foreground: cyan
+lineStyle:
+  foreground: magenta
@@ -1,137 +0,0 @@
-{
-  "folders": [
-    {
-      "path": "."
-    }
-  ],
-  "settings": {
-    "go.toolsManagement.autoUpdate": true,
-    "go.useLanguageServer": true,
-    "go.lintOnSave": "workspace",
-    "go.lintTool": "golangci-lint",
-    "go.lintFlags": [
-      "--fast"
-    ],
-    "go.formatTool": "goimports",
-    "go.formatFlags": [],
-    "go.buildOnSave": "workspace",
-    "go.testOnSave": false,
-    "go.coverOnSave": false,
-    "go.testFlags": ["-v", "-race"],
-    "go.testTimeout": "60s",
-    "go.gopath": "",
-    "go.goroot": "",
-    "editor.formatOnSave": true,
-    "editor.codeActionsOnSave": {
-      "source.organizeImports": "explicit"
-    },
-    "files.exclude": {
-      "**/.git": true,
-      "**/.DS_Store": true,
-      "**/node_modules": true,
-      "**/*.test": true,
-      "**/coverage.out": true,
-      "**/coverage.html": true
-    },
-    "files.watcherExclude": {
-      "**/.git/objects/**": true,
-      "**/.git/subtree-cache/**": true,
-      "**/node_modules/**": true,
-      "**/.vscode/**": true
-    },
-    "search.exclude": {
-      "**/node_modules": true,
-      "**/bower_components": true,
-      "**/*.code-search": true,
-      "**/vendor": true,
-      "**/.git": true
-    },
-    "[go]": {
-      "editor.tabSize": 4,
-      "editor.insertSpaces": false,
-      "editor.formatOnSave": true,
-      "editor.defaultFormatter": "golang.go"
-    },
-    "[go.mod]": {
-      "editor.formatOnSave": true,
-      "editor.defaultFormatter": "golang.go"
-    },
-    "[markdown]": {
-      "editor.formatOnSave": false,
-      "editor.wordWrap": "on"
-    },
-    "gopls": {
-      "ui.semanticTokens": true,
-      "ui.completion.usePlaceholders": true,
-      "formatting.gofumpt": false,
-      "analyses": {
-        "unusedparams": true,
-        "shadow": true,
-        "fieldalignment": false
-      }
-    }
-  },
-  "extensions": {
-    "recommendations": [
-      "golang.go",
-      "editorconfig.editorconfig",
-      "redhat.vscode-yaml",
-      "ms-vscode.makefile-tools"
-    ]
-  },
-  "tasks": {
-    "version": "2.0.0",
-    "tasks": [
-      {
-        "label": "Run Tests",
-        "type": "shell",
-        "command": "make test",
-        "group": {
-          "kind": "test",
-          "isDefault": true
-        },
-        "presentation": {
-          "reveal": "always",
-          "panel": "new"
-        }
-      },
-      {
-        "label": "Run Tests with Coverage",
-        "type": "shell",
-        "command": "make test-coverage",
-        "group": "test"
-      },
-      {
-        "label": "Run Linter",
-        "type": "shell",
-        "command": "make lint",
-        "group": "build"
-      },
-      {
-        "label": "Format Code",
-        "type": "shell",
-        "command": "make fmt",
-        "group": "build"
-      }
-    ]
-  },
-  "launch": {
-    "version": "0.2.0",
-    "configurations": [
-      {
-        "name": "Debug Current File",
-        "type": "go",
-        "request": "launch",
-        "mode": "debug",
-        "program": "${file}"
-      },
-      {
-        "name": "Debug Test",
-        "type": "go",
-        "request": "launch",
-        "mode": "test",
-        "program": "${workspaceFolder}"
-      }
-    ]
-  }
-}
@@ -1,219 +0,0 @@
-# Contributing to Go Micro
-
-Thank you for your interest in contributing to Go Micro! This document provides guidelines and instructions for contributing.
-
-## Code of Conduct
-
-Be respectful, inclusive, and collaborative. We're all here to build great software together.
-
-## Getting Started
-
-1. Fork the repository
-2. Clone your fork: `git clone https://github.com/YOUR_USERNAME/go-micro.git`
-3. Add upstream remote: `git remote add upstream https://github.com/micro/go-micro.git`
-4. Create a feature branch: `git checkout -b feature/my-feature`
-
-## Development Setup
-
-```bash
-# Install dependencies
-go mod download
-
-# Install development tools
-make install-tools
-
-# Run tests
-make test
-
-# Run tests with race detector and coverage
-make test-coverage
-
-# Run linter
-make lint
-
-# Format code
-make fmt
-```
-
-See `make help` for all available commands.
-
-## Making Changes
-
-### Code Guidelines
-
- Follow standard Go conventions (use `gofmt`, `golint`)
- Write clear, descriptive commit messages
- Add tests for new functionality
- Update documentation for API changes
- Keep PRs focused - one feature/fix per PR
-
-### Commit Messages
-
-Use conventional commits format:
-
-```
-type(scope): subject
-
-body
-
-footer
-```
-
-Types:
- `feat`: New feature
- `fix`: Bug fix
- `docs`: Documentation changes
- `test`: Test additions/changes
- `refactor`: Code refactoring
- `perf`: Performance improvements
- `chore`: Maintenance tasks
-
-Examples:
-```
-feat(registry): add kubernetes registry plugin
-fix(broker): resolve nats connection leak
-docs(examples): add streaming example
-```
-
-### Testing
-
- Write unit tests for all new code
- Ensure existing tests pass
- Add integration tests for plugin implementations
- Test with multiple Go versions (1.20+)
-
-```bash
-# Run specific package tests
-go test ./registry/...
-
-# Run with verbose output
-go test -v ./...
-
-# Run specific test
-go test -run TestMyFunction ./pkg/...
-
-# Optional: Use richgo for colored output
-go install github.com/kyoh86/richgo@latest
-richgo test -v ./...
-```
-
-### Documentation
-
- Update relevant markdown files in `internal/website/docs/`
- Add examples to `internal/website/docs/examples/` for new features
- Update README.md for major features
- Add godoc comments for exported functions/types
-
-## Pull Request Process
-
-1. **Update your branch**
-   ```bash
-   git fetch upstream
-   git rebase upstream/master
-   ```
-
-2. **Run tests and linting**
-   ```bash
-   go test ./...
-   golangci-lint run
-   ```
-
-3. **Push to your fork**
-   ```bash
-   git push origin feature/my-feature
-   ```
-
-4. **Create Pull Request**
-   - Use a descriptive title
-   - Reference any related issues
-   - Describe what changed and why
-   - Add screenshots for UI changes
-   - Mark as draft if work in progress
-
-5. **PR Review**
-   - Respond to feedback promptly
-   - Make requested changes
-   - Re-request review after updates
-
-### PR Checklist
-
- [ ] Tests pass locally
- [ ] Code follows Go conventions
- [ ] Documentation updated
- [ ] Commit messages are clear
- [ ] Branch is up to date with master
- [ ] No merge conflicts
-
-## Adding Plugins
-
-New plugins should:
-
-1. Live in the appropriate interface directory (e.g., `registry/myplugin/`)
-2. Implement the interface completely
-3. Include comprehensive tests
-4. Provide usage examples
-5. Document configuration options (env vars, options)
-6. Add to plugin documentation
-
-Example structure:
-```
-registry/myplugin/
-├── myplugin.go          # Main implementation
-├── myplugin_test.go     # Tests
-├── options.go           # Plugin-specific options
-└── README.md            # Usage and configuration
-```
-
-## Reporting Issues
-
-Before creating an issue:
-
-1. Search existing issues
-2. Check documentation
-3. Try the latest version
-
-When reporting bugs:
- Use the bug report template
- Include minimal reproduction code
- Specify versions (Go, Go Micro, plugins)
- Provide relevant logs
-
-## Documentation Contributions
-
-Documentation improvements are always welcome!
-
- Fix typos and grammar
- Improve clarity
- Add missing examples
- Update outdated information
-
-Documentation lives in `internal/website/docs/`. Preview locally with Jekyll:
-
-```bash
-cd internal/website
-bundle install
-bundle exec jekyll serve --livereload
-```
-
-## Community
-
- GitHub Issues: Bug reports and feature requests
- GitHub Discussions: Questions, ideas, and community chat
- Sponsorship: [GitHub Sponsors](https://github.com/sponsors/micro)
-
-## Release Process
-
-Maintainers handle releases:
-
-1. Update CHANGELOG.md
-2. Tag release: `git tag -a v5.x.x -m "Release v5.x.x"`
-3. Push tag: `git push origin v5.x.x`
-4. GitHub Actions creates release
-
-## Questions?
-
- Check [documentation](internal/website/docs/)
- Browse [examples](internal/website/docs/examples/)
- Open a [question issue](.github/ISSUE_TEMPLATE/question.md)
-
-Thank you for contributing to Go Micro! 🎉
@@ -1,282 +0,0 @@
-# Go Micro - Current Status Summary
-**Updated:** February 11, 2026
-
-## 🎯 Executive Summary
-
-**Go Micro's MCP integration is 3-4 months ahead of schedule**, with Q1 2026 goals complete and significant Q2/Q3 2026 features already delivered.
-
-### Quick Status
- ✅ **Q1 2026 (MCP Foundation):** 100% COMPLETE
- 🟢 **Q2 2026 (Agent DX):** 60% COMPLETE (ahead of schedule)
- 🟢 **Q3 2026 (Production):** 40% COMPLETE (ahead of schedule)
- 🟡 **Q4 2026 (Ecosystem):** 0% COMPLETE (on track)
-
---
-
-## 📊 What's Been Built
-
-### ✅ Core MCP Integration (Q1 - COMPLETE)
- **MCP Gateway Library** (`gateway/mcp/`) - 2,083 lines
-  - HTTP/SSE transport
-  - Stdio JSON-RPC 2.0 transport
-  - Service discovery & tool generation
-  - Schema generation from Go types
-  
- **CLI Commands** (`micro mcp`)
-  - `micro mcp serve` - Start MCP server (stdio or HTTP)
-  - `micro mcp list` - List available tools
-  - `micro mcp test` - Test tools (placeholder)
-
- **Documentation**
-  - Complete API documentation
-  - 2 working examples (hello, documented)
-  - Blog post: "Making Microservices AI-Native with MCP"
-
-### ✅ Advanced Features (Q2/Q3 - DELIVERED EARLY)
-
-#### 🔒 Security & Auth
- **Per-Tool Scopes**
-  - Service-level: `server.WithEndpointScopes("Blog.Create", "blog:write")`
-  - Gateway-level: `Options.Scopes` map for overrides
-  - Bearer token authentication
-  - Scope enforcement before RPC execution
-
-#### 📊 Observability
- **Tracing**
-  - UUID trace IDs per tool call
-  - Metadata propagation (`Mcp-Trace-Id`, `Mcp-Tool-Name`, `Mcp-Account-Id`)
-  - Full call chain tracking
-
- **Audit Logging**
-  - Immutable audit records per tool call
-  - Captures: tool, account, scopes, allowed/denied, duration, errors
-  - Callback function: `Options.AuditFunc`
-
-#### 🚦 Rate Limiting
- Per-tool rate limiters
- Configurable requests/second and burst
- Token bucket algorithm
-
-#### 📝 Documentation Extraction
- Auto-extract from Go doc comments
- `@example` tag support for JSON examples
- Struct tag parsing for parameter descriptions
- Manual override via `WithEndpointDocs()`
-
---
-
-## 🚀 What Works Today
-
-### For Claude Code Users
-```bash
-# Start MCP server for Claude Code
-micro mcp serve
-
-# Add to ~/.claude/claude_desktop_config.json:
-{
-  "mcpServers": {
-    "my-services": {
-      "command": "micro",
-      "args": ["mcp", "serve"]
-    }
-  }
-}
-```
-
-### For Library Users
-```go
-package main
-
-import (
-    "go-micro.dev/v5"
-    "go-micro.dev/v5/gateway/mcp"
-)
-
-func main() {
-    service := micro.NewService(micro.Name("myservice"))
-    service.Init()
-
-    // Add MCP gateway (3 lines!)
-    go mcp.ListenAndServe(":3000", mcp.Options{
-        Registry: service.Options().Registry,
-        Auth:     authProvider,  // Optional: auth.Auth
-        Scopes: map[string][]string{  // Optional: per-tool scopes
-            "myservice.Handler.Create": {"write"},
-        },
-        RateLimit: &mcp.RateLimitConfig{  // Optional
-            RequestsPerSecond: 10,
-            Burst:             20,
-        },
-        AuditFunc: func(r mcp.AuditRecord) {  // Optional
-            log.Printf("[audit] %+v", r)
-        },
-    })
-
-    service.Run()
-}
-```
-
-### For Service Developers
-```go
-// Just add Go comments - docs extracted automatically!
-
-// GetUser retrieves a user by ID. Returns full profile with email and preferences.
-//
-// @example {"id": "user-123"}
-func (s *UserService) GetUser(ctx context.Context, req *GetUserRequest, rsp *GetUserResponse) error {
-    // implementation
-}
-
-// Register with scopes
-handler := service.Server().NewHandler(
-    new(UserService),
-    server.WithEndpointScopes("UserService.Delete", "users:admin"),
-)
-```
-
---
-
-## 📈 Test Coverage
-
-**568 lines** of comprehensive tests covering:
- ✅ Scope validation & enforcement
- ✅ Auth provider integration
- ✅ Trace ID generation & propagation
- ✅ Audit record creation
- ✅ Rate limiting
- ✅ HTTP & Stdio transports
- ✅ Tool discovery & schema generation
-
---
-
-## 🎯 What's Next (Recommended Priorities)
-
-### Immediate (Next 2 Weeks)
-1. **Complete `micro mcp test` command** (~1 day)
-   - Implement actual tool testing with JSON input/output
-   
-2. **LangChain SDK** (~1 week)
-   - Python package: `go-micro-langchain`
-   - Auto-generate LangChain tools from registry
-   - Example multi-agent workflow
-   - **Impact:** Largest agent framework integration
-
-3. **Interactive Playground** (~1 week)
-   - Web UI for testing services with AI
-   - Real-time tool call visualization
-   - **Impact:** Critical for demos and sales
-
-### Short-Term (Next Month)
-4. **WebSocket Transport** (~3 days)
-   - Bidirectional streaming for long-running operations
-   
-5. **LlamaIndex SDK** (~1 week)
-   - Python package for RAG integration
-   
-6. **Case Studies** (ongoing)
-   - Document real-world usage
-
---
-
-## 📊 By The Numbers
-
-| Metric | Value |
-|--------|-------|
-| **Production Code** | 2,083 lines |
-| **Test Code** | 568 lines |
-| **Documentation Files** | 4+ |
-| **Working Examples** | 2 |
-| **CLI Commands** | 3 |
-| **Transports** | 2 (HTTP/SSE, Stdio) |
-| **Q1 Completion** | 100% |
-| **Ahead of Schedule** | 3-4 months |
-
---
-
-## 🔍 Where We Are on the Roadmap
-
-### Q1 2026: MCP Foundation
-**Status:** ✅ COMPLETE (100%)
- All 6 planned deliverables complete
- Production-ready implementation
- Comprehensive documentation
-
-### Q2 2026: Agent Developer Experience  
-**Status:** 🟢 IN PROGRESS (60% complete)
-
-**COMPLETED (ahead of schedule):**
- ✅ Stdio transport for Claude Code
- ✅ `micro mcp serve` and `list` commands
- ✅ Tool descriptions from comments
- ✅ `@example` tag support
- ✅ Schema generation from struct tags
- ✅ HTTP/SSE with auth
-
-**NOT YET STARTED:**
- ❌ `micro mcp test` (full implementation)
- ❌ `micro mcp docs` and `export` commands
- ❌ Agent SDKs (LangChain, LlamaIndex, AutoGPT)
- ❌ Interactive Agent Playground
- ❌ Multi-protocol (WebSocket, gRPC, HTTP/3)
-
-### Q3 2026: Production & Scale
-**Status:** 🟢 IN PROGRESS (40% complete)
-
-**COMPLETED (ahead of schedule):**
- ✅ Per-tool authentication & scopes
- ✅ Agent call tracing
- ✅ Rate limiting
- ✅ Audit logging
- ✅ Bearer token auth
-
-**NOT YET STARTED:**
- ❌ Standalone MCP Gateway binary
- ❌ Kubernetes Operator
- ❌ Helm Charts
- ❌ OpenTelemetry integration
- ❌ Full observability dashboards
-
-### Q4 2026: Ecosystem & Monetization
-**Status:** 🟡 PLANNING (0% complete)
- All features planned for Q4 2026
- On track to start in Q4
-
---
-
-## 📖 Key Documents
-
-1. **[PROJECT_STATUS_2026.md](./PROJECT_STATUS_2026.md)** - Comprehensive 20-page status report
-2. **[ROADMAP_2026.md](./ROADMAP_2026.md)** - Updated roadmap with completion markers
-3. **[/gateway/mcp/DOCUMENTATION.md](./gateway/mcp/DOCUMENTATION.md)** - Complete MCP documentation
-4. **[/examples/mcp/README.md](./examples/mcp/README.md)** - Examples and usage guide
-5. **[/internal/website/blog/2.md](./internal/website/blog/2.md)** - Launch blog post
-
---
-
-## 🎉 Key Achievements
-
-1. **✅ Production-Ready in Q1** - Ahead of schedule
-2. **✅ Security-First** - Auth, scopes, audit from day one
-3. **✅ Developer-Friendly** - 3 lines of code to enable MCP
-4. **✅ Claude Code Ready** - Works with Anthropic's flagship IDE
-5. **✅ Comprehensive Testing** - 90%+ test coverage
-6. **✅ Well-Documented** - Multiple docs + examples + blog post
-
---
-
-## 💡 Bottom Line
-
-**Go Micro is production-ready for AI agent integration TODAY.**
-
-The Q1 2026 foundation is solid, with advanced Q2/Q3 features already delivered. The framework is:
- ✅ Ready for production use
- ✅ Secure by default
- ✅ Easy to use (3 lines of code)
- ✅ Well-tested and documented
- ✅ Compatible with Claude Code and other AI tools
-
-**Next focus:** Agent SDKs and developer tools to drive adoption.
-
---
-
-**For detailed technical analysis, see [PROJECT_STATUS_2026.md](./PROJECT_STATUS_2026.md)**
@@ -1,58 +0,0 @@
-.PHONY: test test-race test-coverage lint fmt install-tools proto clean help
-
-# Default target
-help:
-	@echo "Go Micro Development Tasks"
-	@echo ""
-	@echo "  make test          - Run tests"
-	@echo "  make test-race     - Run tests with race detector"
-	@echo "  make test-coverage - Run tests with coverage"
-	@echo "  make lint          - Run linter"
-	@echo "  make fmt           - Format code"
-	@echo "  make install-tools - Install development tools"
-	@echo "  make proto         - Generate protobuf code"
-	@echo "  make clean         - Clean build artifacts"
-
-# Run tests
-test:
-	go test -v ./...
-
-# Run tests with race detector
-test-race:
-	go test -v -race ./...
-
-# Run tests with coverage
-test-coverage:
-	go test -v -race -coverprofile=coverage.out -covermode=atomic ./...
-	go tool cover -html=coverage.out -o coverage.html
-	@echo "Coverage report: coverage.html"
-
-# Run linter
-lint:
-	golangci-lint run
-
-# Format code
-fmt:
-	gofmt -s -w .
-	goimports -w .
-
-# Install development tools
-install-tools:
-	@echo "Installing development tools..."
-	go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest
-	go install golang.org/x/tools/cmd/goimports@latest
-	go install github.com/kyoh86/richgo@latest
-	go install go-micro.dev/v5/cmd/protoc-gen-micro@latest
-	@echo "Tools installed successfully"
-
-# Generate protobuf code
-proto:
-	@echo "Generating protobuf code..."
-	find . -name "*.proto" -not -path "./vendor/*" -exec protoc --proto_path=. --micro_out=. --go_out=. {} \;
-
-# Clean build artifacts
-clean:
-	rm -f coverage.out coverage.html
-	find . -name "*.test" -type f -delete
-	go clean -cache -testcache
-
@@ -1,727 +0,0 @@
-# Go Micro Project Status - February 2026
-## MCP Integration and Tool Scopes Implementation
-
-**Date:** February 11, 2026  
-**Analysis Period:** Q1 2026 Roadmap Items + Recent Commits  
-**Focus Areas:** MCP Integration, Tool Scopes, CLI Integration
-
---
-
-## Executive Summary
-
-The **Q1 2026: MCP Foundation** milestone is **COMPLETE** with significant progress beyond the original roadmap. The implementation includes not only the planned Q1 features but also several Q2 2026 features, particularly around **tool scopes**, **authentication**, **tracing**, and **rate limiting**.
-
-### Status at a Glance
-
-| Category | Status | Completion |
-|----------|--------|------------|
-| **Q1 2026: MCP Foundation** | ✅ COMPLETE | 100% |
-| **Tool Scopes (Q2 Feature)** | ✅ COMPLETE | 100% |
-| **Stdio Transport (Q2 Feature)** | ✅ COMPLETE | 100% |
-| **CLI Integration** | ✅ COMPLETE | 100% |
-| **Documentation Extraction** | ✅ COMPLETE | 100% |
-| **Tracing & Audit** | ✅ COMPLETE | 100% |
-| **Rate Limiting** | ✅ COMPLETE | 100% |
-
---
-
-## Q1 2026: MCP Foundation - COMPLETE ✅
-
-All planned Q1 2026 deliverables have been completed:
-
-### ✅ MCP Library (`gateway/mcp`)
- **Status:** COMPLETE
- **Location:** `/gateway/mcp/`
- **Files:**
-  - `mcp.go` (630 lines) - Core MCP gateway implementation
-  - `stdio.go` (369 lines) - Stdio JSON-RPC 2.0 transport
-  - `parser.go` (339 lines) - Documentation extraction
-  - `ratelimit.go` (51 lines) - Rate limiting
-  - `mcp_test.go` (568 lines) - Comprehensive test suite
-  - `example_test.go` (126 lines) - Usage examples
-  - `DOCUMENTATION.md` - Complete documentation
-
-**Features Implemented:**
- Service discovery from registry
- Automatic tool generation from endpoints
- HTTP/SSE transport
- Stdio transport (JSON-RPC 2.0)
- Authentication with auth.Auth integration
- Per-tool scope enforcement
- Trace ID generation and propagation
- Rate limiting (configurable per-tool)
- Audit logging with AuditFunc callback
- Schema generation from Go types
-
-### ✅ CLI Integration (`micro mcp`)
- **Status:** COMPLETE
- **Location:** `/cmd/micro/mcp/mcp.go`
- **Commands Implemented:**
-  - `micro mcp serve` - Start MCP server (stdio or HTTP)
-  - `micro mcp serve --address :3000` - HTTP/SSE mode
-  - `micro mcp list` - List available tools
-  - `micro mcp test <tool>` - Test tool (placeholder)
-
-**CLI Features:**
- Registry integration (mdns default)
- Graceful shutdown handling
- JSON output support for `list` command
- Human-readable output
-
-### ✅ Service Discovery and Tool Generation
- **Status:** COMPLETE
- **Implementation:**
-  - Automatic service discovery via registry
-  - Tools generated from endpoint metadata
-  - Dynamic tool updates via registry watcher
-  - Support for service metadata extraction
-
-### ✅ HTTP/SSE Transport
- **Status:** COMPLETE
- **Endpoints:**
-  - `GET /mcp/tools` - List available tools
-  - `POST /mcp/call` - Call a tool
-  - `GET /health` - Health check
- **Features:**
-  - Server-Sent Events (SSE) ready
-  - Authentication via Bearer tokens
-  - Trace ID generation
-  - Audit logging
-
-### ✅ Documentation and Examples
- **Status:** COMPLETE
- **Documentation:**
-  - `/gateway/mcp/DOCUMENTATION.md` - Complete MCP documentation
-  - `/examples/mcp/README.md` - Examples with usage guide
-  - `/internal/website/docs/mcp.md` - Website documentation
-  - `/internal/website/docs/roadmap-2026.md` - Updated roadmap
- **Examples:**
-  - `/examples/mcp/hello/` - Minimal example
-  - `/examples/mcp/documented/` - Full-featured example with auth scopes
-
-### ✅ Blog Post and Launch
- **Status:** COMPLETE
- **Location:** `/internal/website/blog/2.md`
- **Title:** "Making Microservices AI-Native with MCP"
- **Published:** February 11, 2026
-
---
-
-## Beyond Q1: Advanced Features Already Implemented
-
-### ✅ Per-Tool Auth Scopes (Q2 2026 Feature)
-
-**Status:** COMPLETE (ahead of schedule)
-
-This was planned for Q2 2026 but has been fully implemented:
-
-#### Implementation Details:
-
-1. **Service-Level Scopes** via `server.WithEndpointScopes()`
-   ```go
-   handler := service.Server().NewHandler(
-       new(BlogService),
-       server.WithEndpointScopes("Blog.Create", "blog:write"),
-       server.WithEndpointScopes("Blog.Delete", "blog:admin"),
-   )
-   ```
-
-2. **Gateway-Level Scope Overrides** via `mcp.Options.Scopes`
-   ```go
-   mcp.Serve(mcp.Options{
-       Registry: reg,
-       Auth:     authProvider,
-       Scopes: map[string][]string{
-           "blog.Blog.Create": {"blog:write"},
-           "blog.Blog.Delete": {"blog:admin"},
-       },
-   })
-   ```
-
-3. **Auth Integration:**
-   - `Options.Auth` field for auth.Auth provider
-   - Bearer token inspection
-   - Account scope validation
-   - Scope enforcement before RPC execution
-
-4. **Metadata Storage:**
-   - Scopes stored in endpoint metadata (`"scopes"` key)
-   - Comma-separated values propagated via registry
-   - Gateway-level scopes take precedence
-
-**Test Coverage:**
- `TestHasScope` - Scope matching logic
- `TestToolScopesFromMetadata` - Scope extraction
- `TestHandleCallTool_AuthRequired` - Auth enforcement
- `TestHandleCallTool_Audit_Allowed` - Audit with auth
- `TestHandleCallTool_Audit_Denied` - Audit denied calls
-
-### ✅ Stdio Transport for Claude Code (Q2 2026 Feature)
-
-**Status:** COMPLETE (ahead of schedule)
-
-This was planned for Q2 2026 but has been fully implemented:
-
-#### Implementation Details:
-
-1. **JSON-RPC 2.0 Protocol:**
-   - Full JSON-RPC 2.0 compliance
-   - Standard error codes (ParseError, InvalidRequest, etc.)
-   - Request/response ID tracking
-
-2. **MCP Methods Supported:**
-   - `initialize` - Protocol handshake
-   - `tools/list` - List available tools
-   - `tools/call` - Execute a tool
-
-3. **Transport Features:**
-   - Stdin/stdout communication
-   - Line-buffered JSON
-   - Concurrent request handling
-   - Graceful shutdown
-
-4. **CLI Integration:**
-   ```bash
-   # For Claude Code
-   micro mcp serve
-   
-   # Claude Code config
-   {
-     "mcpServers": {
-       "my-services": {
-         "command": "micro",
-         "args": ["mcp", "serve"]
-       }
-     }
-   }
-   ```
-
-### ✅ Tool Documentation from Comments (Q2 2026 Feature)
-
-**Status:** COMPLETE (ahead of schedule)
-
-This was planned for Q2 2026 but has been fully implemented:
-
-#### Implementation Details:
-
-1. **Automatic Extraction:**
-   - Go doc comments → Tool descriptions
-   - `@example` tags → Example JSON inputs
-   - Struct tags → Parameter descriptions
-
-2. **Parser Features (`parser.go`):**
-   - Comment parsing on handler registration
-   - Example extraction with `@example` tag
-   - Metadata propagation via registry
-
-3. **Example:**
-   ```go
-   // GetUser retrieves a user by ID. Returns full profile.
-   //
-   // @example {"id": "user-123"}
-   func (s *UserService) GetUser(ctx context.Context, req *GetUserRequest, rsp *GetUserResponse) error {
-       // implementation
-   }
-   ```
-
-4. **Manual Override Support:**
-   ```go
-   server.WithEndpointDocs(map[string]server.EndpointDoc{
-       "UserService.GetUser": {
-           Description: "Custom description",
-           Example:     `{"id": "user-123"}`,
-       },
-   })
-   ```
-
-### ✅ Tracing (Q3 2026 Feature)
-
-**Status:** COMPLETE (ahead of schedule)
-
-This was planned for Q3 2026 but has been fully implemented:
-
-#### Implementation Details:
-
-1. **Trace ID Generation:**
-   - UUID-based trace IDs
-   - Generated per tool call
-   - Propagated via metadata
-
-2. **Metadata Propagation:**
-   - `Mcp-Trace-Id` - Trace identifier
-   - `Mcp-Tool-Name` - Tool being invoked
-   - `Mcp-Account-Id` - Authenticated account
-
-3. **Context Injection:**
-   - Trace metadata added to RPC context
-   - Accessible to downstream services
-   - Full call chain tracking
-
-### ✅ Rate Limiting (Q3 2026 Feature)
-
-**Status:** COMPLETE (ahead of schedule)
-
-This was planned for Q3 2026 but has been fully implemented:
-
-#### Implementation Details:
-
-1. **Configuration:**
-   ```go
-   mcp.Serve(mcp.Options{
-       Registry: reg,
-       RateLimit: &mcp.RateLimitConfig{
-           RequestsPerSecond: 10,
-           Burst:             20,
-       },
-   })
-   ```
-
-2. **Implementation:**
-   - Per-tool rate limiters
-   - Token bucket algorithm
-   - Configurable requests/second and burst
-   - 429 Too Many Requests response
-
-3. **File:** `ratelimit.go` (51 lines)
-
-### ✅ Audit Logging (Q3 2026 Feature)
-
-**Status:** COMPLETE (ahead of schedule)
-
-This was planned for Q3 2026 but has been fully implemented:
-
-#### Implementation Details:
-
-1. **AuditRecord Structure:**
-   ```go
-   type AuditRecord struct {
-       TraceID        string
-       Timestamp      time.Time
-       Tool           string
-       AccountID      string
-       ScopesRequired []string
-       Allowed        bool
-       DeniedReason   string
-       Duration       time.Duration
-       Error          string
-   }
-   ```
-
-2. **Callback Function:**
-   ```go
-   mcp.Serve(mcp.Options{
-       Registry: reg,
-       AuditFunc: func(r mcp.AuditRecord) {
-           log.Printf("[audit] trace=%s tool=%s allowed=%v",
-               r.TraceID, r.Tool, r.Allowed)
-       },
-   })
-   ```
-
-3. **Features:**
-   - Immutable audit records
-   - Capture allowed and denied calls
-   - Include auth context
-   - Record RPC duration and errors
-
---
-
-## Recent Commits Analysis
-
-### Primary Commit: ac47a46
-**Title:** "MCP gateway: add per-tool scopes, tracing, rate limiting, and audit logging"  
-**PR:** #2850  
-**Date:** February 11, 2026
-
-**Changes:**
- Added `Scopes` field to `Tool` struct
- Added `Auth` (auth.Auth) integration to `Options`
- Added trace ID generation (UUID) with metadata propagation
- Added per-tool rate limiting (configurable requests/sec and burst)
- Added `AuditFunc` callback for audit records
- Extracted tool scopes from endpoint metadata ("scopes" key)
- Updated both HTTP and stdio transports with auth/trace/rate/audit
- Added `server.WithEndpointScopes()` helper
- Added gateway-level `Options.Scopes` for overrides
- Comprehensive test suite for all new features
- Updated documentation and examples
-
-**Impact:**
- Brought multiple Q2/Q3 2026 features forward
- Production-ready security features
- Enterprise-grade observability
-
---
-
-## Feature Comparison: Planned vs. Actual
-
-### Q2 2026 Features - Early Delivery
-
-| Feature | Roadmap Status | Actual Status | Notes |
-|---------|----------------|---------------|-------|
-| Stdio Transport | Planned Q2 | ✅ COMPLETE | Full JSON-RPC 2.0 implementation |
-| `micro mcp` commands | Planned Q2 | ✅ COMPLETE | `serve`, `list`, `test` (partial) |
-| Tool descriptions from comments | Planned Q2 | ✅ COMPLETE | Auto-extraction working |
-| `@example` tag support | Planned Q2 | ✅ COMPLETE | Implemented in parser |
-| Schema from struct tags | Planned Q2 | ✅ COMPLETE | Type mapping implemented |
-
-### Q2 2026 Features - Not Yet Implemented
-
-| Feature | Status | Priority |
-|---------|--------|----------|
-| `micro mcp test` full implementation | 🟡 Partial | Medium |
-| `micro mcp docs` command | ❌ Not Started | Low |
-| `micro mcp export` commands | ❌ Not Started | Low |
-| Multi-protocol support (WebSocket, gRPC, HTTP/3) | ❌ Not Started | Medium |
-| Agent SDKs (LangChain, LlamaIndex) | ❌ Not Started | High |
-| Interactive Agent Playground | ❌ Not Started | High |
-
-### Q3 2026 Features - Early Delivery
-
-| Feature | Roadmap Status | Actual Status | Notes |
-|---------|----------------|---------------|-------|
-| Tracing | Planned Q3 | ✅ COMPLETE | UUID trace IDs |
-| Rate Limiting | Planned Q3 | ✅ COMPLETE | Per-tool limiters |
-| Audit Logging | Planned Q3 | ✅ COMPLETE | Full audit records |
-| Auth Integration | Planned Q3 | ✅ COMPLETE | Bearer tokens + scopes |
-
---
-
-## Test Coverage
-
-### Comprehensive Test Suite (`mcp_test.go` - 568 lines)
-
-**Tests Implemented:**
-1. `TestHasScope` - Scope matching logic
-2. `TestToolScopesFromMetadata` - Scope extraction from registry
-3. `TestHandleCallTool_AuthRequired` - Auth enforcement
-4. `TestHandleCallTool_TraceID` - Trace ID generation
-5. `TestHandleCallTool_Audit_Allowed` - Audit for allowed calls
-6. `TestHandleCallTool_Audit_Denied` - Audit for denied calls
-7. `TestRateLimit` - Rate limiting behavior
-
-**Test Coverage Areas:**
- ✅ Scope validation
- ✅ Auth provider integration
- ✅ Trace ID propagation
- ✅ Audit record generation
- ✅ Rate limiting
- ✅ HTTP transport
- ✅ Stdio transport
- ✅ Tool discovery
- ✅ Schema generation
-
---
-
-## Documentation Status
-
-### ✅ Complete Documentation
-
-1. **Gateway Documentation** (`gateway/mcp/DOCUMENTATION.md`)
-   - Automatic documentation extraction
-   - Manual registration methods
-   - Endpoint scopes configuration
-   - Gateway-level scope overrides
-
-2. **Examples README** (`examples/mcp/README.md`)
-   - Quick start guide
-   - Multiple transports (stdio, HTTP)
-   - Auth scopes examples
-   - Tracing, rate limiting, audit examples
-   - CLI usage
-
-3. **Website Documentation** (`internal/website/docs/mcp.md`)
-   - Full MCP integration guide
-
-4. **Blog Post** (`internal/website/blog/2.md`)
-   - "Making Microservices AI-Native with MCP"
-   - Published February 11, 2026
-
-5. **Examples:**
-   - `examples/mcp/hello/` - Minimal working example
-   - `examples/mcp/documented/` - Full-featured example with scopes
-
---
-
-## Current Implementation Status by Component
-
-### Core MCP Gateway (`gateway/mcp/`)
-
-| Component | Status | Lines | Completeness |
-|-----------|--------|-------|--------------|
-| `mcp.go` | ✅ Production | 630 | 100% |
-| `stdio.go` | ✅ Production | 369 | 100% |
-| `parser.go` | ✅ Production | 339 | 100% |
-| `ratelimit.go` | ✅ Production | 51 | 100% |
-| `mcp_test.go` | ✅ Complete | 568 | 100% |
-| `example_test.go` | ✅ Complete | 126 | 100% |
-| `DOCUMENTATION.md` | ✅ Complete | - | 100% |
-
-**Total Lines:** 2,083 (excluding docs)
-
-### CLI Integration (`cmd/micro/mcp/`)
-
-| Component | Status | Completeness |
-|-----------|--------|--------------|
-| `mcp.go` | ✅ Production | 90% |
-| `serve` command | ✅ Complete | 100% |
-| `list` command | ✅ Complete | 100% |
-| `test` command | 🟡 Placeholder | 20% |
-
-### Server Integration (`server/`)
-
-| Component | Status | Completeness |
-|-----------|--------|--------------|
-| `WithEndpointScopes()` | ✅ Complete | 100% |
-| `WithEndpointDocs()` | ✅ Complete | 100% |
-| Comment extraction | ✅ Complete | 100% |
-
---
-
-## Roadmap Progress Summary
-
-### Q1 2026: MCP Foundation
-**Status:** ✅ COMPLETE (100%)
-
-All planned features delivered:
- MCP library ✅
- CLI integration ✅
- Service discovery ✅
- HTTP/SSE transport ✅
- Documentation ✅
- Blog post ✅
-
-### Q2 2026: Agent Developer Experience
-**Status:** 🟢 Ahead of Schedule (60% complete)
-
-**Completed (ahead of schedule):**
- ✅ Stdio transport for Claude Code
- ✅ `micro mcp` command suite (partial)
- ✅ Tool descriptions from comments
- ✅ `@example` tag support
- ✅ Schema generation from struct tags
-
-**Not Started:**
- ❌ Multi-protocol support (WebSocket, gRPC)
- ❌ Agent SDKs (LangChain, LlamaIndex)
- ❌ Interactive Agent Playground
- ❌ Export commands
-
-### Q3 2026: Production & Scale
-**Status:** 🟢 Ahead of Schedule (40% complete)
-
-**Completed (ahead of schedule):**
- ✅ Per-tool authentication
- ✅ Scope-based permissions
- ✅ Tracing with trace IDs
- ✅ Rate limiting
- ✅ Audit logging
-
-**Not Started:**
- ❌ Enterprise MCP Gateway (standalone binary)
- ❌ Kubernetes Operator
- ❌ Helm Charts
- ❌ Full observability dashboards
-
-### Q4 2026: Ecosystem & Monetization
-**Status:** 🟡 Planning Phase (0% complete)
-
-All features planned for Q4 2026.
-
---
-
-## Key Achievements
-
-### 🎯 Accelerated Development
- **3-4 months ahead of schedule** on core features
- Q2 2026 features (stdio, scopes) delivered in Q1
- Q3 2026 features (auth, tracing, rate limiting) delivered in Q1
-
-### 🔒 Production-Ready Security
- Full auth.Auth integration
- Per-tool scope enforcement
- Audit trail for compliance
- Rate limiting for protection
-
-### 📚 Comprehensive Documentation
- 4+ documentation files
- 2 working examples
- Blog post published
- In-code examples
-
-### 🧪 Robust Testing
- 568 lines of tests
- Auth testing with mock provider
- Scope enforcement validation
- Audit record verification
- Rate limiting tests
-
---
-
-## Areas for Improvement
-
-### 1. CLI Testing (`micro mcp test`)
-**Status:** Placeholder implementation  
-**Priority:** Medium  
-**Effort:** ~1 day
-
-Current implementation:
-```go
-func testAction(ctx *cli.Context) error {
-    // ...
-    fmt.Println("(Not yet implemented - coming soon)")
-    return nil
-}
-```
-
-**Recommendation:** Implement actual tool testing with:
- JSON input validation
- RPC call execution
- Response formatting
- Error handling
-
-### 2. Agent SDKs (Q2 2026)
-**Status:** Not started  
-**Priority:** High  
-**Effort:** ~2 weeks per SDK
-
-**Recommended order:**
-1. LangChain (largest ecosystem)
-2. LlamaIndex (RAG/data focus)
-3. AutoGPT (autonomous agents)
-
-### 3. Interactive Playground (Q2 2026)
-**Status:** Not started  
-**Priority:** High (for demos)  
-**Effort:** ~1 week
-
-**Value:** Critical for:
- Product demos
- Developer onboarding
- Testing tool integrations
-
-### 4. Multi-Protocol Support (Q2 2026)
-**Status:** Not started  
-**Priority:** Medium  
-**Effort:** ~1 week per protocol
-
-**Protocols to add:**
- WebSocket (bidirectional streaming)
- gRPC (reflection-based)
- HTTP/3 (performance)
-
---
-
-## Recommendations
-
-### Immediate Actions (Next 2 Weeks)
-
-1. **Complete `micro mcp test` command** (~1 day)
-   - Implement actual tool testing
-   - Add JSON validation
-   - Format responses properly
-
-2. **Create LangChain SDK** (~1 week)
-   - Python package `go-micro-langchain`
-   - Auto-generate LangChain tools
-   - Example multi-agent workflow
-   - **Impact:** Largest agent framework integration
-
-3. **Build Interactive Playground** (~1 week)
-   - Web UI for testing services
-   - Real-time tool call visualization
-   - Embeddable in `micro run` dashboard
-   - **Impact:** Critical for demos and sales
-
-### Short-Term (Next Month)
-
-4. **Add WebSocket Transport** (~3 days)
-   - Bidirectional streaming
-   - Better for long-running operations
-   - Agent feedback loops
-
-5. **Create LlamaIndex SDK** (~1 week)
-   - Python package `go-micro-llamaindex`
-   - Service discovery as data sources
-   - RAG integration example
-
-6. **Publish Case Studies** (~ongoing)
-   - Document real-world usage
-   - Share on blog
-   - Community testimonials
-
-### Medium-Term (Next Quarter)
-
-7. **Enterprise MCP Gateway** (Q3 feature)
-   - Standalone binary
-   - Horizontal scaling
-   - Production observability
-
-8. **Kubernetes Operator** (Q3 feature)
-   - CRD for MCPGateway
-   - Auto-scaling
-   - Service mesh integration
-
---
-
-## Success Metrics
-
-### Technical KPIs - Current Status
-
-| Metric | Target | Current | Status |
-|--------|--------|---------|--------|
-| Claude Desktop integration | 95%+ | ✅ 100% | ACHIEVED |
-| Tool discovery latency (p99) | <100ms | ✅ <50ms | EXCEEDED |
-| Stdio transport compliance | 100% | ✅ 100% | ACHIEVED |
-| Test coverage | >80% | ✅ 90%+ | EXCEEDED |
-
-### Implementation KPIs - Current Status
-
-| Metric | Target Q1 | Current | Status |
-|--------|-----------|---------|--------|
-| MCP library | ✅ Complete | ✅ Complete | ACHIEVED |
-| CLI integration | ✅ Complete | ✅ Complete | ACHIEVED |
-| Documentation | ✅ Complete | ✅ Complete | ACHIEVED |
-| Examples | 2+ | ✅ 2 | ACHIEVED |
-| Blog posts | 1+ | ✅ 1 | ACHIEVED |
-
---
-
-## Conclusion
-
-The **Q1 2026: MCP Foundation** milestone is **COMPLETE** with exceptional execution that has delivered features planned for Q2 and Q3 2026.
-
-### Key Highlights:
-
-1. **✅ 100% of Q1 deliverables** completed on schedule
-2. **✅ 60% of Q2 deliverables** completed early (stdio, scopes, docs)
-3. **✅ 40% of Q3 deliverables** completed early (auth, tracing, rate limiting, audit)
-4. **2,083 lines** of production MCP code
-5. **568 lines** of comprehensive tests
-6. **Full documentation** with examples and blog post
-
-### Production Readiness:
-
-The MCP integration is **production-ready** with:
- ✅ Full auth.Auth integration
- ✅ Per-tool scope enforcement
- ✅ Tracing and audit logging
- ✅ Rate limiting
- ✅ Stdio transport for Claude Code
- ✅ HTTP/SSE transport for web agents
- ✅ Comprehensive test coverage
-
-### Next Steps:
-
-**Immediate priorities** to maintain momentum:
-1. Complete `micro mcp test` command (1 day)
-2. Build LangChain SDK (1 week)
-3. Create Interactive Playground (1 week)
-
-The project is **3-4 months ahead of the roadmap** and well-positioned to achieve the 2026-2027 goals of making go-micro the **standard microservices framework for the agent era**.
-
---
-
-**Report Generated:** February 11, 2026  
-**Analysis By:** Copilot Engineering Agent  
-**Status:** CURRENT
@@ -2,8 +2,6 @@

 Go Micro is a framework for distributed systems development.

-**[📖 Documentation](https://go-micro.dev/docs/)** | [Sponsor the project](https://github.com/sponsors/micro) | [Discord](https://discord.gg/jwTYuUVAGh)
-
 ## Overview

 Go Micro provides the core requirements for distributed systems development including RPC and Event driven communication.
@@ -42,9 +40,6 @@ in the plugins repo. State and persistence becomes a core requirement beyond pro
 - **Async Messaging** - PubSub is built in as a first class citizen for asynchronous communication and event driven architectures.
  Event notifications are a core pattern in micro service development. The default messaging system is a HTTP event message broker.

- **MCP Integration** - An MCP gateway you can integrate as a library, server or CLI command which automatically exposes services
-  as tools for agents or other AI applications. Every service/endpoint get's converted into a callable tool.
-
 - **Pluggable Interfaces** - Go Micro makes use of Go interfaces for each distributed system abstraction. Because of this these interfaces
  are pluggable and allows Go Micro to be runtime agnostic. You can plugin any underlying technology.

@@ -52,13 +47,13 @@ in the plugins repo. State and persistence becomes a core requirement beyond pro

 To make use of Go Micro 

-```bash
-go get go-micro.dev/v5@latest
+```golang
+go get "go-micro.dev/v5"
 ```

 Create a service and register a handler

-```go
+```golang
 package main

 import (
@@ -94,7 +89,7 @@ func main() {

 Set a fixed address

-```go
+```golang
 service := micro.NewService(
    micro.Name("helloworld"),
    micro.Address(":8080"),
@@ -103,7 +98,7 @@ service := micro.NewService(

 Call it via curl

-```bash
+```
 curl -XPOST \
     -H 'Content-Type: application/json' \
     -H 'Micro-Endpoint: Say.Hello' \
@@ -111,181 +106,17 @@ curl -XPOST \
      http://localhost:8080
 ```

-## MCP & AI Agents
+## Experimental

-Go Micro is designed for an **agent-first** workflow. Every service you build automatically becomes a tool that AI agents can discover and use via the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/).
-
- **[🤖 Agent Playground](https://go-micro.dev/docs/mcp.html)** — Chat with your services through an interactive AI agent at `/agent`
- **[🔧 MCP Tools Registry](https://go-micro.dev/docs/mcp.html)** — Browse all services exposed as AI-callable tools at `/api/mcp/tools`
- **[📖 MCP Documentation](https://go-micro.dev/docs/mcp.html)** — Full guide to MCP integration, auth, and scopes
-
-### Services as Tools
-
-Write a normal Go Micro service and it's instantly available as an MCP tool:
-
-```go
-// SayHello greets a person by name.
-// @example {"name": "Alice"}
-func (g *GreeterService) SayHello(ctx context.Context, req *HelloRequest, rsp *HelloResponse) error {
-    rsp.Message = "Hello " + req.Name
-    return nil
-}
-```
-
-Run with `micro run` and the agent playground and MCP tools registry are ready:
-
-```bash
-micro run
-# Agent Playground:  http://localhost:8080/agent
-# MCP Tools:         http://localhost:8080/api/mcp/tools
-```
-
-Use `micro mcp serve` for local AI tools like Claude Code, or connect any MCP-compatible agent to the HTTP endpoint.
-
-See the [MCP guide](https://go-micro.dev/docs/mcp.html) for authentication, scopes, and advanced usage.
-
-## Examples
-
-Check out [/examples](examples/) for runnable code:
- [hello-world](examples/hello-world/) - Basic RPC service
- [web-service](examples/web-service/) - HTTP REST API
- [mcp](examples/mcp/) - MCP integration with AI agents
-
-See [all examples](examples/README.md) for more.
+There's a new `genai` package for generative AI capabilities.

 ## Protobuf

-Install the code generator and see usage in the docs:
+See [protoc-gen-micro](https://github.com/micro/go-micro/tree/master/cmd/protoc-gen-micro) for protobuf code generation

-```bash
-go install go-micro.dev/v5/cmd/protoc-gen-micro@v5.16.0
-```
+## Command line

-> **Note:** Use a specific version instead of `@latest` to avoid module path conflicts. See [releases](https://github.com/micro/go-micro/releases) for the latest version.
-
-Docs: [`internal/website/docs/getting-started.md`](internal/website/docs/getting-started.md)
-
-## Command Line
-
-Install the CLI:
-
-```
-go install go-micro.dev/v5/cmd/micro@v5.16.0
-```
-
-> **Note:** Use a specific version instead of `@latest` to avoid module path conflicts. See [releases](https://github.com/micro/go-micro/releases) for the latest version.
-
-### Quick Start
-
-```bash
-micro new helloworld   # Create a new service
-cd helloworld
-micro run              # Run with API gateway and hot reload
-```
-
-Then open http://localhost:8080 to see your service and call it from the browser.
-
-### Development Workflow
-
-| Stage | Command | Purpose |
-|-------|---------|---------|
-| **Develop** | `micro run` | Local dev with hot reload and API gateway |
-| **Build** | `micro build` | Compile production binaries |
-| **Deploy** | `micro deploy` | Push to a remote Linux server via SSH + systemd |
-| **Dashboard** | `micro server` | Optional production web UI with JWT auth |
-
-### micro run
-
-`micro run` starts your services with:
- **Web Dashboard** - Browse and call services at `/`
- **Agent Playground** - AI chat with MCP tools at `/agent`
- **API Explorer** - Browse endpoints and schemas at `/api`
- **API Gateway** - HTTP to RPC proxy at `/api/{service}/{method}` (no auth in dev mode)
- **MCP Tools** - Services as AI tools at `/api/mcp/tools`
- **Health Checks** - Aggregated health at `/health`
- **Hot Reload** - Auto-rebuild on file changes
-
-> **Note:** `micro run` and `micro server` use a unified gateway architecture. See [Gateway Architecture](cmd/micro/README.md#gateway-architecture) for details.
-
-```bash
-micro run                    # Gateway on :8080
-micro run --address :3000    # Custom gateway port
-micro run --no-gateway       # Services only
-micro run --env production   # Use production environment
-```
-
-### Configuration
-
-For multi-service projects, create a `micro.mu` file:
-
-```
-service users
-    path ./users
-    port 8081
-
-service posts
-    path ./posts
-    port 8082
-    depends users
-
-env development
-    DATABASE_URL sqlite://./dev.db
-```
-
-The gateway runs on :8080 by default, so services should use other ports.
-
-### Deployment
-
-Deploy to any Linux server with systemd:
-
-```bash
-# On your server (one-time setup)
-curl -fsSL https://go-micro.dev/install.sh | sh
-sudo micro init --server
-
-# From your laptop
-micro deploy user@your-server
-```
-
-The deploy command:
-1. Builds binaries for Linux
-2. Copies via SSH to the server
-3. Sets up systemd services
-4. Verifies services are healthy
-
-Optionally run `micro server` on the deployed machine for a production web dashboard with JWT auth, user management, and API explorer.
-
-Manage deployed services:
-```bash
-micro status --remote user@server    # Check status
-micro logs --remote user@server      # View logs
-micro logs myservice --remote user@server -f  # Follow specific service
-```
-
-No Docker required. No Kubernetes. Just systemd.
-
-See [internal/website/docs/deployment.md](internal/website/docs/deployment.md) for full deployment guide.
-
-See [cmd/micro/README.md](cmd/micro/README.md) for full CLI documentation.
-
-Docs: [`internal/website/docs`](internal/website/docs)
-
-Package reference: https://pkg.go.dev/go-micro.dev/v5
-
-**User Guides:**
- [Getting Started](internal/website/docs/getting-started.md)
- [MCP & AI Agents](internal/website/docs/mcp.md)
- [Plugins Overview](internal/website/docs/plugins.md)
- [Learn by Example](internal/website/docs/examples/index.md)
- [Deployment Guide](internal/website/docs/deployment.md)
-
-**Architecture & Performance:**
- [Performance Considerations](internal/website/docs/performance.md)
- [Reflection Usage & Philosophy](internal/website/docs/REFLECTION-EVALUATION-SUMMARY.md)
-
-**Security:**
- [TLS Security Migration](internal/website/docs/TLS_SECURITY_UPDATE.md)
- [Security Migration Guide](internal/website/docs/SECURITY_MIGRATION.md)
+See [cmd/micro](https://github.com/micro/go-micro/tree/master/cmd/micro) for the command line

 ## Adopters

@@ -1,165 +0,0 @@
-# Go Micro Roadmap
-
-This roadmap outlines the planned features and improvements for Go Micro. Community feedback and contributions are welcome!
-
-> **🚀 NEW:** See [ROADMAP_2026.md](ROADMAP_2026.md) for the **AI-Native Era roadmap** focused on MCP integration, agent-first development, and business sustainability. This document covers general framework improvements.
-
-## Current Focus (Q1 2026)
-
-### Documentation & Developer Experience
- [x] Modernize documentation structure
- [x] Add learn-by-example guides
- [x] Update issue templates
- [ ] Create video tutorials
- [ ] Interactive documentation site
- [ ] Plugin discovery dashboard
-
-### Observability
- [ ] OpenTelemetry native support
- [ ] Auto-instrumentation for handlers
- [ ] Metrics export standardization
- [ ] Distributed tracing examples
- [ ] Integration with popular observability platforms
-
-### Developer Tools
- [ ] `micro dev` with hot reload
- [ ] Service templates (`micro new --template`)
- [ ] Better error messages with suggestions
- [ ] Debug tooling improvements
- [ ] VS Code extension for Go Micro
-
-## Q2 2026
-
-### Production Readiness
- [ ] Health check standardization
- [ ] Graceful shutdown improvements
- [ ] Resource cleanup best practices
- [ ] Load testing framework integration
- [ ] Performance benchmarking suite
-
-### Cloud Native
- [ ] Kubernetes operator
- [ ] Helm charts for common setups
- [ ] Service mesh integration guides (Istio, Linkerd)
- [ ] Cloud provider quickstarts (AWS, GCP, Azure)
- [ ] Multi-cluster patterns
-
-### Security
- [ ] mTLS by default option
- [ ] Secret management integration (Vault, AWS Secrets Manager)
- [ ] RBAC improvements
- [ ] Security audit and hardening
- [ ] CVE scanning and response process
-
-## Q3 2026
-
-### Plugin Ecosystem
- [ ] Plugin marketplace/registry
- [ ] Plugin quality standards
- [ ] Community plugin contributions
- [ ] Plugin compatibility matrix
- [ ] Auto-discovery of available plugins
-
-### Streaming & Async
- [ ] Improved streaming support
- [ ] Server-sent events (SSE) support
- [ ] WebSocket plugin
- [ ] Event sourcing patterns
- [ ] CQRS examples
-
-### Testing
- [ ] Mock generation tooling
- [ ] Integration test helpers
- [ ] Contract testing support
- [ ] Chaos engineering examples
- [ ] E2E testing framework
-
-## Q4 2026
-
-### Performance
- [ ] Connection pooling optimizations
- [ ] Zero-allocation paths
- [ ] gRPC performance improvements
- [ ] Caching strategies guide
- [ ] Performance profiling tools
-
-### Developer Productivity
- [ ] Code generation improvements
- [ ] Better IDE support
- [ ] Debugging tools
- [ ] Migration automation tools
- [ ] Upgrade helpers
-
-### Community
- [ ] Regular blog posts and case studies
- [ ] Community spotlight program
- [ ] Contribution rewards
- [ ] Monthly community calls
- [ ] Conference presence
-
-## Long-term Vision
-
-### Core Framework
- Maintain backward compatibility (Go Micro v5+)
- Progressive disclosure of complexity
- Best-in-class developer experience
- Production-grade reliability
- Comprehensive plugin ecosystem
-
-### Ecosystem Goals
- 100+ production deployments documented
- 50+ community plugins
- Active contributor community
- Regular releases (monthly patches, quarterly features)
- Comprehensive benchmarks vs alternatives
-
-### Differentiation
- **Batteries included, fully swappable** - Start simple, scale complex
- **Zero-config local development** - No infrastructure required to start
- **Plugin ecosystem in-repo** - No version compatibility hell
- **Progressive complexity** - Learn as you grow
- **Cloud-native first** - Built for Kubernetes and containers
-
-## Contributing
-
-We welcome contributions to any roadmap items! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
-
-### High Priority Areas
-1. Documentation improvements
-2. Real-world examples
-3. Plugin development
-4. Performance optimizations
-5. Testing infrastructure
-
-### How to Contribute
- Pick an item from the roadmap
- Open an issue to discuss approach
- Submit a PR with implementation
- Help review others' contributions
-
-## Feedback
-
-Have suggestions for the roadmap? 
-
- Open a [feature request](.github/ISSUE_TEMPLATE/feature_request.md)
- Start a discussion in GitHub Discussions
- Comment on existing roadmap issues
-
-## Version Compatibility
-
-We follow semantic versioning:
- Major versions (v5 → v6): Breaking changes
- Minor versions (v5.3 → v5.4): New features, backward compatible
- Patch versions (v5.3.0 → v5.3.1): Bug fixes, no API changes
-
-## Support Timeline
-
- v5: Active development (current)
- v4: Security fixes only (until v6 release)
- v3: End of life
-
---
-
-Last updated: November 2025
-
-This roadmap is subject to change based on community needs and priorities. Star the repo to stay updated! ⭐
@@ -1,954 +0,0 @@
-# Go Micro Roadmap 2026: The AI-Native Era
-
-**Last Updated:** February 2026
-
-## Executive Summary
-
-The emergence of AI agents represents a **paradigm shift** in how services are consumed. Where APIs served apps, **MCP serves agents**. Go Micro is uniquely positioned to become the **standard microservices framework for the agent era**.
-
-This roadmap outlines Go Micro's evolution from an API-first framework to an **AI-native platform** while maintaining backward compatibility and ensuring long-term sustainability.
-
---
-
-## The Paradigm Shift
-
-### Before: Apps → API Gateway → Services
-```
-┌──────────┐     HTTP/REST      ┌─────────────┐     RPC      ┌──────────┐
-│  Mobile  │ ───────────────→   │   Gateway   │ ─────────→   │ Services │
-│   App    │                    │  (Express)  │              │          │
-└──────────┘                    └─────────────┘              └──────────┘
-```
-
-Characteristics:
- Apps need HTTP/REST/GraphQL
- Manual API design (OpenAPI specs)
- Developers write integration code
- Static endpoint documentation
-
-### Now: Agents → MCP → Services
-```
-┌──────────┐      MCP/SSE       ┌─────────────┐     RPC      ┌──────────┐
-│  Claude  │ ───────────────→   │     MCP     │ ─────────→   │ Services │
-│   GPT    │                    │   Gateway   │              │          │
-└──────────┘                    └─────────────┘              └──────────┘
-```
-
-Characteristics:
- Agents discover tools automatically
- No manual API design needed
- Agents write their own integration code
- Dynamic tool discovery
-
-### Why This Matters
-
-**API Gateways solve integration for developers.**
-**MCP solves integration for AI.**
-
-Go Micro's MCP integration means:
-1. **Zero integration work** - Services become AI-accessible instantly
-2. **No API wrappers** - Agents call services directly
-3. **Dynamic discovery** - New services = new tools automatically
-4. **Natural language interface** - No documentation needed
-
---
-
-## Strategic Vision
-
-### Mission Statement
-
-> **Make every microservice AI-native by default.**
-
-### 2026-2027 Goals
-
-1. **MCP becomes the default** - `micro run` enables MCP automatically
-2. **Best-in-class agent integration** - The easiest way to expose services to AI
-3. **Sustainable business model** - Open core with premium offerings
-4. **Production deployment at scale** - 1000+ services running MCP gateways
-5. **Ecosystem leadership** - The go-to framework when AI needs microservices
-
---
-
-## Roadmap
-
-## Q1 2026: MCP Foundation ✅ COMPLETE
-
-**Status:** COMPLETE as of February 2026
-
-### Delivered
- [x] MCP library (`gateway/mcp`)
- [x] CLI integration (`micro run --mcp-address`)
- [x] Service discovery and tool generation
- [x] HTTP/SSE transport
- [x] Documentation and examples
- [x] Blog post and launch
-
-### Impact
- Services are now AI-accessible with 3 lines of code
- Both library and CLI users can use MCP
- Foundation for agent-first development
-
---
-
-## Q2 2026: Agent Developer Experience
-
-**Status:** IN PROGRESS - Several features delivered early (Feb 2026)
-
-**Theme:** Make it trivial for any AI to call your services
-
-### MCP Enhancements
-
-#### Stdio Transport for Claude Code ✅ COMPLETE (delivered early)
- [x] Implement stdio JSON-RPC protocol
- [x] Auto-detection: stdio vs HTTP based on environment
- [x] `micro mcp` command for Claude Code integration
- [x] Example: Add go-micro services to Claude Code
-
-**Why:** Claude Code and other local AI tools use stdio MCP servers. This enables:
-```bash
-# In Claude Code config
-{
-  "mcpServers": {
-    "my-services": {
-      "command": "micro",
-      "args": ["mcp"]
-    }
-  }
-}
-```
-
-**Business value:** Direct integration with Anthropic's flagship developer tool.
-
-#### Tool Descriptions from Comments ✅ COMPLETE (delivered early)
- [x] Parse Go comments to generate tool descriptions
- [x] Support JSDoc-style tags: `@param`, `@return`, `@example`
- [x] Schema generation from struct tags
- [ ] Auto-generate examples from test cases
-
-**Before:**
-```
-Tools:
- users.Users.Get - Call Get on users service
-```
-
-**After:**
-```
-Tools:
- users.Users.Get
-  Description: Retrieve user profile by ID. Returns full profile including email,
-               name, created date, and preferences.
-  Parameters:
-    - id (string, required): User ID in UUID format
-  Returns: User object with profile fields
-  Example: {"id": "123e4567-e89b-12d3-a456-426614174000"}
-```
-
-**Why:** Better descriptions = better agent performance. Agents need context to call services correctly.
-
-#### Multi-Protocol Support
- [ ] WebSocket transport for streaming
- [ ] gRPC reflection for MCP (bidirectional streaming)
- [x] Server-Sent Events with auth (HTTP/SSE implemented)
- [ ] HTTP/3 support
-
-**Why:** Different agents prefer different protocols. Support them all.
-
-### Agent SDKs
-
-Create official SDKs for popular agent frameworks:
-
-#### LangChain Integration
- [ ] `go-micro-langchain` package
- [ ] Auto-generate LangChain tools from registry
- [ ] Example: Multi-agent workflow with go-micro services
-
-#### LlamaIndex Integration
- [ ] `go-micro-llamaindex` package
- [ ] Service discovery as data sources
- [ ] Example: RAG with microservices
-
-#### AutoGPT/AgentGPT Support
- [ ] Plugin format adapter
- [ ] Auto-install via plugin marketplace
- [ ] Example: Autonomous agents orchestrating services
-
-**Business value:** Every agent framework can use go-micro services out of the box.
-
-### Developer Experience
-
-#### `micro mcp` Command Suite ✅ PARTIALLY COMPLETE
-
-**Implemented:**
-```bash
-# Start MCP server
-micro mcp serve                    # Stdio (for Claude Code) ✅
-micro mcp serve --address :3000    # HTTP/SSE (for web agents) ✅
-
-# Development
-micro mcp list                     # List available tools ✅
-micro mcp list --json              # JSON output ✅
-```
-
-**Not Yet Implemented:**
-```bash
-micro mcp test users.Users.Get     # Test a tool (placeholder only)
-micro mcp docs                     # Generate MCP documentation
-micro mcp export langchain         # Export to LangChain format
-micro mcp export openapi           # Export as OpenAPI (for fallback)
-```
-
-#### Interactive Agent Playground
- [ ] Web UI for testing services with AI
- [ ] Built into `micro run` dashboard
- [ ] Chat with your services
- [ ] See agent tool calls in real-time
- [ ] Share playground URLs for demos
-
-**Example:**
-```
-http://localhost:8080/playground
-
-> You: "Show me user 123's last 5 orders"
-
-Agent: Let me check that...
-→ Calling users.Users.Get with {"id": "123"}
-→ Calling orders.Orders.List with {"user_id": "123", "limit": 5}
-
-Here are the 5 most recent orders for Alice Smith:
-1. Order #45678 - $125.00 - Shipped (Jan 15)
-2. Order #45123 - $89.99 - Delivered (Jan 10)
-...
-```
-
-**Business value:** Instant demos. Show investors/customers AI calling your services.
-
-### Documentation
-
- [ ] "Building AI-Native Services" guide
- [ ] Agent integration patterns
- [ ] Best practices for tool descriptions
- [ ] MCP security guide
- [ ] Video: "Your First AI-Native Service in 5 Minutes"
-
---
-
-## Q3 2026: Production & Scale
-
-**Status:** IN PROGRESS - Core security features delivered early (Feb 2026)
-
-**Theme:** Run MCP gateways in production at scale
-
-### Enterprise MCP Gateway
-
-Create a production-grade standalone MCP gateway:
-
-#### Gateway Features
- [ ] Standalone binary: `micro-mcp-gateway`
- [ ] Horizontal scaling (stateless design)
- [x] Rate limiting per agent/token ✅ (delivered early)
- [ ] Usage tracking and analytics
- [x] Cost attribution (track which agent called what) ✅ (audit logging)
- [ ] Circuit breakers for service protection
- [ ] Request/response caching
- [ ] Multi-tenant support (isolate services by namespace)
-
-**Deployment:**
-```bash
-# Standalone gateway
-micro-mcp-gateway \
-  --registry consul:8500 \
-  --address :3000 \
-  --auth jwt \
-  --rate-limit 1000/hour \
-  --cache redis:6379
-```
-
-**Business value:** Enterprise customers need production-grade MCP gateways. This is a **paid offering**.
-
-#### Observability
- [ ] OpenTelemetry integration
- [x] Agent call tracing (which agent called what) ✅ (trace IDs implemented)
- [ ] Tool usage metrics (which tools are popular)
- [ ] Performance dashboards
- [ ] Anomaly detection (unusual agent behavior)
- [ ] Cost analysis (cloud spend per agent)
-
-**Dashboard Example:**
-```
-Agent Activity - Last 7 Days
-─────────────────────────────
-Claude Desktop    1,234 calls   $12.34 compute cost
-ChatGPT Plugin    567 calls     $5.67 compute cost
-Custom Agent      234 calls     $2.34 compute cost
-
-Top Services
-────────────
-users    45%
-orders   30%
-payments 15%
-
-Slowest Tools
-─────────────
-analytics.Reports.Generate   2.3s avg
-payments.Payments.Process    890ms avg
-```
-
-**Business value:** Enterprises need observability. This justifies MCP Gateway pricing.
-
-### Security ✅ CORE FEATURES COMPLETE (delivered early)
-
-#### Agent Authentication ✅ COMPLETE
- [x] Auth provider integration (auth.Auth)
- [x] Bearer token authentication
- [x] Scope-based permissions (agent can only call certain services)
- [x] Audit logging (full trail of what agents accessed)
- [ ] OAuth2 for agent authorization (basic auth implemented)
- [ ] API keys per agent (bearer tokens supported)
-
-**Implemented Example:**
-```go
-mcp.Serve(mcp.Options{
-    Registry: registry,
-    Auth:     authProvider,  // ✅ Implemented
-    Scopes: map[string][]string{  // ✅ Implemented
-        "blog.Blog.Create": {"blog:write"},
-        "blog.Blog.Delete": {"blog:admin"},
-    },
-    AuditFunc: func(r mcp.AuditRecord) {  // ✅ Implemented
-        log.Printf("[audit] %+v", r)
-    },
-})
-```
-
-#### Service-Side Authorization ✅ COMPLETE
- [x] Services can validate which agent is calling
- [x] Agent identity in context (via metadata)
- [x] Fine-grained permissions (Agent X can read but not write)
- [x] Trace ID propagation for debugging
-
-**Implemented - Metadata in Context:**
-```go
-// Trace ID, Tool Name, and Account ID are automatically
-// propagated to services via context metadata:
-// - Mcp-Trace-Id
-// - Mcp-Tool-Name  
-// - Mcp-Account-Id
-```
-
-**Future Enhancement - Service-Side Example:**
-```go
-// Future: Direct access to agent info from context
-func (s *Users) Delete(ctx context.Context, req *Request, rsp *Response) error {
-    // For now, services can read metadata keys:
-    // Mcp-Account-Id, Mcp-Trace-Id, Mcp-Tool-Name
-    md, _ := metadata.FromContext(ctx)
-    accountID := md["Mcp-Account-Id"]
-    
-    if accountID != "admin-account" {
-        return errors.Forbidden("users", "admin only")
-    }
-    // ...
-}
-```
-
-**Business value:** Security is a hard requirement for enterprise adoption.
-
-### Deployment Patterns
-
-#### Kubernetes Operator
- [ ] `micro-operator` for Kubernetes
- [ ] CRD: `MCPGateway` resource
- [ ] Auto-scaling based on agent traffic
- [ ] Service mesh integration
-
-**Example:**
-```yaml
-apiVersion: micro.dev/v1
-kind: MCPGateway
-metadata:
-  name: production-gateway
-spec:
-  registry: consul
-  replicas: 3
-  rateLimit:
-    perAgent: 1000/hour
-  observability:
-    otel: true
-    traces: jaeger:14268
-```
-
-#### Helm Charts
- [ ] Official Helm chart for MCP gateway
- [ ] Support for major registries (Consul, etcd, Kubernetes)
- [ ] Ingress/service mesh configuration
- [ ] Secrets management
-
-**Business value:** Easy deployment = faster adoption.
-
-### Performance
- [ ] Connection pooling for high-throughput
- [ ] Response streaming for long-running tools
- [ ] Parallel tool execution when agents make multiple calls
- [ ] Caching layer for idempotent operations
-
-**Target:** Support 10,000 concurrent agent requests on a single gateway.
-
---
-
-## Q4 2026: Ecosystem & Monetization
-
-**Theme:** Build the MCP ecosystem and sustainable business
-
-### Agent Marketplace
-
-Create a marketplace of pre-built AI agents that use go-micro services:
-
-#### Concept
-Developers build agents that solve specific problems using microservices:
-
-**Examples:**
- **Customer Support Agent** - Integrates with users, tickets, orders services
- **DevOps Agent** - Integrates with logs, metrics, deployments services
- **Sales Agent** - Integrates with CRM, leads, analytics services
- **Data Analyst Agent** - Integrates with analytics, reports services
-
-**Format:**
-```yaml
-# agent.yaml
-name: customer-support
-description: AI agent that handles customer support tickets
-services:
-  - users
-  - tickets
-  - orders
-  - payments
-prompts:
-  - system: "You are a helpful customer support agent..."
-  - examples: [...]
-mcp:
-  gateway: "mcp://services.company.com"
-pricing: free|paid
-```
-
-**Usage:**
-```bash
-# Install agent from marketplace
-micro agent install customer-support
-
-# Run agent
-micro agent run customer-support
-
-# Agent now has access to your services via MCP
-```
-
-**Business value:**
- Marketplace fee (15% of paid agents)
- Showcase go-micro capabilities
- Drive framework adoption
-
-### Premium Offerings
-
-Build a sustainable business model around open-source core:
-
-#### Open Source (Free Forever)
- Core framework (`go-micro.dev/v5`)
- Basic MCP gateway (`gateway/mcp`)
- CLI (`micro run`, `micro server`)
- Documentation and examples
- Community support
-
-#### Go Micro Cloud (SaaS)
-**Target:** Teams that want managed MCP gateways
-
-**Features:**
- Managed MCP gateway (no ops required)
- Built-in observability dashboard
- Agent usage analytics
- Multi-region deployment
- 99.9% SLA
- Priority support
-
-**Pricing:**
- Starter: $99/month (10,000 agent calls/month)
- Team: $499/month (100,000 calls/month)
- Enterprise: Custom (millions of calls/month)
-
-**Value proposition:** "Don't run your own MCP gateway. We'll do it for you."
-
-#### Go Micro Enterprise
-**Target:** Large companies deploying at scale
-
-**Features:**
- On-premise MCP gateway
- SSO integration
- Advanced security (mTLS, Vault integration)
- Custom SLAs
- Dedicated support
- Training and consulting
-
-**Pricing:**
- Starting at $10,000/year
- Per-seat licensing or infrastructure-based
-
-**Value proposition:** "Production-grade MCP for your entire organization."
-
-#### Professional Services
- Custom agent development
- Migration from other frameworks
- Architecture consulting
- Training workshops
- Proof-of-concept projects
-
-**Pricing:** $200-300/hour
-
-### Strategic Integrations
-
-#### Anthropic Partnership
- [ ] Official Anthropic integration guide
- [ ] Listed on MCP servers directory
- [ ] Co-marketing blog posts
- [ ] Featured in Claude documentation
- [ ] Joint conference talks
-
-**Why:** Anthropic created MCP. Being their preferred microservices framework drives adoption.
-
-#### OpenAI Integration
- [ ] ChatGPT plugin format support
- [ ] GPTs integration (services as GPT actions)
- [ ] OpenAI Assistants API support
- [ ] Listed in OpenAI plugin store
-
-**Why:** OpenAI has largest AI user base. Tap into that market.
-
-#### Google Gemini
- [ ] Gemini API function calling support
- [ ] Google Cloud integration guide
- [ ] Vertex AI compatibility
-
-#### Microsoft Copilot
- [ ] Copilot Studio integration
- [ ] Azure OpenAI compatibility
- [ ] Teams bot support
-
-**Business value:** Every major AI platform can use go-micro services.
-
-### Community Growth
-
-#### Content Strategy
- [ ] Monthly blog posts (case studies, tutorials)
- [ ] Weekly Twitter/LinkedIn updates
- [ ] YouTube channel (tutorials, demos)
- [ ] Podcast: "Agents & Services" (interview users)
-
-#### Events
- [ ] "AI-Native Microservices" conference (virtual)
- [ ] Monthly community calls
- [ ] Hackathons with prizes
- [ ] Sponsor AI/agent conferences
-
-#### Open Source Program
- [ ] Contributor rewards (swag, recognition)
- [ ] "Agent of the Month" showcase
- [ ] Grant program for open-source agents
- [ ] University partnerships (courses using go-micro)
-
-**Target:** Grow from 5K GitHub stars to 15K+ by end of 2026.
-
---
-
-## 2027: Platform Dominance
-
-**Theme:** The AI-native microservices platform
-
-### Vision: The Agent Operating System
-
-Go Micro becomes the **platform layer between AI and infrastructure**:
-
-```
-┌─────────────────────────────────────┐
-│         AI Agents Layer              │
-│  Claude | GPT | Gemini | Custom     │
-└─────────────────────────────────────┘
-                 ↓ MCP
-┌─────────────────────────────────────┐
-│       Go Micro Platform              │
-│  Gateway | Registry | Auth | Mesh   │
-└─────────────────────────────────────┘
-                 ↓ RPC
-┌─────────────────────────────────────┐
-│      Microservices Layer             │
-│  Users | Orders | Payments | ...    │
-└─────────────────────────────────────┘
-```
-
-### Features
-
-#### Autonomous Service Discovery
- Agents discover services automatically
- AI-generated service integration code
- Self-healing service mesh
- Zero-config multi-cloud
-
-#### Agent Orchestration
- Multi-agent workflows built-in
- Agent-to-agent communication via MCP
- Conflict resolution when agents disagree
- Collaborative agents working on tasks
-
-#### Intelligent Routing
- ML-based service routing (predict best endpoint)
- A/B testing for agents
- Canary deployments driven by agent feedback
- Auto-scaling based on agent behavior
-
-#### Development Copilot
- AI assistant for service development
- Auto-generate services from requirements
- Suggest optimizations
- Detect bugs before deployment
-
-**Example:**
-```bash
-$ micro generate "a user authentication service with JWT"
-
-[AI] Analyzing requirements...
-[AI] Generating service scaffold...
-[AI] Adding JWT auth with RS256...
-[AI] Creating database schema...
-[AI] Writing tests...
-[AI] Service ready: ./auth-service
-
-$ cd auth-service && micro run
-[AI] Service running. MCP-enabled. Try asking Claude to create a user!
-```
-
---
-
-## Business Model Deep Dive
-
-### Revenue Streams
-
-#### 1. Go Micro Cloud (SaaS) - Primary Revenue
-**Target ARR:** $1M Year 1, $5M Year 2
-
-**Customer Segments:**
- **Startups:** Need MCP but don't want to run infrastructure
- **Mid-size companies:** Building AI features, need reliable MCP gateway
- **Enterprises:** Multi-region, high-availability requirements
-
-**Unit Economics:**
- CAC (Customer Acquisition Cost): $500 (content marketing, freemium)
- LTV (Lifetime Value): $12,000 (2-year retention, $500/mo avg)
- LTV:CAC ratio: 24:1 (excellent)
-
-**Growth Strategy:**
- Freemium model (free tier up to 1,000 calls/month)
- Self-service signup
- Upsell to Team/Enterprise based on usage
-
-#### 2. Enterprise Licenses - High Margin
-**Target ARR:** $500K Year 1, $3M Year 2
-
-**Value Proposition:**
- On-premise deployment
- Enterprise support
- Custom SLAs
- Training included
-
-**Typical Deal:**
- $25K-100K/year per company
- 10-20 deals/year = $500K-$2M
-
-#### 3. Professional Services - Consulting
-**Target Revenue:** $250K Year 1, $750K Year 2
-
-**Services:**
- Agent development (build custom agents)
- Migration consulting (move to go-micro)
- Architecture design
- Training workshops
-
-**Pricing:**
- $200-300/hour
- 1,000-2,500 billable hours/year
-
-#### 4. Marketplace - Platform Revenue
-**Target Revenue:** $100K Year 1, $500K Year 2
-
-**Model:**
- Take 15% of paid agent sales
- Host agents for free (community)
- Charge for premium listings
-
-**Growth:**
- 100 agents by end of 2026
- 10% are paid ($10-100/agent)
- Average sale: $50 × 10 agents × 200 customers = $100K gross
- 15% marketplace fee = $15K net
-
-#### Total Revenue Projection
- **Year 1 (2026):** $1.85M
-  - SaaS: $1M
-  - Enterprise: $500K
-  - Services: $250K
-  - Marketplace: $100K
-
- **Year 2 (2027):** $9.25M (5x growth)
-  - SaaS: $5M
-  - Enterprise: $3M
-  - Services: $750K
-  - Marketplace: $500K
-
-### Cost Structure
-
-#### Infrastructure (SaaS)
- Cloud hosting: $50K/year (Year 1) → $250K (Year 2)
- CDN/bandwidth: $10K/year → $50K
- Monitoring/logging: $5K/year → $20K
-
-#### Team
-**Year 1 (Lean):**
- 2 engineers (full-time): $300K
- 1 DevRel: $120K
- 1 part-time designer: $50K
- Founder (you): sweat equity
-
-**Year 2 (Growth):**
- 5 engineers: $750K
- 2 DevRel: $240K
- 1 PM: $150K
- 1 sales: $150K
- 1 designer: $100K
- Founder salary: $150K
-
-#### Marketing
- Content creation: $30K/year
- Conferences/events: $50K/year
- Ads/SEO: $20K/year
-
-#### Total Costs
- **Year 1:** $635K
- **Year 2:** $1.78M
-
-### Profitability
- **Year 1:** $1.85M - $635K = **$1.21M profit** (65% margin)
- **Year 2:** $9.25M - $1.78M = **$7.47M profit** (81% margin)
-
-**Why such high margins?**
- Software = low marginal cost
- Open-source drives adoption (low CAC)
- Self-service model (low sales cost)
- High customer retention (sticky product)
-
-### Funding Strategy
-
-#### Bootstrap Path (Recommended)
- Start with consulting revenue
- Launch SaaS with freemium model
- Grow organically from profits
- No dilution, full control
-
-#### VC Path (If Scaling Faster)
- Raise $2M seed at $8M pre-money
- Deploy for:
-  - 2x engineering team
-  - 2x marketing budget
-  - Faster enterprise sales
- Target: $10M ARR in 18 months
- Series A: $15M at $50M valuation
-
-**Recommendation:** Bootstrap first, then raise Series A if needed for expansion.
-
---
-
-## Success Metrics
-
-### Technical KPIs
- [ ] 95%+ of Claude Desktop users can add go-micro services (stdio MCP)
- [ ] 10,000+ services exposed via MCP in production
- [ ] <100ms p99 latency for tool discovery
- [ ] Support 10K concurrent agent requests per gateway
- [ ] 99.9% MCP gateway uptime
-
-### Business KPIs
- [ ] $1.85M ARR by end of 2026
- [ ] 100+ paying SaaS customers
- [ ] 20+ enterprise deals
- [ ] 15K+ GitHub stars
- [ ] 5K+ Discord members
- [ ] 100+ agents in marketplace
-
-### Community KPIs
- [ ] 50+ conference talks mentioning go-micro + MCP
- [ ] 1M+ blog views
- [ ] 100+ community-contributed examples
- [ ] 20+ case studies published
-
---
-
-## Risk Mitigation
-
-### Technical Risks
-
-**Risk:** MCP protocol changes (Anthropic controls spec)
- **Mitigation:** Stay involved in MCP working group, implement protocol versions
-
-**Risk:** Performance issues at scale
- **Mitigation:** Benchmark early, optimize hot paths, use caching aggressively
-
-**Risk:** Security vulnerabilities in MCP gateway
- **Mitigation:** Security audits, bug bounty program, responsible disclosure
-
-### Business Risks
-
-**Risk:** AI hype dies down
- **Mitigation:** Go Micro still works as regular microservices framework. MCP is additive, not core.
-
-**Risk:** Competitors build MCP support
- **Mitigation:** First-mover advantage, best integration, agent marketplace moat
-
-**Risk:** Cloud providers offer competing solutions
- **Mitigation:** Open source = no vendor lock-in. We're the community choice.
-
-### Market Risks
-
-**Risk:** Enterprises slow to adopt agents
- **Mitigation:** Focus on startups first (faster adoption), build proof points
-
-**Risk:** Different MCP implementations fragment market
- **Mitigation:** Support multiple protocols, be the most compatible
-
---
-
-## Competitive Landscape
-
-### Direct Competitors
- **Spring Boot** - Java, no MCP support (yet)
- **Express.js** - JavaScript, minimal microservices support
- **gRPC-based frameworks** - No MCP support
-
-**Our advantage:** First-mover in MCP + microservices space.
-
-### Indirect Competitors
- **API Gateway vendors** (Kong, Tyk) - Could add MCP support
- **Service meshes** (Istio, Linkerd) - Focus on ops, not AI
-
-**Our advantage:** Purpose-built for agent integration, not retrofitted.
-
-### Potential Threats
- **AWS/GCP/Azure** building managed MCP gateways
- **Anthropic** launching their own microservices framework
-
-**Defense:**
- Open source = community ownership
- Best DX (developer experience)
- Agent marketplace = network effects
-
---
-
-## Key Integrations Priority
-
-### Tier 1: Must-Have (Q2 2026)
-1. **Claude Desktop** (stdio MCP) - Anthropic's flagship IDE
-2. **ChatGPT Plugins** - Largest user base
-3. **Kubernetes** - Production deployment
-4. **OpenTelemetry** - Observability standard
-
-### Tier 2: Important (Q3 2026)
-5. **LangChain** - Popular agent framework
-6. **Google Gemini** - Major AI player
-7. **Consul/etcd** - Service discovery for enterprise
-8. **Vault** - Secrets management
-
-### Tier 3: Nice-to-Have (Q4 2026)
-9. **LlamaIndex** - RAG and data
-10. **AutoGPT** - Autonomous agents
-11. **Microsoft Copilot** - Enterprise AI
-12. **AWS Bedrock** - Multi-model platform
-
---
-
-## Sustainability Principles
-
-### Open Source Sustainability
-1. **Core stays free** - Framework, basic MCP, CLI always open source
-2. **Community-first** - Features users want, not just what we want to build
-3. **Transparent roadmap** - This document is public
-4. **Contributor recognition** - Credit and compensation for contributions
-
-### Business Sustainability
-1. **Clear value ladder** - Free → SaaS → Enterprise (logical upgrade path)
-2. **High margins** - Software business scales without linear costs
-3. **Multiple revenue streams** - Don't depend on one customer segment
-4. **Profitable by default** - Revenue exceeds costs from Year 1
-
-### Technical Sustainability
-1. **Backward compatibility** - No breaking changes in v5.x
-2. **Stable interfaces** - MCP gateway API won't change unexpectedly
-3. **Performance first** - Fast by default, not through hacks
-4. **Documentation** - Every feature is documented
-
---
-
-## Call to Action
-
-### For Contributors
- Pick a roadmap item
- Open an issue to discuss
- Submit a PR
- Join Discord for coordination
-
-### For Users
- Try MCP with your services
- Share feedback (what works, what doesn't)
- Write case studies
- Star the repo ⭐
-
-### For Companies
- Become a design partner (help shape roadmap)
- Pilot Go Micro Cloud (early access)
- Sponsor development (your priorities get built first)
- Hire us for consulting
-
-### For Investors
- This is a $100M+ opportunity
- Agents need microservices
- We're the first to bridge them
- Contact: [your-email]
-
---
-
-## Conclusion
-
-**The future of microservices is AI-native.**
-
-API gateways connected apps to services.
-MCP connects agents to services.
-
-Go Micro is uniquely positioned to own this space:
- ✅ First MCP integration in a major framework
- ✅ Library-first (not just CLI)
- ✅ Production-ready from day one
- ✅ Clear path to monetization
-
-**The question isn't whether agents will use microservices.**
-**The question is: which framework will they use?**
-
-Let's make it Go Micro.
-
---
-
-**Next Steps:**
-1. Review this roadmap with community (GitHub Discussions)
-2. Prioritize Q2 2026 items based on feedback
-3. Start building (stdio MCP first)
-4. Launch Go Micro Cloud beta
-5. Ship fast, iterate faster
-
-**Questions? Feedback?**
- GitHub Discussions: https://github.com/micro/go-micro/discussions
- Discord: https://discord.gg/jwTYuUVAGh
-
---
-
-_This roadmap is a living document. It will evolve based on market feedback, technical discoveries, and community input. Last updated: February 2026._
@@ -1,179 +0,0 @@
-# Security Policy
-
-## Supported Versions
-
-We actively support the following versions of go-micro:
-
-| Version | Supported          |
-| ------- | ------------------ |
-| 5.x     | :white_check_mark: |
-| 4.x     | :x:                |
-| 3.x     | :x:                |
-| < 3.0   | :x:                |
-
-## Reporting a Vulnerability
-
-**Please do not report security vulnerabilities through public GitHub issues.**
-
-### How to Report
-
-Send security vulnerability reports to: **security@go-micro.dev**
-
-Or use GitHub's private security advisory feature:
-https://github.com/micro/go-micro/security/advisories/new
-
-### What to Include
-
-Please include as much of the following information as possible:
-
- Type of vulnerability (e.g., RCE, XSS, SQL injection, etc.)
- Full paths of source file(s) related to the vulnerability
- Location of the affected source code (tag/branch/commit or direct URL)
- Step-by-step instructions to reproduce the issue
- Proof-of-concept or exploit code (if possible)
- Impact of the issue, including how an attacker might exploit it
-
-### Response Timeline
-
- **Acknowledgment**: Within 48 hours
- **Initial Assessment**: Within 5 business days
- **Fix Timeline**: Depends on severity
-  - Critical: 7 days
-  - High: 14 days
-  - Medium: 30 days
-  - Low: Next release cycle
-
-### Disclosure Policy
-
- We follow **coordinated disclosure**
- We'll work with you to understand and fix the issue
- We'll credit you in the security advisory (unless you prefer to remain anonymous)
- Please give us reasonable time to fix before public disclosure
- We'll publish a security advisory on GitHub when the fix is released
-
-## Security Best Practices
-
-When using go-micro in production:
-
-### TLS/Transport Security
-
-```go
-import "go-micro.dev/v5/transport"
-
-// Enable TLS verification (recommended)
-os.Setenv("MICRO_TLS_SECURE", "true")
-
-// Or use SecureConfig explicitly
-tlsConfig := transport.SecureConfig()
-```
-
-See [TLS Security Update](internal/website/docs/TLS_SECURITY_UPDATE.md) for details.
-
-### Authentication
-
-```go
-import "go-micro.dev/v5/auth"
-
-// Use JWT authentication
-service := micro.NewService(
-    micro.Auth(auth.NewAuth()),
-)
-```
-
-### Input Validation
-
-Always validate and sanitize inputs in your handlers:
-
-```go
-func (h *Handler) Create(ctx context.Context, req *Request, rsp *Response) error {
-    // Validate input
-    if req.Name == "" {
-        return errors.BadRequest("handler.create", "name is required")
-    }
-    
-    // Sanitize and process
-    // ...
-}
-```
-
-### Rate Limiting
-
-Implement rate limiting for public-facing services:
-
-```go
-import "go-micro.dev/v5/client"
-
-// Client-side rate limiting
-client.NewClient(
-    client.RequestTimeout(time.Second * 5),
-    client.Retries(3),
-)
-```
-
-### Secrets Management
-
-Never commit secrets to version control:
-
-```go
-// Good: Use environment variables
-apiKey := os.Getenv("API_KEY")
-
-// Better: Use a secrets manager
-import "github.com/hashicorp/vault/api"
-```
-
-### Dependency Security
-
-Regularly update dependencies:
-
-```bash
-# Check for vulnerabilities
-go list -json -m all | nancy sleuth
-
-# Update dependencies
-go get -u ./...
-go mod tidy
-```
-
-## Known Security Considerations
-
-### Reflection Usage
-
-go-micro uses reflection for automatic handler registration. While this is a deliberate design choice for developer productivity, be aware:
-
- Type safety is enforced at runtime, not compile time
- Malformed requests won't crash services (errors are returned)
- See [Performance Considerations](internal/website/docs/performance.md)
-
-### TLS Certificate Verification
-
-**Default behavior in v5**: TLS certificate verification is **disabled** for backward compatibility.
-
-**Production recommendation**: Enable secure mode:
-
-```bash
-export MICRO_TLS_SECURE=true
-```
-
-This will be the default in v6.
-
-## Security Updates
-
-Security updates are published as:
- GitHub Security Advisories
- Release notes with `[SECURITY]` prefix
- CVE entries for critical issues
-
-Subscribe to releases: https://github.com/micro/go-micro/releases
-
-## Bug Bounty
-
-We currently do not offer a bug bounty program, but we greatly appreciate responsible disclosure and will publicly credit researchers who report valid security issues.
-
-## Questions?
-
-For security questions that are not vulnerabilities, please:
- Open a discussion: https://github.com/micro/go-micro/discussions
- Join Discord: https://discord.gg/jwTYuUVAGh
- Email: support@go-micro.dev
-
@@ -1,345 +0,0 @@
-# Auth Package Analysis
-
-## Current Status: ✅ Fully Functional
-
-The auth package is now **production-ready** with complete server/client wrappers and integration examples.
-
---
-
-## ✅ What Exists
-
-### 1. Core Interfaces (`auth.go`)
-
-```go
-type Auth interface {
-    Generate(id string, opts ...GenerateOption) (*Account, error)
-    Inspect(token string) (*Account, error)
-    Token(opts ...TokenOption) (*Token, error)
-}
-
-type Rules interface {
-    Verify(acc *Account, res *Resource, opts ...VerifyOption) error
-    Grant(rule *Rule) error
-    Revoke(rule *Rule) error
-    List(...ListOption) ([]*Rule, error)
-}
-```
-
-**Status:** ✅ Well-designed, complete
-
-### 2. Data Types
-
- `Account` - represents authenticated user/service
- `Token` - access/refresh token pair
- `Resource` - service endpoint to protect
- `Rule` - access control rule
- `Access` - grant/deny enum
-
-**Status:** ✅ Complete
-
-### 3. Implementations
-
-**Noop Auth** (`noop.go`):
- For development/testing
- Always grants access
- No actual authentication
-
-**Status:** ✅ Works for dev
-
-**JWT Auth** (`jwt/jwt.go`):
- Uses RSA keys for signing
- Generates and verifies JWT tokens
- **⚠️ Problem:** Depends on external plugin `github.com/micro/plugins/v5/auth/jwt/token`
-
-**Status:** ⚠️ External dependency
-
-### 4. Authorization Logic (`rules.go`)
-
- Rule-based access control (RBAC)
- Supports wildcards (`*`)
- Priority-based rule evaluation
- Scope-based permissions
-
-**Status:** ✅ Complete and tested
-
---
-
-## ✅ Recently Completed
-
-### 1. **Service Integration Wrapper** ✅
-
-**Status:** IMPLEMENTED in `wrapper/auth/server.go`
-
-```go
-// AuthHandler wraps a service to enforce authentication
-func AuthHandler(opts HandlerOptions) server.HandlerWrapper
-func PublicEndpoints(...) HandlerOptions
-func AuthRequired(...) HandlerOptions
-func AuthOptional(authProvider auth.Auth) server.HandlerWrapper
-```
-
-Features:
- Token extraction from metadata
- Token verification with auth.Inspect()
- Authorization checks with rules.Verify()
- Account injection into context
- Skip endpoints support
- Comprehensive error handling (401/403)
-
-### 2. **Client Wrapper** ✅
-
-**Status:** IMPLEMENTED in `wrapper/auth/client.go`
-
-```go
-// AuthClient adds authentication tokens to client requests
-func AuthClient(opts ClientOptions) client.Wrapper
-func FromToken(token string) client.Wrapper
-func FromContext(authProvider auth.Auth) client.Wrapper
-```
-
-Features:
- Automatic token injection
- Static token support
- Dynamic token generation from context
- Works with Call, Stream, and Publish
-
-### 3. **Metadata Helpers** ✅
-
-**Status:** IMPLEMENTED in `wrapper/auth/metadata.go`
-
-```go
-// Standard token extraction and injection
-func TokenFromMetadata(md metadata.Metadata) (string, error)
-func TokenToMetadata(md metadata.Metadata, token string) metadata.Metadata
-func AccountFromMetadata(md metadata.Metadata, a auth.Auth) (*auth.Account, error)
-```
-
-Features:
- Bearer token extraction
- Case-insensitive header lookup
- Token format validation
- Direct account extraction
-
-### 6. **Standalone JWT Implementation** ⚠️
-
-**Status:** Partially complete (low priority)
-
-Current JWT auth in `auth/jwt/jwt.go` depends on external plugin:
-```go
-jwtToken "github.com/micro/plugins/v5/auth/jwt/token"
-```
-
-**Note:** This is NOT a blocker. The wrappers work with any auth.Auth implementation including:
- JWT auth (with plugin dependency)
- Noop auth (for development)
- Custom auth implementations
-
-**Future improvement:** Create self-contained JWT implementation to remove plugin dependency.
-
-### 4. **Examples** ✅
-
-**Status:** IMPLEMENTED in `examples/auth/`
-
-Complete working example with:
- Protected Greeter service (server/)
- Client with authentication (client/)
- Proto definitions (proto/)
- Comprehensive README with:
-  - Architecture diagrams
-  - Code walkthrough
-  - Auth strategies
-  - Authorization rules
-  - Testing guide
-  - Production considerations
-  - Troubleshooting guide
-
-### 5. **Documentation** ✅
-
-**Status:** IMPLEMENTED
-
-Complete documentation:
- `wrapper/auth/README.md` - Full API reference (200+ lines)
- `examples/auth/README.md` - Integration tutorial (400+ lines)
- Server wrapper documentation with examples
- Client wrapper documentation with examples
- Metadata helpers API reference
- Best practices guide
- Troubleshooting guide
- Production considerations
-
---
-
-## 🔍 Detailed Analysis
-
-### JWT Implementation Dependency Issue
-
-File: `auth/jwt/jwt.go:7`
-```go
-jwtToken "github.com/micro/plugins/v5/auth/jwt/token"
-```
-
-This depends on:
- `github.com/micro/plugins` repository
- Must be separately installed
- May not be maintained
- Breaks self-contained promise
-
-**Recommendation:** Create standalone JWT implementation in `auth/jwt/token/`
-
-### Rules Verification Works Well
-
-The `Verify()` function in `rules.go` is well-implemented:
- ✅ Handles wildcards correctly
- ✅ Priority-based evaluation
- ✅ Supports resource hierarchies (e.g., `/foo/*` matches `/foo/bar`)
- ✅ Public vs authenticated vs scoped access
- ✅ Tested (see `rules_test.go`)
-
-### Context Integration Exists
-
-```go
-// From auth.go
-func AccountFromContext(ctx context.Context) (*Account, bool)
-func ContextWithAccount(ctx context.Context, account *Account) context.Context
-```
-
-This is ready to use once wrappers are implemented.
-
---
-
-## 🛠️ Implementation Status
-
-### Phase 1: Critical ✅ COMPLETE
-
-1. ✅ **Server Wrapper** - `wrapper/auth/server.go`
-   - Token extraction from metadata
-   - Verification with auth.Inspect()
-   - Authorization with rules.Verify()
-   - Skip endpoints support
-   - Helper functions (AuthRequired, PublicEndpoints, AuthOptional)
-
-2. ✅ **Client Wrapper** - `wrapper/auth/client.go`
-   - Adds Authorization header/metadata
-   - Static token support (FromToken)
-   - Dynamic token generation (FromContext)
-   - Works with Call, Stream, Publish
-
-3. ✅ **Metadata Helpers** - `wrapper/auth/metadata.go`
-   - TokenFromMetadata - extract Bearer token
-   - TokenToMetadata - inject Bearer token
-   - AccountFromMetadata - extract and verify in one step
-
-### Phase 2: Important ✅ COMPLETE
-
-4. ⚠️ **Standalone JWT Implementation** - Deferred (not critical)
-   - Current JWT works with plugin
-   - Can use noop auth for development
-   - Future enhancement to remove plugin dependency
-
-5. ⚠️ **Key Generation Utilities** - Deferred (not critical)
-   - JWT auth handles key management
-   - Future enhancement for convenience
-
-6. ✅ **Examples** - `examples/auth/`
-   - Complete server/client example
-   - Protected and public endpoints
-   - Comprehensive README (400+ lines)
-   - Code walkthrough and best practices
-
-### Phase 3: Production Ready ✅ COMPLETE
-
-7. ⚠️ **Advanced Examples** - Future enhancement
-   - Basic example covers most use cases
-   - Can be added based on demand
-
-8. ✅ **Documentation**
-   - `wrapper/auth/README.md` - Full API reference
-   - `examples/auth/README.md` - Integration guide
-   - Best practices and troubleshooting
-
-9. ✅ **Testing Utilities**
-   - Noop auth for tests
-   - Token generation examples in docs
-
---
-
-## 📋 Integration Checklist
-
-To use auth with services, users need:
-
- [x] Auth interface and implementations
- [x] **Server wrapper to enforce auth** ✅
- [x] **Client wrapper to send auth** ✅
- [x] Metadata helpers ✅
- [x] Examples showing integration ✅
- [x] Documentation ✅
- [~] Working JWT implementation (has plugin dependency, not critical)
-
-**Current completeness: ~95%** 🎉
-
-The auth system is now fully functional and production-ready!
-
---
-
-## 💡 Recommendations
-
-### ✅ Completed
-
-1. ✅ **Created wrapper/auth package** with server and client wrappers
-2. ✅ **Wrote comprehensive examples** showing protected service
-3. ✅ **Documented** integration patterns with 600+ lines of docs
-
-### Optional Future Enhancements
-
-4. **Remove plugin dependency** - create standalone JWT
-   - Current solution works fine with plugin
-   - Would reduce external dependencies
-   - Priority: Low
-
-5. **Add to CLI** - `micro auth` commands for token management
-   - Generate tokens from CLI
-   - Inspect tokens
-   - Manage accounts
-   - Priority: Medium
-
-6. **OAuth2 provider** - for enterprise SSO
-   - Integration with external identity providers
-   - Priority: Low (can use custom auth provider)
-
-7. **API key auth** - simpler alternative to JWT
-   - For machine-to-machine auth
-   - Priority: Low
-
-8. **Audit logging** - track auth events
-   - Who accessed what and when
-   - Priority: Medium
-
-9. **Rate limiting** - per account/scope
-   - Prevent abuse
-   - Priority: Medium
-
---
-
-## 🎉 Status: Auth System Complete
-
-The auth system is now **fully functional and production-ready**!
-
-**What's available:**
- ✅ Server wrapper for enforcing auth
- ✅ Client wrapper for adding auth
- ✅ Metadata helpers for token handling
- ✅ Complete working example
- ✅ Comprehensive documentation
- ✅ Best practices guide
- ✅ Troubleshooting guide
-
-**Usage:**
-```go
-// Server
-micro.WrapHandler(authWrapper.AuthHandler(...))
-
-// Client
-micro.WrapClient(authWrapper.FromToken(...))
-```
-
-See `examples/auth/` for complete working code!
@@ -1,45 +0,0 @@
-// Package noop provides a no-op auth implementation for testing and development.
-//
-// The noop auth provider:
-// - Accepts any token (always returns a valid account)
-// - Grants all permissions (no actual authorization)
-// - Generates tokens (but doesn't verify them)
-//
-// This is useful for:
-// - Local development
-// - Testing
-// - Prototyping
-//
-// DO NOT use in production. Use JWT auth or implement a custom auth provider instead.
-package noop
-
-import (
-	"go-micro.dev/v5/auth"
-)
-
-// NewAuth returns a new noop auth provider.
-//
-// The noop provider accepts all tokens and grants all permissions.
-// This is for development and testing only - DO NOT use in production.
-//
-// Example:
-//
-//	authProvider := noop.NewAuth()
-//	account, _ := authProvider.Generate("user123")
-//	token, _ := authProvider.Token(auth.WithCredentials(account.ID, account.Secret))
-func NewAuth(opts ...auth.Option) auth.Auth {
-	return auth.NewAuth(opts...)
-}
-
-// NewRules returns a new noop rules implementation.
-//
-// The noop rules implementation grants all access and doesn't enforce any rules.
-// This is for development and testing only.
-//
-// Example:
-//
-//	rules := noop.NewRules()
-//	err := rules.Verify(account, resource) // Always returns nil
-func NewRules() auth.Rules {
-	return auth.NewRules()
-}
@@ -74,12 +74,14 @@ var (
 )

 func init() {
+	rand.Seed(time.Now().Unix())
 }

 func newTransport(config *tls.Config) *http.Transport {
 	if config == nil {
-		// Use environment-based config - secure by default
-		config = mls.Config()
+		config = &tls.Config{
+			InsecureSkipVerify: true,
+		}
 	}

 	dialTLS := func(network string, addr string) (net.Conn, error) {
@@ -5,6 +5,7 @@ import (
 	"errors"
 	"math/rand"
 	"sync"
+	"time"

 	"github.com/google/uuid"
 	log "go-micro.dev/v5/logger"
@@ -222,6 +223,8 @@ func (m *memorySubscriber) Unsubscribe() error {
 func NewMemoryBroker(opts ...Option) Broker {
 	options := NewOptions(opts...)

+	rand.Seed(time.Now().UnixNano())
+
 	return &memoryBroker{
 		opts:        options,
 		Subscribers: make(map[string][]*memorySubscriber),
@@ -6,7 +6,6 @@ import (
 	"errors"
 	"strings"
 	"sync"
-	"time"

 	natsp "github.com/nats-io/nats.go"
 	"go-micro.dev/v5/broker"
@@ -23,15 +22,10 @@ type natsBroker struct {
 	connected bool

 	addrs []string
-	conn  *natsp.Conn     // single connection (used when pool is disabled)
-	pool  *connectionPool // connection pool (used when pooling is enabled)
+	conn  *natsp.Conn
 	opts  broker.Options
 	nopts natsp.Options

-	// pool configuration
-	poolSize        int
-	poolIdleTimeout time.Duration
-
 	// should we drain the connection
 	drain   bool
 	closeCh chan (error)
@@ -115,39 +109,6 @@ func (n *natsBroker) Connect() error {
 		return nil
 	}

-	// Check if we should use connection pooling
-	if n.poolSize > 1 {
-		// Initialize connection pool
-		factory := func() (*natsp.Conn, error) {
-			opts := n.nopts
-			opts.Servers = n.addrs
-			opts.Secure = n.opts.Secure
-			opts.TLSConfig = n.opts.TLSConfig
-
-			// secure might not be set
-			if n.opts.TLSConfig != nil {
-				opts.Secure = true
-			}
-
-			return opts.Connect()
-		}
-
-		pool, err := newConnectionPool(n.poolSize, factory)
-		if err != nil {
-			return err
-		}
-
-		// Set idle timeout if configured
-		if n.poolIdleTimeout > 0 {
-			pool.idleTimeout = n.poolIdleTimeout
-		}
-
-		n.pool = pool
-		n.connected = true
-		return nil
-	}
-
-	// Single connection mode (original behavior)
 	status := natsp.CLOSED
 	if n.conn != nil {
 		status = n.conn.Status()
@@ -182,26 +143,14 @@ func (n *natsBroker) Disconnect() error {
 	n.Lock()
 	defer n.Unlock()

-	// Close connection pool if it exists
-	if n.pool != nil {
-		if err := n.pool.Close(); err != nil {
-			n.opts.Logger.Log(logger.ErrorLevel, "error closing connection pool:", err)
-		}
-		n.pool = nil
+	// drain the connection if specified
+	if n.drain {
+		n.conn.Drain()
+		n.closeCh <- nil
 	}

-	// Close single connection if it exists
-	if n.conn != nil {
-		// drain the connection if specified
-		if n.drain {
-			n.conn.Drain()
-			n.closeCh <- nil
-		}
-
-		// close the client connection
-		n.conn.Close()
-		n.conn = nil
-	}
+	// close the client connection
+	n.conn.Close()

 	// set not connected
 	n.connected = false
@@ -222,42 +171,24 @@ func (n *natsBroker) Publish(topic string, msg *broker.Message, opts ...broker.P
 	n.RLock()
 	defer n.RUnlock()

-	b, err := n.opts.Codec.Marshal(msg)
-	if err != nil {
-		return err
-	}
-
-	// Use connection pool if enabled
-	if n.pool != nil {
-		poolConn, err := n.pool.Get()
-		if err != nil {
-			return err
-		}
-		defer n.pool.Put(poolConn)
-
-		conn := poolConn.Conn()
-		if conn == nil {
-			return errors.New("invalid connection from pool")
-		}
-		return conn.Publish(topic, b)
-	}
-
-	// Use single connection (original behavior)
 	if n.conn == nil {
 		return errors.New("not connected")
 	}

+	b, err := n.opts.Codec.Marshal(msg)
+	if err != nil {
+		return err
+	}
 	return n.conn.Publish(topic, b)
 }

 func (n *natsBroker) Subscribe(topic string, handler broker.Handler, opts ...broker.SubscribeOption) (broker.Subscriber, error) {
 	n.RLock()
-	hasConnection := n.conn != nil || n.pool != nil
-	n.RUnlock()
-
-	if !hasConnection {
+	if n.conn == nil {
+		n.RUnlock()
 		return nil, errors.New("not connected")
 	}
+	n.RUnlock()

 	opt := broker.SubscribeOptions{
 		AutoAck: true,
@@ -295,38 +226,6 @@ func (n *natsBroker) Subscribe(topic string, handler broker.Handler, opts ...bro
 	var sub *natsp.Subscription
 	var err error

-	// Use connection pool if enabled
-	if n.pool != nil {
-		poolConn, err := n.pool.Get()
-		if err != nil {
-			return nil, err
-		}
-
-		conn := poolConn.Conn()
-		if conn == nil {
-			n.pool.Put(poolConn)
-			return nil, errors.New("invalid connection from pool")
-		}
-
-		if len(opt.Queue) > 0 {
-			sub, err = conn.QueueSubscribe(topic, opt.Queue, fn)
-		} else {
-			sub, err = conn.Subscribe(topic, fn)
-		}
-
-		if err != nil {
-			n.pool.Put(poolConn)
-			return nil, err
-		}
-
-		// Return connection to pool after subscription is created
-		// The subscription keeps the connection alive
-		n.pool.Put(poolConn)
-
-		return &subscriber{s: sub, opts: opt}, nil
-	}
-
-	// Use single connection (original behavior)
 	n.RLock()
 	if len(opt.Queue) > 0 {
 		sub, err = n.conn.QueueSubscribe(topic, opt.Queue, fn)
@@ -351,24 +250,12 @@ func (n *natsBroker) setOption(opts ...broker.Option) {

 	n.Once.Do(func() {
 		n.nopts = natsp.GetDefaultOptions()
-		n.poolSize = 1 // Default to single connection (no pooling)
-		n.poolIdleTimeout = 5 * time.Minute
 	})

 	if nopts, ok := n.opts.Context.Value(optionsKey{}).(natsp.Options); ok {
 		n.nopts = nopts
 	}

-	// Set pool size if configured
-	if poolSize, ok := n.opts.Context.Value(poolSizeKey{}).(int); ok && poolSize > 0 {
-		n.poolSize = poolSize
-	}
-
-	// Set pool idle timeout if configured
-	if idleTimeout, ok := n.opts.Context.Value(poolIdleTimeoutKey{}).(time.Duration); ok {
-		n.poolIdleTimeout = idleTimeout
-	}
-
 	// broker.Options have higher priority than nats.Options
 	// only if Addrs, Secure or TLSConfig were not set through a broker.Option
 	// we read them from nats.Option
@@ -1,16 +1,12 @@
 package nats

 import (
-	"time"
-
 	natsp "github.com/nats-io/nats.go"
 	"go-micro.dev/v5/broker"
 )

 type optionsKey struct{}
 type drainConnectionKey struct{}
-type poolSizeKey struct{}
-type poolIdleTimeoutKey struct{}

 // Options accepts nats.Options.
 func Options(opts natsp.Options) broker.Option {
@@ -21,17 +17,3 @@ func Options(opts natsp.Options) broker.Option {
 func DrainConnection() broker.Option {
 	return setBrokerOption(drainConnectionKey{}, struct{}{})
 }
-
-// PoolSize sets the size of the connection pool.
-// If set to a value > 1, the broker will use a connection pool.
-// Default is 1 (no pooling).
-func PoolSize(size int) broker.Option {
-	return setBrokerOption(poolSizeKey{}, size)
-}
-
-// PoolIdleTimeout sets the timeout for idle connections in the pool.
-// Connections idle for longer than this duration will be closed.
-// Default is 5 minutes. Set to 0 to disable idle timeout.
-func PoolIdleTimeout(timeout time.Duration) broker.Option {
-	return setBrokerOption(poolIdleTimeoutKey{}, timeout)
-}
@@ -1,188 +0,0 @@
-package nats
-
-import (
-	"errors"
-	"sync"
-	"time"
-
-	natsp "github.com/nats-io/nats.go"
-)
-
-var (
-	// ErrPoolExhausted is returned when no connections are available in the pool
-	ErrPoolExhausted = errors.New("connection pool exhausted")
-	// ErrPoolClosed is returned when trying to use a closed pool
-	ErrPoolClosed = errors.New("connection pool is closed")
-)
-
-// connectionPool manages a pool of NATS connections
-type connectionPool struct {
-	mu          sync.RWMutex
-	connections chan *pooledConnection
-	factory     func() (*natsp.Conn, error)
-	size        int
-	idleTimeout time.Duration
-	closed      bool
-}
-
-// pooledConnection wraps a NATS connection with metadata
-type pooledConnection struct {
-	conn      *natsp.Conn
-	createdAt time.Time
-	lastUsed  time.Time
-	mu        sync.Mutex
-}
-
-// newConnectionPool creates a new connection pool
-func newConnectionPool(size int, factory func() (*natsp.Conn, error)) (*connectionPool, error) {
-	if size <= 0 {
-		size = 1
-	}
-
-	pool := &connectionPool{
-		connections: make(chan *pooledConnection, size),
-		factory:     factory,
-		size:        size,
-		idleTimeout: 5 * time.Minute,
-		closed:      false,
-	}
-
-	return pool, nil
-}
-
-// Get retrieves a connection from the pool or creates a new one
-func (p *connectionPool) Get() (*pooledConnection, error) {
-	p.mu.RLock()
-	if p.closed {
-		p.mu.RUnlock()
-		return nil, ErrPoolClosed
-	}
-	p.mu.RUnlock()
-
-	// Try to get an existing connection from the pool
-	select {
-	case conn := <-p.connections:
-		// Check if connection is still valid and not idle for too long
-		if conn.isValid() && !conn.isExpired(p.idleTimeout) {
-			conn.updateLastUsed()
-			return conn, nil
-		}
-		// Connection is invalid or expired, close it and create a new one
-		conn.close()
-		return p.createConnection()
-	default:
-		// No connection available, create a new one
-		return p.createConnection()
-	}
-}
-
-// Put returns a connection to the pool
-func (p *connectionPool) Put(conn *pooledConnection) error {
-	p.mu.RLock()
-	defer p.mu.RUnlock()
-
-	if p.closed {
-		return conn.close()
-	}
-
-	// Check if connection is still valid
-	if !conn.isValid() {
-		return conn.close()
-	}
-
-	conn.updateLastUsed()
-
-	// Try to return connection to pool
-	select {
-	case p.connections <- conn:
-		return nil
-	default:
-		// Pool is full, close the connection
-		return conn.close()
-	}
-}
-
-// Close closes all connections in the pool
-func (p *connectionPool) Close() error {
-	p.mu.Lock()
-	defer p.mu.Unlock()
-
-	if p.closed {
-		return nil
-	}
-
-	p.closed = true
-	close(p.connections)
-
-	// Close all connections in the pool
-	for conn := range p.connections {
-		conn.close()
-	}
-
-	return nil
-}
-
-// createConnection creates a new pooled connection
-func (p *connectionPool) createConnection() (*pooledConnection, error) {
-	conn, err := p.factory()
-	if err != nil {
-		return nil, err
-	}
-
-	return &pooledConnection{
-		conn:      conn,
-		createdAt: time.Now(),
-		lastUsed:  time.Now(),
-	}, nil
-}
-
-// isValid checks if the underlying NATS connection is valid
-func (pc *pooledConnection) isValid() bool {
-	pc.mu.Lock()
-	defer pc.mu.Unlock()
-
-	if pc.conn == nil {
-		return false
-	}
-
-	status := pc.conn.Status()
-	return status == natsp.CONNECTED || status == natsp.RECONNECTING
-}
-
-// isExpired checks if the connection has been idle for too long
-func (pc *pooledConnection) isExpired(timeout time.Duration) bool {
-	pc.mu.Lock()
-	defer pc.mu.Unlock()
-
-	if timeout <= 0 {
-		return false
-	}
-
-	return time.Since(pc.lastUsed) > timeout
-}
-
-// close closes the underlying NATS connection
-func (pc *pooledConnection) close() error {
-	pc.mu.Lock()
-	defer pc.mu.Unlock()
-
-	if pc.conn != nil {
-		pc.conn.Close()
-		pc.conn = nil
-	}
-	return nil
-}
-
-// Conn returns the underlying NATS connection
-func (pc *pooledConnection) Conn() *natsp.Conn {
-	pc.mu.Lock()
-	defer pc.mu.Unlock()
-	return pc.conn
-}
-
-// updateLastUsed updates the last used timestamp in a thread-safe manner
-func (pc *pooledConnection) updateLastUsed() {
-	pc.mu.Lock()
-	defer pc.mu.Unlock()
-	pc.lastUsed = time.Now()
-}
@@ -1,204 +0,0 @@
-package nats
-
-import (
-	"sync"
-	"testing"
-	"time"
-
-	natsp "github.com/nats-io/nats.go"
-)
-
-func TestConnectionPool_GetPut(t *testing.T) {
-	// Mock factory that creates connections
-	connCount := 0
-	factory := func() (*natsp.Conn, error) {
-		connCount++
-		// Return a mock connection (we can't create real NATS connections in tests without a server)
-		// This test is more about the pool logic
-		return nil, nil
-	}
-
-	pool, err := newConnectionPool(3, factory)
-	if err != nil {
-		t.Fatalf("Failed to create pool: %v", err)
-	}
-	defer pool.Close()
-
-	// Get a connection (should create one)
-	conn1, err := pool.Get()
-	if err != nil {
-		t.Fatalf("Failed to get connection: %v", err)
-	}
-	if conn1 == nil {
-		t.Fatal("Expected connection, got nil")
-	}
-
-	// Put it back
-	if err := pool.Put(conn1); err != nil {
-		t.Fatalf("Failed to put connection: %v", err)
-	}
-
-	// Get it again (should reuse the same one)
-	conn2, err := pool.Get()
-	if err != nil {
-		t.Fatalf("Failed to get connection: %v", err)
-	}
-
-	// Since we can't compare actual connections easily, just verify we got one
-	if conn2 == nil {
-		t.Fatal("Expected connection, got nil")
-	}
-}
-
-func TestConnectionPool_Concurrent(t *testing.T) {
-	connCount := 0
-	mu := sync.Mutex{}
-	factory := func() (*natsp.Conn, error) {
-		mu.Lock()
-		connCount++
-		mu.Unlock()
-		return nil, nil
-	}
-
-	pool, err := newConnectionPool(5, factory)
-	if err != nil {
-		t.Fatalf("Failed to create pool: %v", err)
-	}
-	defer pool.Close()
-
-	// Simulate concurrent access
-	var wg sync.WaitGroup
-	for i := 0; i < 10; i++ {
-		wg.Add(1)
-		go func() {
-			defer wg.Done()
-			conn, err := pool.Get()
-			if err != nil {
-				t.Errorf("Failed to get connection: %v", err)
-				return
-			}
-			// Simulate some work
-			time.Sleep(10 * time.Millisecond)
-			if err := pool.Put(conn); err != nil {
-				t.Errorf("Failed to put connection: %v", err)
-			}
-		}()
-	}
-
-	wg.Wait()
-
-	// We should have created some connections
-	mu.Lock()
-	if connCount == 0 {
-		t.Error("Expected at least one connection to be created")
-	}
-	mu.Unlock()
-}
-
-func TestConnectionPool_Close(t *testing.T) {
-	factory := func() (*natsp.Conn, error) {
-		return nil, nil
-	}
-
-	pool, err := newConnectionPool(3, factory)
-	if err != nil {
-		t.Fatalf("Failed to create pool: %v", err)
-	}
-
-	// Get a connection
-	conn, err := pool.Get()
-	if err != nil {
-		t.Fatalf("Failed to get connection: %v", err)
-	}
-
-	// Close the pool
-	if err := pool.Close(); err != nil {
-		t.Fatalf("Failed to close pool: %v", err)
-	}
-
-	// Put connection back to closed pool should not panic
-	// The connection will be closed instead of returned to pool
-	_ = pool.Put(conn)
-
-	// Try to get from closed pool
-	_, err = pool.Get()
-	if err != ErrPoolClosed {
-		t.Errorf("Expected ErrPoolClosed, got: %v", err)
-	}
-}
-
-func TestPooledConnection_IsValid(t *testing.T) {
-	pc := &pooledConnection{
-		conn:      nil, // nil connection should be invalid
-		createdAt: time.Now(),
-		lastUsed:  time.Now(),
-	}
-
-	if pc.isValid() {
-		t.Error("Expected nil connection to be invalid")
-	}
-}
-
-func TestPooledConnection_IsExpired(t *testing.T) {
-	pc := &pooledConnection{
-		conn:      nil,
-		createdAt: time.Now(),
-		lastUsed:  time.Now().Add(-10 * time.Minute), // 10 minutes ago
-	}
-
-	// With 5 minute timeout, should be expired
-	if !pc.isExpired(5 * time.Minute) {
-		t.Error("Expected connection to be expired")
-	}
-
-	// With 0 timeout, should never expire
-	if pc.isExpired(0) {
-		t.Error("Expected connection not to expire with 0 timeout")
-	}
-
-	// With 20 minute timeout, should not be expired
-	if pc.isExpired(20 * time.Minute) {
-		t.Error("Expected connection not to be expired")
-	}
-}
-
-func TestNatsBroker_PoolConfiguration(t *testing.T) {
-	// Test that pool size is set correctly
-	br := NewNatsBroker(PoolSize(5))
-	nb, ok := br.(*natsBroker)
-	if !ok {
-		t.Fatal("Expected broker to be of type *natsBroker")
-	}
-
-	if nb.poolSize != 5 {
-		t.Errorf("Expected pool size 5, got %d", nb.poolSize)
-	}
-
-	// Test with custom idle timeout
-	br2 := NewNatsBroker(PoolSize(3), PoolIdleTimeout(10*time.Minute))
-	nb2, ok := br2.(*natsBroker)
-	if !ok {
-		t.Fatal("Expected broker to be of type *natsBroker")
-	}
-
-	if nb2.poolSize != 3 {
-		t.Errorf("Expected pool size 3, got %d", nb2.poolSize)
-	}
-
-	if nb2.poolIdleTimeout != 10*time.Minute {
-		t.Errorf("Expected idle timeout 10m, got %v", nb2.poolIdleTimeout)
-	}
-}
-
-func TestNatsBroker_DefaultSingleConnection(t *testing.T) {
-	// Test that default behavior is single connection (pool size 1)
-	br := NewNatsBroker()
-	nb, ok := br.(*natsBroker)
-	if !ok {
-		t.Fatal("Expected broker to be of type *natsBroker")
-	}
-
-	if nb.poolSize != 1 {
-		t.Errorf("Expected default pool size 1, got %d", nb.poolSize)
-	}
-}
@@ -5,6 +5,7 @@ package rabbitmq
 //

 import (
+	"crypto/tls"
 	"regexp"
 	"strings"
 	"sync"
@@ -12,7 +13,6 @@ import (

 	amqp "github.com/rabbitmq/amqp091-go"
 	"go-micro.dev/v5/logger"
-	mtls "go-micro.dev/v5/util/tls"
 )

 type MQExchangeType string
@@ -232,8 +232,9 @@ func (r *rabbitMQConn) tryConnect(secure bool, config *amqp.Config) error {

 	if secure || config.TLSClientConfig != nil || strings.HasPrefix(r.url, "amqps://") {
 		if config.TLSClientConfig == nil {
-			// Use environment-based config - secure by default
-			config.TLSClientConfig = mtls.Config()
+			config.TLSClientConfig = &tls.Config{
+				InsecureSkipVerify: true,
+			}
 		}

 		url = strings.Replace(r.url, "amqp://", "amqps://", 1)
@@ -3,6 +3,7 @@ package cmd

 import (
 	"fmt"
+	"math/rand"
 	"os"
 	"sort"
 	"strings"
@@ -22,6 +23,9 @@ import (
 	"go-micro.dev/v5/debug/profile/pprof"
 	"go-micro.dev/v5/debug/trace"
 	"go-micro.dev/v5/events"
+	"go-micro.dev/v5/genai"
+	"go-micro.dev/v5/genai/gemini"
+	"go-micro.dev/v5/genai/openai"
 	"go-micro.dev/v5/logger"
 	mprofile "go-micro.dev/v5/profile"
 	"go-micro.dev/v5/registry"
@@ -244,6 +248,21 @@ var (
 			EnvVars: []string{"MICRO_CONFIG"},
 			Usage:   "The source of the config to be used to get configuration",
 		},
+		&cli.StringFlag{
+			Name:    "genai",
+			EnvVars: []string{"MICRO_GENAI"},
+			Usage:   "GenAI provider to use (e.g. openai, gemini, noop)",
+		},
+		&cli.StringFlag{
+			Name:    "genai_key",
+			EnvVars: []string{"MICRO_GENAI_KEY"},
+			Usage:   "GenAI API key",
+		},
+		&cli.StringFlag{
+			Name:    "genai_model",
+			EnvVars: []string{"MICRO_GENAI_MODEL"},
+			Usage:   "GenAI model to use (optional)",
+		},
 	}

 	DefaultBrokers = map[string]func(...broker.Option) broker.Broker{
@@ -293,9 +312,15 @@ var (
 		"redis": redis.NewRedisCache,
 	}
 	DefaultStreams = map[string]func(...events.Option) (events.Stream, error){}
+
+	DefaultGenAI = map[string]func(...genai.Option) genai.GenAI{
+		"openai": openai.New,
+		"gemini": gemini.New,
+	}
 )

 func init() {
+	rand.Seed(time.Now().Unix())
 }

 func newCmd(opts ...Option) Cmd {
@@ -364,6 +389,8 @@ func (c *cmd) Options() Options {
 }

 func (c *cmd) Before(ctx *cli.Context) error {
+	// Set GenAI provider from flags/env
+	setGenAIFromFlags(ctx)
 	// If flags are set then use them otherwise do nothing
 	var serverOpts []server.Option
 	var clientOpts []client.Option
@@ -796,3 +823,24 @@ func Register(cmds ...*cli.Command) {
 		return app.Commands[i].Name < app.Commands[j].Name
 	})
 }
+
+func setGenAIFromFlags(ctx *cli.Context) {
+	provider := ctx.String("genai")
+	key := ctx.String("genai_key")
+	model := ctx.String("genai_model")
+
+	switch provider {
+	case "openai":
+		if key == "" {
+			key = os.Getenv("OPENAI_API_KEY")
+		}
+		genai.DefaultGenAI = openai.New(genai.WithAPIKey(key), genai.WithModel(model))
+	case "gemini":
+		if key == "" {
+			key = os.Getenv("GEMINI_API_KEY")
+		}
+		genai.DefaultGenAI = gemini.New(genai.WithAPIKey(key), genai.WithModel(model))
+	default:
+		genai.DefaultGenAI = genai.Default
+	}
+}
@@ -7,9 +7,11 @@ Go Micro Command Line
 Install `micro` via `go install`

 ```
-go install go-micro.dev/v5/cmd/micro@v5.16.0
+go install go-micro.dev/v5/cmd/micro@latest
 ```

+Or via install script
+

 ## Create a service

@@ -27,132 +29,18 @@ This will:

 ## Run the service

-Run your service:
+Run the service

 ```
 micro run
 ```

-This starts:
- **API Gateway** on http://localhost:8080
- **Web Dashboard** at http://localhost:8080
- **Agent Playground** at http://localhost:8080/agent
- **API Explorer** at http://localhost:8080/api
- **MCP Tools** at http://localhost:8080/api/mcp/tools
- **Hot Reload** watching for file changes
- **Services** in dependency order
+List services to see it's running and registered itself

-Open http://localhost:8080 to see your services and call them from the browser.
-
-### Output
-
-```
-  ┌─────────────────────────────────────────────────────────────┐
-  │                                                             │
-  │   Micro                                                     │
-  │                                                             │
-  │   Web:     http://localhost:8080                            │
-  │   API:     http://localhost:8080/api/{service}/{method}     │
-  │   Health:  http://localhost:8080/health                     │
-  │                                                             │
-  │   Services:                                                 │
-  │     ● helloworld                                            │
-  │                                                             │
-  │   Watching for changes...                                   │
-  │                                                             │
-  └─────────────────────────────────────────────────────────────┘
-```
-
-### Options
-
-```
-micro run                    # Gateway on :8080, hot reload enabled
-micro run --address :3000    # Gateway on custom port
-micro run --no-gateway       # Services only, no HTTP gateway
-micro run --no-watch         # Disable hot reload
-micro run --env production   # Use production environment
-micro run github.com/micro/blog  # Clone and run from GitHub
-```
-
-### Calling Services
-
-Via curl:
-```bash
-curl -X POST http://localhost:8080/api/helloworld/Helloworld.Call -d '{"name": "World"}'
-```
-
-Or browse to http://localhost:8080 and use the web interface.
-
-List services:
 ```
 micro services
 ```

-## Configuration (micro.mu)
-
-For multi-service projects, create a `micro.mu` file to define services, dependencies, and environments:
-
-```
-service users
-    path ./users
-    port 8081
-
-service posts
-    path ./posts
-    port 8082
-    depends users
-
-service web
-    path ./web
-    port 8089
-    depends users posts
-
-env development
-    STORE_ADDRESS file://./data
-    DEBUG true
-
-env production
-    STORE_ADDRESS postgres://localhost/db
-```
-
-### Configuration Options
-
-| Property | Description |
-|----------|-------------|
-| `path` | Directory containing the service (with main.go) |
-| `port` | Port the service listens on (for health checks) |
-| `depends` | Services that must start first (space-separated) |
-
-### Environment Management
-
-Environment variables are injected based on the `--env` flag:
-
-```
-micro run                    # Uses 'development' env (default)
-micro run --env production   # Uses 'production' env
-MICRO_ENV=staging micro run  # Uses 'staging' env
-```
-
-### JSON Alternative
-
-You can also use `micro.json` if you prefer:
-
-```json
-{
-  "services": {
-    "users": { "path": "./users", "port": 8081 },
-    "posts": { "path": "./posts", "port": 8082, "depends": ["users"] }
-  },
-  "env": {
-    "development": { "STORE_ADDRESS": "file://./data" }
-  }
-}
-```
-
-### Without Configuration
-
-If no `micro.mu` or `micro.json` exists, `micro run` discovers all `main.go` files and runs them (original behavior).
-
 ## Describe the service

 Describe the service to see available endpoints
@@ -275,81 +163,13 @@ func main() {
 }
 ```

-## Building and Deployment
-
-### Build Binaries
-
-Build Go binaries for deployment:
-
-```bash
-micro build                     # Build for current OS
-micro build --os linux          # Cross-compile for Linux
-micro build --os linux --arch arm64  # For ARM64
-micro build --output ./dist     # Custom output directory
-```
-
-### Deploy to Server
-
-Deploy to any Linux server with systemd:
-
-```bash
-# First time: set up the server
-ssh user@server
-curl -fsSL https://go-micro.dev/install.sh | sh
-sudo micro init --server
-exit
-
-# Deploy from your laptop
-micro deploy user@server
-```
-
-The deploy command:
-1. Builds binaries for linux/amd64
-2. Copies via SSH to `/opt/micro/bin/`
-3. Sets up systemd services (`micro@<service>`)
-4. Restarts and verifies services are running
-
-### Named Deploy Targets
-
-Add deploy targets to `micro.mu`:
-
-```
-deploy prod
-    ssh deploy@prod.example.com
-
-deploy staging
-    ssh deploy@staging.example.com
-```
-
-Then:
-```bash
-micro deploy prod      # Deploy to production
-micro deploy staging   # Deploy to staging
-```
-
-### Managing Deployed Services
-
-```bash
-# Check status
-micro status --remote user@server
-
-# View logs
-micro logs --remote user@server
-micro logs myservice --remote user@server -f
-
-# Stop a service
-micro stop myservice --remote user@server
-```
-
-See [internal/website/docs/deployment.md](../../internal/website/docs/deployment.md) for the full deployment guide.
-
 ## Protobuf 

 Use protobuf for code generation with [protoc-gen-micro](https://github.com/micro/go-micro/tree/master/cmd/protoc-gen-micro)

 ## Server

-The micro server is a production web dashboard and authenticated API gateway for interacting with services that are already running (e.g., managed by systemd via `micro deploy`). It does **not** build, run, or watch services — for local development, use `micro run` instead.
+The micro server is an api and web dashboard that provide a fixed entrypoint for seeing and querying services.

 Run it like so

@@ -357,7 +177,7 @@ Run it like so
 micro server
 ```

-Then browse to [localhost:8080](http://localhost:8080) and log in with the default admin account (`admin`/`micro`).
+Then browse to [localhost:8080](http://localhost:8080)

 ### API Endpoints 

@@ -390,133 +210,3 @@ micro server
 Then browse to [localhost:8080](http://localhost:8080) and log in with the default admin account (`admin`/`micro`).

 > **Note:** See the `/api` page for details on API authentication and how to generate tokens for use with the HTTP API
-
-## Gateway Architecture
-
-The `micro run` and `micro server` commands both use a unified gateway implementation (`cmd/micro/server/gateway.go`), providing consistent HTTP-to-RPC translation, service discovery, and web UI capabilities.
-
-### Key Differences
-
-| Feature | `micro run` | `micro server` |
-|---------|-------------|----------------|
-| **Purpose** | Development | Production |
-| **Authentication** | Enabled (default `admin`/`micro`) | Enabled (default `admin`/`micro`) |
-| **Process Management** | Yes (builds/runs services) | No (assumes services running) |
-| **Hot Reload** | Yes (watches files) | No |
-| **Scopes** | Available (`/auth/scopes`) | Available (`/auth/scopes`) |
-| **Use Case** | Local development | Deployed API gateway |
-
-### Why Unified?
-
-Previously, each command had its own gateway implementation, leading to code duplication. The unified gateway means:
-
- New features (like MCP integration) benefit both commands
- Consistent behavior between development and production
- Single codebase to test and maintain
- Same HTTP API, web UI, and service discovery logic
-
-### Gateway Features
-
-Both commands provide:
-
- **HTTP API**: `POST /api/{service}/{endpoint}` with JSON request/response
- **Service Discovery**: Automatic detection via registry (mdns/consul/etcd)
- **Health Checks**: `/health`, `/health/live`, `/health/ready` endpoints
- **Web Dashboard**: Browse services, test endpoints, view documentation
- **Hot Service Updates**: Gateway automatically picks up new service registrations
- **JWT Authentication**: Tokens, user management, login at `/auth/login`, `/auth/tokens`, `/auth/users`
- **Endpoint Scopes**: Restrict which tokens can call which endpoints via `/auth/scopes`
- **MCP Integration**: AI tools at `/api/mcp/tools`, agent playground at `/agent`
-
-### Authentication & Scopes
-
-Both `micro run` and `micro server` use the same `auth.Account` type from the go-micro framework. The gateway stores accounts under `auth/<id>` in the default store and uses JWT tokens with RSA256 signing.
-
-**Scope enforcement** applies to all call paths:
-
-| Path | Description |
-|------|-------------|
-| `POST /api/{service}/{endpoint}` | HTTP API calls |
-| `POST /api/mcp/call` | MCP tool invocations |
-| Agent playground | Tool calls made by the AI agent |
-
-Scopes are configured via the web UI at `/auth/scopes`. Each endpoint can require one or more scopes. A token must carry at least one matching scope to call a protected endpoint. The `*` scope on a token bypasses all checks. Endpoints with no scopes set are open to any authenticated token.
-
-See the [Scopes](#scopes) section below for details.
-
-### Development Mode (`micro run`)
-
-```bash
-micro run  # Auth enabled, default admin/micro
-```
-
- Authentication enabled with default credentials (`admin`/`micro`)
- Web UI requires login
- Scopes available for testing access control
- Ideal for development with realistic auth behavior
-
-### Production Mode (`micro server`)
-
-```bash
-micro server  # Auth enabled, JWT tokens required
-```
-
- JWT authentication on all API calls
- User/token management via web UI
- Secure by default
- Login required: default credentials `admin/micro`
-
-### Programmatic Gateway Usage
-
-You can also start the gateway programmatically in your own Go code:
-
-```go
-import "go-micro.dev/v5/cmd/micro/server"
-
-// Start gateway with auth (recommended)
-gw, err := server.StartGateway(server.GatewayOptions{
-    Address:     ":8080",
-    AuthEnabled: true,
-})
-
-// Start gateway without auth (testing only)
-gw, err := server.StartGateway(server.GatewayOptions{
-    Address:     ":8080",
-    AuthEnabled: false,
-})
-```
-
-See [`internal/website/docs/architecture/adr-010-unified-gateway.md`](../../internal/website/docs/architecture/adr-010-unified-gateway.md) for architecture details.
-
-### Scopes
-
-Scopes provide fine-grained access control over which tokens can call which service endpoints. They are managed through the web UI at `/auth/scopes` and enforced on every call through the gateway.
-
-#### How It Works
-
-1. **Define scopes on endpoints** — Visit `/auth/scopes` and set required scopes for each service endpoint (e.g., set `billing` on `payments.Payments.Charge`)
-2. **Create tokens with scopes** — Visit `/auth/tokens` and create tokens with matching scopes (e.g., a token with `billing` scope)
-3. **Scopes are enforced** — When a token calls an endpoint, the gateway checks that the token has at least one scope matching the endpoint's required scopes
-
-#### Scope Matching Rules
-
- Scopes are **exact string matches** — `billing` on a token matches `billing` on an endpoint
- A token with `*` scope bypasses all scope checks (admin wildcard)
- Endpoints with **no scopes set** are open to any valid token
- An endpoint can require **multiple scopes** — the token needs to match just one
- Scope names are free-form strings — use whatever convention fits your project
-
-#### Common Patterns
-
-| Pattern | Endpoint Scopes | Token Scopes | Result |
-|---------|----------------|--------------|--------|
-| Protect a service | Set `greeter` on all greeter endpoints (use Bulk Set with `greeter.*`) | Token with `greeter` | Token can call any greeter endpoint |
-| Restrict an endpoint | Set `billing` on `payments.Payments.Charge` | Token with `billing` | Only that endpoint is restricted |
-| Role-based | Set `admin` on sensitive endpoints | Admin token with `admin`, user token with `user` | Only admin tokens can call sensitive endpoints |
-| Full access | Any | Token with `*` | Bypasses all scope checks |
-
-#### Relationship to Framework Auth
-
-The gateway's scope system uses `auth.Account` from the go-micro framework. Scopes on accounts are the same `[]string` field used by the framework's `auth.Rules` and `wrapper/auth` package. The gateway stores scope requirements in the default store under `endpoint-scopes/<service>.<endpoint>` keys and checks them on every HTTP request.
-
-For service-level (RPC) auth within the go-micro mesh, use the `wrapper/auth` package which provides `auth.Rules` with priority-based access control. See the [auth wrapper documentation](../../wrapper/auth/README.md) for details.
@@ -13,11 +13,9 @@ write services. Surrounding this we introduce a number of tools to make it easy
 Install `micro` via `go install`

 ```
-go install go-micro.dev/v5/cmd/micro@v5.16.0
+go install go-micro.dev/v5@latest
 ```

-> **Note:** Use a specific version instead of `@latest` to avoid module path conflicts. See [releases](https://github.com/micro/go-micro/releases) for the latest version.
-
 Or via install script

 ```
@@ -1,343 +0,0 @@
-// Package build provides the micro build command for building service binaries
-package build
-
-import (
-	"fmt"
-	"os"
-	"os/exec"
-	"path/filepath"
-	"runtime"
-	"strings"
-
-	"github.com/urfave/cli/v2"
-	"go-micro.dev/v5/cmd"
-	"go-micro.dev/v5/cmd/micro/run/config"
-)
-
-// Build builds Go binaries for services
-func Build(c *cli.Context) error {
-	dir := c.Args().Get(0)
-	if dir == "" {
-		dir = "."
-	}
-
-	absDir, err := filepath.Abs(dir)
-	if err != nil {
-		return fmt.Errorf("failed to get absolute path: %w", err)
-	}
-
-	// Load config
-	cfg, err := config.Load(absDir)
-	if err != nil {
-		return fmt.Errorf("failed to load config: %w", err)
-	}
-
-	// Output directory
-	outDir := c.String("output")
-	if outDir == "" {
-		outDir = filepath.Join(absDir, "bin")
-	}
-	if err := os.MkdirAll(outDir, 0755); err != nil {
-		return fmt.Errorf("failed to create output dir: %w", err)
-	}
-
-	// Target OS/ARCH
-	targetOS := c.String("os")
-	targetArch := c.String("arch")
-	if targetOS == "" {
-		targetOS = runtime.GOOS
-	}
-	if targetArch == "" {
-		targetArch = runtime.GOARCH
-	}
-
-	if cfg != nil && len(cfg.Services) > 0 {
-		// Build each service from config
-		sorted, err := cfg.TopologicalSort()
-		if err != nil {
-			return err
-		}
-
-		for _, svc := range sorted {
-			svcDir := filepath.Join(absDir, svc.Path)
-			if err := buildService(svc.Name, svcDir, outDir, targetOS, targetArch); err != nil {
-				return fmt.Errorf("failed to build %s: %w", svc.Name, err)
-			}
-		}
-	} else {
-		// Build single service from current directory
-		name := filepath.Base(absDir)
-		if err := buildService(name, absDir, outDir, targetOS, targetArch); err != nil {
-			return err
-		}
-	}
-
-	fmt.Printf("\n✓ Built to %s\n", outDir)
-	return nil
-}
-
-func buildService(name, dir, outDir, targetOS, targetArch string) error {
-	binName := name
-	if targetOS == "windows" {
-		binName += ".exe"
-	}
-	outPath := filepath.Join(outDir, binName)
-
-	fmt.Printf("Building %s (%s/%s)...\n", name, targetOS, targetArch)
-
-	// Build command
-	buildCmd := exec.Command("go", "build", "-o", outPath, ".")
-	buildCmd.Dir = dir
-	buildCmd.Env = append(os.Environ(),
-		"GOOS="+targetOS,
-		"GOARCH="+targetArch,
-		"CGO_ENABLED=0",
-	)
-	buildCmd.Stdout = os.Stdout
-	buildCmd.Stderr = os.Stderr
-
-	if err := buildCmd.Run(); err != nil {
-		return fmt.Errorf("go build failed: %w", err)
-	}
-
-	fmt.Printf("✓ %s\n", outPath)
-	return nil
-}
-
-// Docker builds container images (optional)
-func Docker(c *cli.Context) error {
-	dir := c.Args().Get(0)
-	if dir == "" {
-		dir = "."
-	}
-
-	absDir, err := filepath.Abs(dir)
-	if err != nil {
-		return fmt.Errorf("failed to get absolute path: %w", err)
-	}
-
-	cfg, err := config.Load(absDir)
-	if err != nil {
-		return fmt.Errorf("failed to load config: %w", err)
-	}
-
-	tag := c.String("tag")
-	if tag == "" {
-		tag = "latest"
-	}
-	registry := c.String("registry")
-	push := c.Bool("push")
-
-	if cfg != nil && len(cfg.Services) > 0 {
-		for name, svc := range cfg.Services {
-			svcDir := filepath.Join(absDir, svc.Path)
-			if err := buildDockerImage(name, svcDir, svc.Port, tag, registry, push); err != nil {
-				return fmt.Errorf("failed to build %s: %w", name, err)
-			}
-		}
-	} else {
-		name := filepath.Base(absDir)
-		if err := buildDockerImage(name, absDir, 8080, tag, registry, push); err != nil {
-			return err
-		}
-	}
-
-	return nil
-}
-
-const dockerfileTemplate = `FROM golang:1.22-alpine AS builder
-WORKDIR /app
-COPY go.mod go.sum ./
-RUN go mod download
-COPY . .
-RUN CGO_ENABLED=0 go build -o /service .
-
-FROM alpine:latest
-RUN apk --no-cache add ca-certificates
-COPY --from=builder /service /service
-EXPOSE %d
-CMD ["/service"]
-`
-
-func buildDockerImage(name, dir string, port int, tag, registry string, push bool) error {
-	if port == 0 {
-		port = 8080
-	}
-
-	// Generate Dockerfile if not exists
-	dockerfilePath := filepath.Join(dir, "Dockerfile")
-	if _, err := os.Stat(dockerfilePath); os.IsNotExist(err) {
-		fmt.Printf("Generating Dockerfile for %s...\n", name)
-		dockerfile := fmt.Sprintf(dockerfileTemplate, port)
-		if err := os.WriteFile(dockerfilePath, []byte(dockerfile), 0644); err != nil {
-			return fmt.Errorf("failed to write Dockerfile: %w", err)
-		}
-	}
-
-	imageName := name + ":" + tag
-	if registry != "" {
-		imageName = registry + "/" + imageName
-	}
-
-	fmt.Printf("Building %s...\n", imageName)
-
-	buildCmd := exec.Command("docker", "build", "-t", imageName, dir)
-	buildCmd.Stdout = os.Stdout
-	buildCmd.Stderr = os.Stderr
-	if err := buildCmd.Run(); err != nil {
-		return fmt.Errorf("docker build failed: %w", err)
-	}
-
-	fmt.Printf("✓ Built %s\n", imageName)
-
-	if push {
-		fmt.Printf("Pushing %s...\n", imageName)
-		pushCmd := exec.Command("docker", "push", imageName)
-		pushCmd.Stdout = os.Stdout
-		pushCmd.Stderr = os.Stderr
-		if err := pushCmd.Run(); err != nil {
-			return fmt.Errorf("docker push failed: %w", err)
-		}
-		fmt.Printf("✓ Pushed %s\n", imageName)
-	}
-
-	return nil
-}
-
-// Compose generates docker-compose.yml (optional)
-func Compose(c *cli.Context) error {
-	dir := c.Args().Get(0)
-	if dir == "" {
-		dir = "."
-	}
-
-	absDir, err := filepath.Abs(dir)
-	if err != nil {
-		return fmt.Errorf("failed to get absolute path: %w", err)
-	}
-
-	cfg, err := config.Load(absDir)
-	if err != nil {
-		return fmt.Errorf("failed to load config: %w", err)
-	}
-
-	if cfg == nil || len(cfg.Services) == 0 {
-		return fmt.Errorf("no services found in micro.mu or micro.json")
-	}
-
-	registry := c.String("registry")
-	tag := c.String("tag")
-	if tag == "" {
-		tag = "latest"
-	}
-
-	var sb strings.Builder
-	sb.WriteString("# Generated by micro build --compose\n")
-	sb.WriteString("version: '3.8'\n\nservices:\n")
-
-	sorted, err := cfg.TopologicalSort()
-	if err != nil {
-		return err
-	}
-
-	for _, svc := range sorted {
-		imageName := svc.Name + ":" + tag
-		if registry != "" {
-			imageName = registry + "/" + imageName
-		}
-
-		sb.WriteString(fmt.Sprintf("  %s:\n", svc.Name))
-		sb.WriteString(fmt.Sprintf("    image: %s\n", imageName))
-
-		if svc.Port > 0 {
-			sb.WriteString(fmt.Sprintf("    ports:\n      - \"%d:%d\"\n", svc.Port, svc.Port))
-		}
-
-		if len(svc.Depends) > 0 {
-			sb.WriteString("    depends_on:\n")
-			for _, dep := range svc.Depends {
-				sb.WriteString(fmt.Sprintf("      - %s\n", dep))
-			}
-		}
-
-		sb.WriteString("    environment:\n      - MICRO_REGISTRY=mdns\n\n")
-	}
-
-	output := filepath.Join(absDir, "docker-compose.yml")
-	if err := os.WriteFile(output, []byte(sb.String()), 0644); err != nil {
-		return fmt.Errorf("failed to write docker-compose.yml: %w", err)
-	}
-
-	fmt.Printf("✓ Generated %s\n", output)
-	return nil
-}
-
-func init() {
-	cmd.Register(&cli.Command{
-		Name:  "build",
-		Usage: "Build Go binaries for services",
-		Description: `Build compiles Go binaries for your services.
-
-With a micro.mu config, builds all services. Without, builds the current directory.
-Output goes to ./bin/ by default.
-
-Examples:
-  micro build                      # Build for current OS/arch
-  micro build --os linux           # Cross-compile for Linux
-  micro build --os linux --arch arm64  # For ARM64
-  micro build --output ./dist      # Custom output directory
-
-Docker (optional):
-  micro build --docker             # Build container images
-  micro build --docker --push      # Build and push
-  micro build --compose            # Generate docker-compose.yml`,
-		Action: func(c *cli.Context) error {
-			if c.Bool("docker") {
-				return Docker(c)
-			}
-			if c.Bool("compose") {
-				return Compose(c)
-			}
-			return Build(c)
-		},
-		Flags: []cli.Flag{
-			&cli.StringFlag{
-				Name:    "output",
-				Aliases: []string{"o"},
-				Usage:   "Output directory (default: ./bin)",
-			},
-			&cli.StringFlag{
-				Name:  "os",
-				Usage: "Target OS (linux, darwin, windows)",
-			},
-			&cli.StringFlag{
-				Name:  "arch",
-				Usage: "Target architecture (amd64, arm64)",
-			},
-			// Docker options (optional)
-			&cli.BoolFlag{
-				Name:  "docker",
-				Usage: "Build Docker container images instead",
-			},
-			&cli.StringFlag{
-				Name:    "tag",
-				Aliases: []string{"t"},
-				Usage:   "Docker image tag (default: latest)",
-				Value:   "latest",
-			},
-			&cli.StringFlag{
-				Name:    "registry",
-				Aliases: []string{"r"},
-				Usage:   "Docker registry (e.g., docker.io/myuser)",
-			},
-			&cli.BoolFlag{
-				Name:  "push",
-				Usage: "Push Docker images after building",
-			},
-			&cli.BoolFlag{
-				Name:  "compose",
-				Usage: "Generate docker-compose.yml",
-			},
-		},
-	})
-}
@@ -1,26 +1,26 @@
 package microcli

 import (
+	"bufio"
 	"context"
 	"encoding/json"
 	"fmt"
 	"os"
 	"os/exec"
+	"os/signal"
+	"path/filepath"
+	"strings"
+	"syscall"

 	"github.com/urfave/cli/v2"
 	"go-micro.dev/v5/client"
 	"go-micro.dev/v5/cmd"
 	"go-micro.dev/v5/codec/bytes"
+	"go-micro.dev/v5/genai"
 	"go-micro.dev/v5/registry"

 	"go-micro.dev/v5/cmd/micro/cli/new"
 	"go-micro.dev/v5/cmd/micro/cli/util"
-
-	// Import packages that register commands via init()
-	_ "go-micro.dev/v5/cmd/micro/cli/build"
-	_ "go-micro.dev/v5/cmd/micro/cli/deploy"
-	_ "go-micro.dev/v5/cmd/micro/cli/init"
-	_ "go-micro.dev/v5/cmd/micro/cli/remote"
 )

 var (
@@ -36,6 +36,75 @@ func genProtoHandler(c *cli.Context) error {
 	return cmd.Run()
 }

+func genTextHandler(c *cli.Context) error {
+	prompt := c.String("prompt")
+	if len(prompt) == 0 {
+		return nil
+	}
+
+	gen := genai.DefaultGenAI
+	if gen.String() == "noop" {
+		return nil
+	}
+
+	res, err := gen.Generate(prompt)
+	if err != nil {
+		return err
+	}
+
+	fmt.Println(res.Text)
+	return nil
+}
+
+func lastNonEmptyLine(s string) string {
+	lines := strings.Split(s, "\n")
+	for i := len(lines) - 1; i >= 0; i-- {
+		if strings.TrimSpace(lines[i]) != "" {
+			return lines[i]
+		}
+	}
+	return ""
+}
+
+func lastLogLine(path string) string {
+	f, err := os.Open(path)
+	if err != nil {
+		return ""
+	}
+	defer f.Close()
+	var last string
+	scan := bufio.NewScanner(f)
+	for scan.Scan() {
+		if strings.TrimSpace(scan.Text()) != "" {
+			last = scan.Text()
+		}
+	}
+	return last
+}
+
+func waitAndCleanup(procs []*exec.Cmd, pidFiles []string) {
+	ch := make(chan os.Signal, 1)
+	signal.Notify(ch, os.Interrupt)
+	go func() {
+		<-ch
+		for _, proc := range procs {
+			if proc.Process != nil {
+				_ = proc.Process.Kill()
+			}
+		}
+		for _, pf := range pidFiles {
+			_ = os.Remove(pf)
+		}
+		os.Exit(1)
+	}()
+	for i, proc := range procs {
+		_ = proc.Wait()
+		if proc.Process != nil {
+			_ = os.Remove(pidFiles[i])
+		}
+	}
+}
+
 func init() {
 	cmd.Register([]*cli.Command{
 		{
@@ -47,6 +116,18 @@ func init() {
 			Name:  "gen",
 			Usage: "Generate various things",
 			Subcommands: []*cli.Command{
+				{
+					Name:   "text",
+					Usage:  "Generate text via an LLM",
+					Action: genTextHandler,
+					Flags: []cli.Flag{
+						&cli.StringFlag{
+							Name:    "prompt",
+							Aliases: []string{"p"},
+							Usage:   "The prompt to generate text from",
+						},
+					},
+				},
 				{
 					Name:   "proto",
 					Usage:  "Generate proto requires protoc and protoc-gen-micro",
@@ -120,11 +201,142 @@ func init() {
 				return nil
 			},
 		},
-		// Note: The following commands are registered in their respective packages:
-		// - status, logs, stop: remote/remote.go
-		// - build: build/build.go
-		// - deploy: deploy/deploy.go
-		// - init: init/init.go
+		{
+			Name:  "status",
+			Usage: "Check status of running services",
+			Action: func(ctx *cli.Context) error {
+				homeDir, err := os.UserHomeDir()
+				if err != nil {
+					return fmt.Errorf("failed to get home dir: %w", err)
+				}
+				runDir := filepath.Join(homeDir, "micro", "run")
+				files, err := os.ReadDir(runDir)
+				if err != nil {
+					return fmt.Errorf("failed to read run dir: %w", err)
+				}
+				fmt.Printf("%-20s %-8s %-8s %s\n", "SERVICE", "PID", "STATUS", "DIRECTORY")
+				for _, f := range files {
+					if f.IsDir() || !strings.HasSuffix(f.Name(), ".pid") {
+						continue
+					}
+					service := f.Name()[:len(f.Name())-4]
+					pidFilePath := filepath.Join(runDir, f.Name())
+					pidFile, err := os.Open(pidFilePath)
+					if err != nil {
+						continue
+					}
+					var pid int
+					var dir string
+					scanner := bufio.NewScanner(pidFile)
+					if scanner.Scan() {
+						fmt.Sscanf(scanner.Text(), "%d", &pid)
+					}
+					if scanner.Scan() {
+						dir = scanner.Text()
+					}
+					pidFile.Close()
+					status := "stopped"
+					if pid > 0 {
+						proc, err := os.FindProcess(pid)
+						if err == nil {
+							if err := proc.Signal(syscall.Signal(0)); err == nil {
+								status = "running"
+							}
+						}
+					}
+					fmt.Printf("%-20s %-8d %-8s %-40s %s\n", service, pid, status, "", dir)
+				}
+				return nil
+			},
+		},
+		{
+			Name:  "stop",
+			Usage: "Stop a running service",
+			Action: func(ctx *cli.Context) error {
+				if ctx.Args().Len() != 1 {
+					return fmt.Errorf("Usage: micro stop [service]")
+				}
+				service := ctx.Args().Get(0)
+				homeDir, err := os.UserHomeDir()
+				if err != nil {
+					return fmt.Errorf("failed to get home dir: %w", err)
+				}
+				runDir := filepath.Join(homeDir, "micro", "run")
+				pidFilePath := filepath.Join(runDir, service+".pid")
+				pidFile, err := os.Open(pidFilePath)
+				if err != nil {
+					return fmt.Errorf("no pid file for service %s", service)
+				}
+				var pid int
+				var dir string
+				scanner := bufio.NewScanner(pidFile)
+				if scanner.Scan() {
+					fmt.Sscanf(scanner.Text(), "%d", &pid)
+				}
+				if scanner.Scan() {
+					dir = scanner.Text()
+				}
+				pidFile.Close()
+				if pid <= 0 {
+					_ = os.Remove(pidFilePath)
+					return fmt.Errorf("service %s is not running", service)
+				}
+				proc, err := os.FindProcess(pid)
+				if err != nil {
+					_ = os.Remove(pidFilePath)
+					return fmt.Errorf("could not find process for %s", service)
+				}
+				if err := proc.Signal(syscall.SIGTERM); err != nil {
+					_ = os.Remove(pidFilePath)
+					return fmt.Errorf("failed to stop service %s: %v", service, err)
+				}
+				_ = os.Remove(pidFilePath)
+				fmt.Printf("Stopped service %s (pid %d) in directory %s\n", service, pid, dir)
+				return nil
+			},
+		},
+		{
+			Name:  "logs",
+			Usage: "Show logs for a service, or list available logs if no service is specified",
+			Action: func(ctx *cli.Context) error {
+				homeDir, err := os.UserHomeDir()
+				if err != nil {
+					return fmt.Errorf("failed to get home dir: %w", err)
+				}
+				logsDir := filepath.Join(homeDir, "micro", "logs")
+				if ctx.Args().Len() == 0 {
+					// List available logs
+					dirEntries, err := os.ReadDir(logsDir)
+					if err != nil {
+						return fmt.Errorf("could not list logs directory: %v", err)
+					}
+					fmt.Println("Available logs:")
+					found := false
+					for _, entry := range dirEntries {
+						if !entry.IsDir() && strings.HasSuffix(entry.Name(), ".log") {
+							fmt.Println("  ", strings.TrimSuffix(entry.Name(), ".log"))
+							found = true
+						}
+					}
+					if !found {
+						fmt.Println("  (no logs found)")
+					}
+					return nil
+				}
+				service := ctx.Args().Get(0)
+				logFilePath := filepath.Join(logsDir, service+".log")
+				f, err := os.Open(logFilePath)
+				if err != nil {
+					return fmt.Errorf("could not open log file for service %s: %v", service, err)
+				}
+				defer f.Close()
+				scan := bufio.NewScanner(f)
+				for scan.Scan() {
+					fmt.Println(scan.Text())
+				}
+				return scan.Err()
+			},
+		},
 	}...)

 	cmd.App().Action = func(c *cli.Context) error {
@@ -1,447 +0,0 @@
-// Package deploy provides the micro deploy command for deploying services
-package deploy
-
-import (
-	"fmt"
-	"os"
-	"os/exec"
-	"path/filepath"
-	"runtime"
-	"strings"
-	"time"
-
-	"github.com/urfave/cli/v2"
-	"go-micro.dev/v5/cmd"
-	"go-micro.dev/v5/cmd/micro/run/config"
-)
-
-const (
-	defaultRemotePath = "/opt/micro"
-)
-
-// Deploy deploys services to a target
-func Deploy(c *cli.Context) error {
-	// Get target from args or flag
-	target := c.Args().First()
-	if target == "" {
-		target = c.String("ssh")
-	}
-
-	// Load config to check for deploy targets
-	dir := "."
-	absDir, _ := filepath.Abs(dir)
-	cfg, _ := config.Load(absDir)
-
-	// If still no target, check config for named targets
-	if target == "" && cfg != nil && len(cfg.Deploy) > 0 {
-		// Show available targets
-		return showDeployTargets(cfg)
-	}
-
-	if target == "" {
-		return showDeployHelp()
-	}
-
-	// Check if target is a named target from config
-	if cfg != nil {
-		if dt, ok := cfg.Deploy[target]; ok {
-			target = dt.SSH
-		}
-	}
-
-	return deploySSH(c, target, cfg)
-}
-
-func showDeployHelp() error {
-	return fmt.Errorf(`No deployment target specified.
-
-To deploy, you need a server running micro. Quick setup:
-
-  1. On your server (Ubuntu/Debian):
-     ssh user@your-server
-     curl -fsSL https://go-micro.dev/install.sh | sh
-     sudo micro init --server
-
-  2. Then deploy from here:
-     micro deploy user@your-server
-
-  Or add to micro.mu:
-     deploy prod
-         ssh user@your-server
-
-Run 'micro deploy --help' for more options.`)
-}
-
-func showDeployTargets(cfg *config.Config) error {
-	var sb strings.Builder
-	sb.WriteString("Available deploy targets:\n\n")
-	for name, dt := range cfg.Deploy {
-		sb.WriteString(fmt.Sprintf("  %s -> %s\n", name, dt.SSH))
-	}
-	sb.WriteString("\nDeploy with: micro deploy <target>")
-	return fmt.Errorf("%s", sb.String())
-}
-
-func deploySSH(c *cli.Context, target string, cfg *config.Config) error {
-	dir := c.Args().Get(1)
-	if dir == "" {
-		dir = "."
-	}
-
-	absDir, err := filepath.Abs(dir)
-	if err != nil {
-		return fmt.Errorf("failed to get absolute path: %w", err)
-	}
-
-	// Load config if not passed
-	if cfg == nil {
-		cfg, _ = config.Load(absDir)
-	}
-
-	remotePath := c.String("path")
-	if remotePath == "" {
-		remotePath = defaultRemotePath
-	}
-
-	fmt.Printf("Deploying to %s...\n\n", target)
-
-	// Step 1: Check SSH connectivity
-	fmt.Print("  Checking SSH connection... ")
-	if err := checkSSH(target); err != nil {
-		fmt.Println("\u2717")
-		return err
-	}
-	fmt.Println("\u2713")
-
-	// Step 2: Check server is initialized
-	fmt.Print("  Checking server setup...   ")
-	if err := checkServerInit(target, remotePath); err != nil {
-		fmt.Println("\u2717")
-		return err
-	}
-	fmt.Println("\u2713")
-
-	// Step 3: Build binaries
-	var services []string
-	if cfg != nil && len(cfg.Services) > 0 {
-		sorted, err := cfg.TopologicalSort()
-		if err != nil {
-			return err
-		}
-		for _, svc := range sorted {
-			services = append(services, svc.Name)
-		}
-	} else {
-		services = []string{filepath.Base(absDir)}
-	}
-
-	fmt.Printf("  Building binaries...       ")
-	if err := buildBinaries(absDir, cfg, c.Bool("build")); err != nil {
-		fmt.Println("\u2717")
-		return err
-	}
-	fmt.Printf("\u2713 %s\n", strings.Join(services, ", "))
-
-	// Step 4: Copy binaries
-	fmt.Printf("  Copying binaries...        ")
-	if err := copyBinaries(target, filepath.Join(absDir, "bin"), remotePath); err != nil {
-		fmt.Println("\u2717")
-		return err
-	}
-	fmt.Printf("\u2713 %d services\n", len(services))
-
-	// Step 5: Setup and restart services via systemd
-	fmt.Printf("  Updating systemd...        ")
-	if err := setupSystemdServices(target, remotePath, services); err != nil {
-		fmt.Println("\u2717")
-		return err
-	}
-	fmt.Printf("\u2713 %s\n", strings.Join(prefixServices(services), ", "))
-
-	// Step 6: Restart services
-	fmt.Printf("  Restarting services...     ")
-	if err := restartServices(target, services); err != nil {
-		fmt.Println("\u2717")
-		return err
-	}
-	fmt.Println("\u2713")
-
-	// Step 7: Check health
-	fmt.Printf("  Checking health...         ")
-	time.Sleep(2 * time.Second) // Give services time to start
-	healthy, unhealthy := checkServicesHealth(target, services)
-	if len(unhealthy) > 0 {
-		fmt.Printf("\u26a0 %d/%d healthy\n", len(healthy), len(services))
-	} else {
-		fmt.Println("\u2713 all healthy")
-	}
-
-	fmt.Println()
-	fmt.Printf("\u2713 Deployed to %s\n", target)
-	fmt.Println()
-	fmt.Printf("  Status: micro status --remote %s\n", target)
-	fmt.Printf("  Logs:   micro logs --remote %s\n", target)
-
-	if len(unhealthy) > 0 {
-		fmt.Println()
-		fmt.Printf("\u26a0 Some services may have issues: %s\n", strings.Join(unhealthy, ", "))
-		fmt.Printf("  Check logs: micro logs %s --remote %s\n", unhealthy[0], target)
-	}
-
-	return nil
-}
-
-func prefixServices(services []string) []string {
-	result := make([]string, len(services))
-	for i, s := range services {
-		result[i] = "micro@" + s
-	}
-	return result
-}
-
-func checkSSH(host string) error {
-	testCmd := exec.Command("ssh", "-o", "ConnectTimeout=5", "-o", "BatchMode=yes", host, "echo ok")
-	output, err := testCmd.CombinedOutput()
-
-	if err != nil {
-		return fmt.Errorf(`
-\u2717 Cannot connect to %s
-
-  SSH connection failed. Check that:
-  \u2022 The server is reachable: ping %s
-  \u2022 SSH is configured: ssh %s
-  \u2022 Your key is added: ssh-add -l
-
-  Common fixes:
-  \u2022 Add SSH key: ssh-copy-id %s
-  \u2022 Check hostname in ~/.ssh/config
-
-  Error: %s`, host, host, host, host, strings.TrimSpace(string(output)))
-	}
-	return nil
-}
-
-func checkServerInit(host, remotePath string) error {
-	checkCmd := fmt.Sprintf("test -f %s/.micro-initialized", remotePath)
-	sshCmd := exec.Command("ssh", host, checkCmd)
-	if err := sshCmd.Run(); err != nil {
-		return fmt.Errorf(`
-\u2717 Server not initialized
-
-  micro is not set up on %s.
-
-  Run this on the server:
-    ssh %s
-    curl -fsSL https://go-micro.dev/install.sh | sh
-    sudo micro init --server
-
-  Or initialize remotely (requires sudo):
-    micro init --server --remote %s`, host, host, host)
-	}
-	return nil
-}
-
-func buildBinaries(absDir string, cfg *config.Config, forceBuild bool) error {
-	binDir := filepath.Join(absDir, "bin")
-
-	// Check if we already have binaries and don't need to rebuild
-	if !forceBuild {
-		if _, err := os.Stat(binDir); err == nil {
-			// Check if binaries are for linux
-			// For now, just rebuild to be safe
-		}
-	}
-
-	// Always build for linux/amd64
-	targetOS := "linux"
-	targetArch := "amd64"
-
-	if err := os.MkdirAll(binDir, 0755); err != nil {
-		return err
-	}
-
-	if cfg != nil && len(cfg.Services) > 0 {
-		sorted, err := cfg.TopologicalSort()
-		if err != nil {
-			return err
-		}
-
-		for _, svc := range sorted {
-			svcDir := filepath.Join(absDir, svc.Path)
-			outPath := filepath.Join(binDir, svc.Name)
-
-			buildCmd := exec.Command("go", "build", "-o", outPath, ".")
-			buildCmd.Dir = svcDir
-			buildCmd.Env = append(os.Environ(),
-				"GOOS="+targetOS,
-				"GOARCH="+targetArch,
-				"CGO_ENABLED=0",
-			)
-
-			if output, err := buildCmd.CombinedOutput(); err != nil {
-				return fmt.Errorf("failed to build %s:\n%s", svc.Name, string(output))
-			}
-		}
-	} else {
-		name := filepath.Base(absDir)
-		outPath := filepath.Join(binDir, name)
-
-		buildCmd := exec.Command("go", "build", "-o", outPath, ".")
-		buildCmd.Dir = absDir
-		buildCmd.Env = append(os.Environ(),
-			"GOOS="+targetOS,
-			"GOARCH="+targetArch,
-			"CGO_ENABLED=0",
-		)
-
-		if output, err := buildCmd.CombinedOutput(); err != nil {
-			return fmt.Errorf("failed to build:\n%s", string(output))
-		}
-	}
-
-	return nil
-}
-
-func copyBinaries(target, binDir, remotePath string) error {
-	// Ensure remote bin directory exists
-	mkdirCmd := exec.Command("ssh", target, fmt.Sprintf("mkdir -p %s/bin", remotePath))
-	if err := mkdirCmd.Run(); err != nil {
-		return fmt.Errorf("failed to create remote directory: %w", err)
-	}
-
-	// Use rsync for efficient copy
-	// --omit-dir-times avoids permission errors on directory timestamps
-	rsyncArgs := []string{
-		"-avz", "--delete", "--omit-dir-times",
-		binDir + "/",
-		fmt.Sprintf("%s:%s/bin/", target, remotePath),
-	}
-
-	rsyncCmd := exec.Command("rsync", rsyncArgs...)
-	output, err := rsyncCmd.CombinedOutput()
-	if err != nil {
-		outputStr := string(output)
-		// Fall back to scp if rsync not available
-		if strings.Contains(outputStr, "command not found") {
-			scpCmd := exec.Command("scp", "-r", binDir+"/", fmt.Sprintf("%s:%s/bin/", target, remotePath))
-			if scpOutput, scpErr := scpCmd.CombinedOutput(); scpErr != nil {
-				return fmt.Errorf("copy failed: %s", string(scpOutput))
-			}
-			return nil
-		}
-		// rsync exit code 23 means some files failed to transfer, but if we see our files listed, it's ok
-		// rsync exit code 24 means some files vanished during transfer (harmless)
-		exitErr, ok := err.(*exec.ExitError)
-		if ok && (exitErr.ExitCode() == 23 || exitErr.ExitCode() == 24) {
-			// Check if it's just permission warnings on metadata, not actual file transfer failures
-			if !strings.Contains(outputStr, "Permission denied (13)") ||
-				strings.Contains(outputStr, "failed to set times") ||
-				strings.Contains(outputStr, "chgrp") {
-				// These are acceptable warnings
-				return nil
-			}
-		}
-		return fmt.Errorf("copy failed: %s", outputStr)
-	}
-
-	return nil
-}
-
-func setupSystemdServices(target, remotePath string, services []string) error {
-	for _, svc := range services {
-		// Enable the service using the template
-		enableCmd := fmt.Sprintf("sudo systemctl enable micro@%s 2>/dev/null || true", svc)
-		sshCmd := exec.Command("ssh", target, enableCmd)
-		sshCmd.Run() // Ignore errors, service might already be enabled
-	}
-
-	// Reload systemd
-	reloadCmd := exec.Command("ssh", target, "sudo systemctl daemon-reload")
-	if err := reloadCmd.Run(); err != nil {
-		return fmt.Errorf("failed to reload systemd: %w", err)
-	}
-
-	return nil
-}
-
-func restartServices(target string, services []string) error {
-	for _, svc := range services {
-		restartCmd := fmt.Sprintf("sudo systemctl restart micro@%s", svc)
-		sshCmd := exec.Command("ssh", target, restartCmd)
-		if output, err := sshCmd.CombinedOutput(); err != nil {
-			return fmt.Errorf("failed to restart %s: %s", svc, string(output))
-		}
-	}
-	return nil
-}
-
-func checkServicesHealth(target string, services []string) (healthy, unhealthy []string) {
-	for _, svc := range services {
-		checkCmd := fmt.Sprintf("systemctl is-active micro@%s", svc)
-		sshCmd := exec.Command("ssh", target, checkCmd)
-		if err := sshCmd.Run(); err != nil {
-			unhealthy = append(unhealthy, svc)
-		} else {
-			healthy = append(healthy, svc)
-		}
-	}
-	return
-}
-
-// Ensure we're not on Windows for deploy
-func checkPlatform() error {
-	if runtime.GOOS == "windows" {
-		return fmt.Errorf("micro deploy requires SSH and rsync, which work best on Linux/macOS.\nConsider using WSL on Windows.")
-	}
-	return nil
-}
-
-func init() {
-	cmd.Register(&cli.Command{
-		Name:  "deploy",
-		Usage: "Deploy services to a remote server",
-		Description: `Deploy copies binaries to a remote server and manages them with systemd.
-
-Before deploying, initialize the server:
-  ssh user@server 'curl -fsSL https://go-micro.dev/install.sh | sh && sudo micro init --server'
-
-Then deploy:
-  micro deploy user@server
-
-With a micro.mu config, you can define named targets:
-  deploy prod
-      ssh user@prod.example.com
-
-  deploy staging
-      ssh user@staging.example.com
-
-Then: micro deploy prod
-
-The deploy process:
-  1. Builds binaries for linux/amd64
-  2. Copies to /opt/micro/bin/ via rsync
-  3. Enables and restarts systemd services
-  4. Verifies services are healthy`,
-		Action: func(c *cli.Context) error {
-			if err := checkPlatform(); err != nil {
-				return err
-			}
-			return Deploy(c)
-		},
-		Flags: []cli.Flag{
-			&cli.StringFlag{
-				Name:  "ssh",
-				Usage: "Deploy target as user@host (can also be positional arg)",
-			},
-			&cli.StringFlag{
-				Name:  "path",
-				Usage: "Remote path (default: /opt/micro)",
-				Value: "/opt/micro",
-			},
-			&cli.BoolFlag{
-				Name:  "build",
-				Usage: "Force rebuild of binaries",
-			},
-		},
-	})
-}
@@ -1,272 +0,0 @@
-// Package generate provides code generation commands for micro
-package gen
-
-import (
-	"fmt"
-	"os"
-	"path/filepath"
-	"strings"
-	"text/template"
-
-	"github.com/urfave/cli/v2"
-	"go-micro.dev/v5/cmd"
-)
-
-var handlerTemplate = `package handler
-
-import (
-	"context"
-
-	log "go-micro.dev/v5/logger"
-)
-
-type {{.Name}} struct{}
-
-func New{{.Name}}() *{{.Name}} {
-	return &{{.Name}}{}
-}
-
-{{range .Methods}}
-// {{.Name}} handles {{.Name}} requests
-func (h *{{$.Name}}) {{.Name}}(ctx context.Context, req *{{.RequestType}}, rsp *{{.ResponseType}}) error {
-	log.Infof("Received {{$.Name}}.{{.Name}} request")
-	// TODO: implement
-	return nil
-}
-{{end}}
-`
-
-var endpointTemplate = `package handler
-
-import (
-	"context"
-	"encoding/json"
-	"net/http"
-
-	log "go-micro.dev/v5/logger"
-)
-
-// {{.Name}}Request is the request for {{.Name}}
-type {{.Name}}Request struct {
-	// Add request fields here
-}
-
-// {{.Name}}Response is the response for {{.Name}}
-type {{.Name}}Response struct {
-	// Add response fields here
-}
-
-// {{.Name}} handles HTTP {{.Method}} requests to /{{.Path}}
-func {{.Name}}(w http.ResponseWriter, r *http.Request) {
-	ctx := r.Context()
-	log.Infof("Received {{.Name}} request")
-
-	var req {{.Name}}Request
-	if r.Method != http.MethodGet {
-		if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
-			http.Error(w, err.Error(), http.StatusBadRequest)
-			return
-		}
-	}
-
-	// TODO: implement handler logic
-	_ = ctx
-	_ = req
-
-	rsp := {{.Name}}Response{}
-	w.Header().Set("Content-Type", "application/json")
-	json.NewEncoder(w).Encode(rsp)
-}
-`
-
-var modelTemplate = `package model
-
-import (
-	"context"
-	"time"
-)
-
-// {{.Name}} represents a {{lower .Name}} in the system
-type {{.Name}} struct {
-	ID        string    ` + "`json:\"id\"`" + `
-	CreatedAt time.Time ` + "`json:\"created_at\"`" + `
-	UpdatedAt time.Time ` + "`json:\"updated_at\"`" + `
-	// Add your fields here
-}
-
-// {{.Name}}Repository defines the interface for {{lower .Name}} storage
-type {{.Name}}Repository interface {
-	Create(ctx context.Context, m *{{.Name}}) error
-	Get(ctx context.Context, id string) (*{{.Name}}, error)
-	Update(ctx context.Context, m *{{.Name}}) error
-	Delete(ctx context.Context, id string) error
-	List(ctx context.Context, offset, limit int) ([]*{{.Name}}, error)
-}
-`
-
-type handlerData struct {
-	Name    string
-	Methods []methodData
-}
-
-type methodData struct {
-	Name         string
-	RequestType  string
-	ResponseType string
-}
-
-type endpointData struct {
-	Name   string
-	Method string
-	Path   string
-}
-
-type modelData struct {
-	Name string
-}
-
-func generateHandler(c *cli.Context) error {
-	name := c.Args().First()
-	if name == "" {
-		return fmt.Errorf("handler name required: micro generate handler <name>")
-	}
-
-	name = strings.Title(strings.ToLower(name))
-
-	// Parse methods if provided
-	methods := []methodData{}
-	for _, m := range c.StringSlice("method") {
-		methods = append(methods, methodData{
-			Name:         strings.Title(m),
-			RequestType:  strings.Title(m) + "Request",
-			ResponseType: strings.Title(m) + "Response",
-		})
-	}
-
-	if len(methods) == 0 {
-		methods = []methodData{
-			{Name: "Handle", RequestType: "Request", ResponseType: "Response"},
-		}
-	}
-
-	data := handlerData{
-		Name:    name,
-		Methods: methods,
-	}
-
-	return generateFile("handler", strings.ToLower(name)+".go", handlerTemplate, data)
-}
-
-func generateEndpoint(c *cli.Context) error {
-	name := c.Args().First()
-	if name == "" {
-		return fmt.Errorf("endpoint name required: micro generate endpoint <name>")
-	}
-
-	data := endpointData{
-		Name:   strings.Title(strings.ToLower(name)),
-		Method: strings.ToUpper(c.String("method")),
-		Path:   c.String("path"),
-	}
-
-	if data.Path == "" {
-		data.Path = strings.ToLower(name)
-	}
-
-	return generateFile("handler", strings.ToLower(name)+"_endpoint.go", endpointTemplate, data)
-}
-
-func generateModel(c *cli.Context) error {
-	name := c.Args().First()
-	if name == "" {
-		return fmt.Errorf("model name required: micro generate model <name>")
-	}
-
-	data := modelData{
-		Name: strings.Title(strings.ToLower(name)),
-	}
-
-	return generateFile("model", strings.ToLower(name)+".go", modelTemplate, data)
-}
-
-func generateFile(dir, filename, tmplStr string, data interface{}) error {
-	// Create directory if it doesn't exist
-	if err := os.MkdirAll(dir, 0755); err != nil {
-		return fmt.Errorf("failed to create directory %s: %w", dir, err)
-	}
-
-	filepath := filepath.Join(dir, filename)
-
-	// Check if file exists
-	if _, err := os.Stat(filepath); err == nil {
-		return fmt.Errorf("file %s already exists", filepath)
-	}
-
-	fn := template.FuncMap{
-		"title": strings.Title,
-		"lower": strings.ToLower,
-	}
-
-	tmpl, err := template.New("gen").Funcs(fn).Parse(tmplStr)
-	if err != nil {
-		return fmt.Errorf("failed to parse template: %w", err)
-	}
-
-	f, err := os.Create(filepath)
-	if err != nil {
-		return fmt.Errorf("failed to create file: %w", err)
-	}
-	defer f.Close()
-
-	if err := tmpl.Execute(f, data); err != nil {
-		return fmt.Errorf("failed to execute template: %w", err)
-	}
-
-	fmt.Printf("Created %s\n", filepath)
-	return nil
-}
-
-func init() {
-	cmd.Register(&cli.Command{
-		Name:    "generate",
-		Usage:   "Generate code scaffolding (like Rails generators)",
-		Aliases: []string{"gen"},
-		Subcommands: []*cli.Command{
-			{
-				Name:   "handler",
-				Usage:  "Generate a handler: micro g handler <name>",
-				Action: generateHandler,
-				Flags: []cli.Flag{
-					&cli.StringSliceFlag{
-						Name:    "method",
-						Aliases: []string{"m"},
-						Usage:   "Methods to generate (can be repeated)",
-					},
-				},
-			},
-			{
-				Name:   "endpoint",
-				Usage:  "Generate an HTTP endpoint: micro g endpoint <name>",
-				Action: generateEndpoint,
-				Flags: []cli.Flag{
-					&cli.StringFlag{
-						Name:    "method",
-						Aliases: []string{"m"},
-						Usage:   "HTTP method (GET, POST, etc.)",
-						Value:   "POST",
-					},
-					&cli.StringFlag{
-						Name:    "path",
-						Aliases: []string{"p"},
-						Usage:   "URL path for the endpoint",
-					},
-				},
-			},
-			{
-				Name:   "model",
-				Usage:  "Generate a model: micro g model <name>",
-				Action: generateModel,
-			},
-		},
-	})
-}
@@ -1,269 +0,0 @@
-// Package initcmd provides the micro init command for server setup
-package initcmd
-
-import (
-	"fmt"
-	"os"
-	"os/exec"
-	"os/user"
-	"path/filepath"
-	"runtime"
-	"strings"
-
-	"github.com/urfave/cli/v2"
-	"go-micro.dev/v5/cmd"
-)
-
-const systemdTemplate = `[Unit]
-Description=Micro service: %%i
-After=network.target
-
-[Service]
-Type=simple
-User=%s
-Group=%s
-WorkingDirectory=%s
-ExecStart=%s/bin/%%i
-Restart=on-failure
-RestartSec=5
-EnvironmentFile=-%s/config/%%i.env
-
-# Logging
-StandardOutput=journal
-StandardError=journal
-SyslogIdentifier=micro-%%i
-
-# Security hardening
-NoNewPrivileges=true
-ProtectSystem=strict
-ProtectHome=true
-ReadWritePaths=%s/data
-
-[Install]
-WantedBy=multi-user.target
-`
-
-// Init initializes a server to receive micro deployments
-func Init(c *cli.Context) error {
-	if !c.Bool("server") {
-		return fmt.Errorf("usage: micro init --server\n\nInitialize this machine to receive micro deployments")
-	}
-
-	// Check if we're on Linux
-	if runtime.GOOS != "linux" {
-		return fmt.Errorf("micro init --server is only supported on Linux")
-	}
-
-	// Check for remote init
-	remoteHost := c.String("remote")
-	if remoteHost != "" {
-		return initRemote(c, remoteHost)
-	}
-
-	basePath := c.String("path")
-	userName := c.String("user")
-
-	fmt.Println("Initializing micro server...")
-	fmt.Println()
-
-	// Check if running as root (needed for systemd and creating users)
-	if os.Geteuid() != 0 {
-		return fmt.Errorf(`micro init --server requires root privileges.
-
-Run with sudo:
-  sudo micro init --server`)
-	}
-
-	// Create user if needed
-	if userName == "micro" {
-		if err := createMicroUser(); err != nil {
-			return err
-		}
-	}
-
-	// Create directories
-	fmt.Println("Creating directories:")
-	dirs := []string{
-		filepath.Join(basePath, "bin"),
-		filepath.Join(basePath, "data"),
-		filepath.Join(basePath, "config"),
-	}
-
-	for _, dir := range dirs {
-		if err := os.MkdirAll(dir, 0755); err != nil {
-			return fmt.Errorf("failed to create %s: %w", dir, err)
-		}
-		fmt.Printf("  ✓ %s\n", dir)
-	}
-
-	// Set ownership
-	if userName != "root" {
-		u, err := user.Lookup(userName)
-		if err != nil {
-			return fmt.Errorf("user %s not found: %w", userName, err)
-		}
-
-		// chown -R user:user /opt/micro
-		chownCmd := exec.Command("chown", "-R", fmt.Sprintf("%s:%s", u.Username, u.Username), basePath)
-		if err := chownCmd.Run(); err != nil {
-			return fmt.Errorf("failed to set ownership: %w", err)
-		}
-	}
-
-	fmt.Println()
-
-	// Create systemd template
-	fmt.Println("Creating systemd template:")
-	unitContent := fmt.Sprintf(systemdTemplate, userName, userName, basePath, basePath, basePath, basePath)
-	unitPath := "/etc/systemd/system/micro@.service"
-
-	if err := os.WriteFile(unitPath, []byte(unitContent), 0644); err != nil {
-		return fmt.Errorf("failed to write systemd unit: %w", err)
-	}
-	fmt.Printf("  ✓ %s\n", unitPath)
-
-	// Reload systemd
-	reloadCmd := exec.Command("systemctl", "daemon-reload")
-	if err := reloadCmd.Run(); err != nil {
-		return fmt.Errorf("failed to reload systemd: %w", err)
-	}
-	fmt.Println("  ✓ systemd daemon-reload")
-
-	// Write marker file so deploy can detect initialization
-	markerPath := filepath.Join(basePath, ".micro-initialized")
-	if err := os.WriteFile(markerPath, []byte("1\n"), 0644); err != nil {
-		return fmt.Errorf("failed to write marker: %w", err)
-	}
-
-	fmt.Println()
-	fmt.Println("Server ready!")
-	fmt.Println()
-	fmt.Println("  Deploy from your machine:")
-	fmt.Printf("    micro deploy user@%s\n", getHostname())
-	fmt.Println()
-	fmt.Println("  Manage services:")
-	fmt.Println("    sudo systemctl status micro@myservice")
-	fmt.Println("    sudo journalctl -u micro@myservice -f")
-	fmt.Println()
-
-	return nil
-}
-
-func createMicroUser() error {
-	// Check if user exists
-	if _, err := user.Lookup("micro"); err == nil {
-		return nil // user already exists
-	}
-
-	fmt.Println("Creating micro user:")
-	createCmd := exec.Command("useradd", "--system", "--no-create-home", "--shell", "/bin/false", "micro")
-	if err := createCmd.Run(); err != nil {
-		// Check if it's just because user already exists
-		if _, lookupErr := user.Lookup("micro"); lookupErr == nil {
-			return nil
-		}
-		return fmt.Errorf("failed to create micro user: %w", err)
-	}
-	fmt.Println("  ✓ Created user 'micro'")
-	return nil
-}
-
-func initRemote(c *cli.Context, host string) error {
-	fmt.Printf("Initializing micro on %s...\n\n", host)
-
-	// Check SSH connectivity first
-	if err := checkSSH(host); err != nil {
-		return err
-	}
-
-	basePath := c.String("path")
-	userName := c.String("user")
-
-	// Run micro init --server on remote
-	initCmd := fmt.Sprintf("sudo micro init --server --path %s --user %s", basePath, userName)
-
-	sshCmd := exec.Command("ssh", host, initCmd)
-	sshCmd.Stdout = os.Stdout
-	sshCmd.Stderr = os.Stderr
-
-	if err := sshCmd.Run(); err != nil {
-		return fmt.Errorf("remote init failed: %w", err)
-	}
-
-	return nil
-}
-
-func checkSSH(host string) error {
-	// Quick SSH test
-	testCmd := exec.Command("ssh", "-o", "ConnectTimeout=5", "-o", "BatchMode=yes", host, "echo ok")
-	output, err := testCmd.CombinedOutput()
-
-	if err != nil {
-		return fmt.Errorf(`✗ Cannot connect to %s
-
-  SSH connection failed. Check that:
-  • The server is reachable: ping %s
-  • SSH is configured: ssh %s
-  • Your key is added: ssh-add -l
-
-  Common fixes:
-  • Add SSH key: ssh-copy-id %s
-  • Check hostname in ~/.ssh/config
-
-  Error: %s`, host, host, host, host, strings.TrimSpace(string(output)))
-	}
-
-	return nil
-}
-
-func getHostname() string {
-	name, err := os.Hostname()
-	if err != nil {
-		return "this-server"
-	}
-	return name
-}
-
-func init() {
-	cmd.Register(&cli.Command{
-		Name:  "init",
-		Usage: "Initialize micro for development or server deployment",
-		Description: `Initialize micro on a server to receive deployments.
-
-Server setup:
-  sudo micro init --server
-
-This creates:
-  • /opt/micro/bin/     - service binaries
-  • /opt/micro/data/    - persistent data
-  • /opt/micro/config/  - environment files
-  • systemd template for managing services
-
-Remote setup:
-  micro init --server --remote user@host
-
-After init, deploy with:
-  micro deploy user@host`,
-		Action: Init,
-		Flags: []cli.Flag{
-			&cli.BoolFlag{
-				Name:  "server",
-				Usage: "Initialize as a deployment server",
-			},
-			&cli.StringFlag{
-				Name:  "path",
-				Usage: "Base path for micro (default: /opt/micro)",
-				Value: "/opt/micro",
-			},
-			&cli.StringFlag{
-				Name:  "user",
-				Usage: "User to run services as (default: micro)",
-				Value: "micro",
-			},
-			&cli.StringFlag{
-				Name:  "remote",
-				Usage: "Initialize a remote server via SSH",
-			},
-		},
-	})
-}
@@ -1,59 +1,32 @@
 package template

-var Makefile = `.PHONY: proto build run test clean docker
+var (
+	Makefile = `
+GOPATH:=$(shell go env GOPATH)
+.PHONY: init
+init:
+	go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
+	go install go-micro.dev/v5/cmd/protoc-gen-micro@latest
+	go install github.com/google/gnostic/cmd/protoc-gen-openapi@latest

-# Generate protobuf files
+.PHONY: api
+api:
+	protoc --openapi_out=. --proto_path=. proto/{{.Alias}}.proto
+
+.PHONY: proto
 proto:
-	protoc --proto_path=. --micro_out=. --go_out=. proto/*.proto
-
-# Build the service
+	protoc --proto_path=. --micro_out=. --go_out=:. proto/{{.Alias}}.proto
+	
+.PHONY: build
 build:
-	go build -o bin/{{.Alias}} .
+	go build -o {{.Alias}} *.go

-# Run the service
-run:
-	go run .
-
-# Run with hot reload (requires air: go install github.com/air-verse/air@latest)
-dev:
-	air
-
-# Run tests
+.PHONY: test
 test:
-	go test -v ./...
+	go test -v ./... -cover

-# Run tests with coverage
-test-coverage:
-	go test -v -coverprofile=coverage.out ./...
-	go tool cover -html=coverage.out -o coverage.html
-
-# Clean build artifacts
-clean:
-	rm -rf bin/ coverage.out coverage.html
-
-# Build Docker image
+.PHONY: docker
 docker:
-	docker build -t {{.Alias}}:latest .
-
-# Run with Docker Compose
-docker-up:
-	docker-compose up -d
-
-# Stop Docker Compose
-docker-down:
-	docker-compose down
-
-# Lint code
-lint:
-	golangci-lint run ./...
-
-# Format code
-fmt:
-	go fmt ./...
-	goimports -w .
-
-# Update dependencies
-deps:
-	go mod tidy
-	go mod download
+	docker build . -t {{.Alias}}:latest
 `
+)
@@ -1,367 +0,0 @@
-// Package remote provides remote server operations for micro
-package remote
-
-import (
-	"bufio"
-	"fmt"
-	"os"
-	"os/exec"
-	"path/filepath"
-	"strings"
-	"syscall"
-
-	"github.com/urfave/cli/v2"
-	"go-micro.dev/v5/cmd"
-)
-
-const defaultRemotePath = "/opt/micro"
-
-// Status shows status of services (local or remote)
-func Status(c *cli.Context) error {
-	remoteHost := c.String("remote")
-	if remoteHost != "" {
-		return remoteStatus(remoteHost)
-	}
-	return localStatus(c)
-}
-
-func localStatus(c *cli.Context) error {
-	homeDir, err := os.UserHomeDir()
-	if err != nil {
-		return fmt.Errorf("failed to get home dir: %w", err)
-	}
-	runDir := filepath.Join(homeDir, "micro", "run")
-	files, err := os.ReadDir(runDir)
-	if err != nil {
-		fmt.Println("No services running locally.")
-		fmt.Println("\nStart services with: micro run")
-		return nil
-	}
-
-	var hasServices bool
-	fmt.Printf("%-20s %-10s %-8s %s\n", "SERVICE", "STATUS", "PID", "DIRECTORY")
-	fmt.Println(strings.Repeat("-", 70))
-
-	for _, f := range files {
-		if f.IsDir() || !strings.HasSuffix(f.Name(), ".pid") {
-			continue
-		}
-		hasServices = true
-		service := f.Name()[:len(f.Name())-4]
-		pidFilePath := filepath.Join(runDir, f.Name())
-		pidFile, err := os.Open(pidFilePath)
-		if err != nil {
-			continue
-		}
-		var pid int
-		var dir string
-		scanner := bufio.NewScanner(pidFile)
-		if scanner.Scan() {
-			fmt.Sscanf(scanner.Text(), "%d", &pid)
-		}
-		if scanner.Scan() {
-			dir = scanner.Text()
-		}
-		pidFile.Close()
-
-		status := "\u2717 stopped"
-		if pid > 0 {
-			proc, err := os.FindProcess(pid)
-			if err == nil {
-				if err := proc.Signal(syscall.Signal(0)); err == nil {
-					status = "\u25cf running"
-				}
-			}
-		}
-		fmt.Printf("%-20s %-10s %-8d %s\n", service, status, pid, dir)
-	}
-
-	if !hasServices {
-		fmt.Println("No services running locally.")
-		fmt.Println("\nStart services with: micro run")
-	}
-
-	return nil
-}
-
-func remoteStatus(host string) error {
-	// Get list of micro services via systemctl
-	listCmd := exec.Command("ssh", host, "systemctl list-units 'micro@*' --no-legend --no-pager 2>/dev/null || true")
-	output, err := listCmd.Output()
-	if err != nil {
-		return fmt.Errorf("failed to get status from %s: %w", host, err)
-	}
-
-	lines := strings.Split(strings.TrimSpace(string(output)), "\n")
-	if len(lines) == 0 || (len(lines) == 1 && lines[0] == "") {
-		fmt.Printf("%s\n", host)
-		fmt.Println(strings.Repeat("\u2501", 50))
-		fmt.Println("\nNo services deployed.")
-		fmt.Println("\nDeploy with: micro deploy " + host)
-		return nil
-	}
-
-	fmt.Printf("%s\n", host)
-	fmt.Println(strings.Repeat("\u2501", 50))
-	fmt.Println()
-
-	for _, line := range lines {
-		if line == "" {
-			continue
-		}
-		parts := strings.Fields(line)
-		if len(parts) < 4 {
-			continue
-		}
-
-		unit := parts[0]
-		loadState := parts[1]
-		activeState := parts[2]
-		subState := parts[3]
-
-		// Extract service name from micro@servicename.service
-		serviceName := strings.TrimPrefix(unit, "micro@")
-		serviceName = strings.TrimSuffix(serviceName, ".service")
-
-		// Get more details
-		statusIcon := "\u25cf"
-		statusText := subState
-		if activeState != "active" || subState != "running" {
-			statusIcon = "\u2717"
-		}
-
-		_ = loadState // unused but parsed
-
-		fmt.Printf("  %-15s %s %s\n", serviceName, statusIcon, statusText)
-	}
-
-	fmt.Println()
-	return nil
-}
-
-// Logs shows logs for services (local or remote)
-func Logs(c *cli.Context) error {
-	remoteHost := c.String("remote")
-	service := c.Args().First()
-	follow := c.Bool("follow") || c.Bool("f")
-	lines := c.Int("lines")
-
-	if remoteHost != "" {
-		return remoteLogs(remoteHost, service, follow, lines)
-	}
-	return localLogs(c, service, follow, lines)
-}
-
-func localLogs(c *cli.Context, service string, follow bool, lines int) error {
-	homeDir, err := os.UserHomeDir()
-	if err != nil {
-		return fmt.Errorf("failed to get home dir: %w", err)
-	}
-	logDir := filepath.Join(homeDir, "micro", "logs")
-
-	if service == "" {
-		// List available logs
-		files, err := os.ReadDir(logDir)
-		if err != nil {
-			fmt.Println("No logs available.")
-			return nil
-		}
-
-		fmt.Println("Available logs:")
-		for _, f := range files {
-			if strings.HasSuffix(f.Name(), ".log") {
-				name := strings.TrimSuffix(f.Name(), ".log")
-				fmt.Printf("  %s\n", name)
-			}
-		}
-		fmt.Println("\nView logs: micro logs <service>")
-		return nil
-	}
-
-	logPath := filepath.Join(logDir, service+".log")
-	if _, err := os.Stat(logPath); os.IsNotExist(err) {
-		return fmt.Errorf("no logs for service '%s'", service)
-	}
-
-	if follow {
-		cmd := exec.Command("tail", "-f", logPath)
-		cmd.Stdout = os.Stdout
-		cmd.Stderr = os.Stderr
-		return cmd.Run()
-	}
-
-	if lines == 0 {
-		lines = 100
-	}
-	cmd := exec.Command("tail", "-n", fmt.Sprintf("%d", lines), logPath)
-	cmd.Stdout = os.Stdout
-	cmd.Stderr = os.Stderr
-	return cmd.Run()
-}
-
-func remoteLogs(host, service string, follow bool, lines int) error {
-	var journalCmd string
-
-	if service == "" {
-		// All micro services
-		journalCmd = "journalctl -u 'micro@*'"
-	} else {
-		journalCmd = fmt.Sprintf("journalctl -u 'micro@%s'", service)
-	}
-
-	if follow {
-		journalCmd += " -f"
-	} else {
-		if lines == 0 {
-			lines = 100
-		}
-		journalCmd += fmt.Sprintf(" -n %d", lines)
-	}
-
-	journalCmd += " --no-pager"
-
-	sshCmd := exec.Command("ssh", host, journalCmd)
-	sshCmd.Stdout = os.Stdout
-	sshCmd.Stderr = os.Stderr
-	return sshCmd.Run()
-}
-
-// Stop stops a running service
-func Stop(c *cli.Context) error {
-	if c.Args().Len() != 1 {
-		return fmt.Errorf("Usage: micro stop <service>")
-	}
-
-	service := c.Args().First()
-	remoteHost := c.String("remote")
-
-	if remoteHost != "" {
-		return remoteStop(remoteHost, service)
-	}
-	return localStop(service)
-}
-
-func localStop(service string) error {
-	homeDir, err := os.UserHomeDir()
-	if err != nil {
-		return fmt.Errorf("failed to get home dir: %w", err)
-	}
-
-	runDir := filepath.Join(homeDir, "micro", "run")
-	pidFilePath := filepath.Join(runDir, service+".pid")
-
-	pidFile, err := os.Open(pidFilePath)
-	if err != nil {
-		return fmt.Errorf("service '%s' is not running", service)
-	}
-
-	var pid int
-	scanner := bufio.NewScanner(pidFile)
-	if scanner.Scan() {
-		fmt.Sscanf(scanner.Text(), "%d", &pid)
-	}
-	pidFile.Close()
-
-	if pid <= 0 {
-		_ = os.Remove(pidFilePath)
-		return fmt.Errorf("service '%s' is not running", service)
-	}
-
-	proc, err := os.FindProcess(pid)
-	if err != nil {
-		_ = os.Remove(pidFilePath)
-		return fmt.Errorf("could not find process for '%s'", service)
-	}
-
-	if err := proc.Signal(syscall.SIGTERM); err != nil {
-		_ = os.Remove(pidFilePath)
-		return fmt.Errorf("failed to stop service '%s': %v", service, err)
-	}
-
-	_ = os.Remove(pidFilePath)
-	fmt.Printf("Stopped %s (pid %d)\n", service, pid)
-	return nil
-}
-
-func remoteStop(host, service string) error {
-	stopCmd := fmt.Sprintf("sudo systemctl stop micro@%s", service)
-	sshCmd := exec.Command("ssh", host, stopCmd)
-	if output, err := sshCmd.CombinedOutput(); err != nil {
-		return fmt.Errorf("failed to stop %s: %s", service, string(output))
-	}
-	fmt.Printf("Stopped %s on %s\n", service, host)
-	return nil
-}
-
-func init() {
-	cmd.Register(&cli.Command{
-		Name:  "status",
-		Usage: "Check status of running services",
-		Description: `Show status of running services.
-
-Local status:
-  micro status
-
-Remote status:
-  micro status --remote user@host`,
-		Action: Status,
-		Flags: []cli.Flag{
-			&cli.StringFlag{
-				Name:  "remote",
-				Usage: "Check status on remote server",
-			},
-		},
-	})
-
-	cmd.Register(&cli.Command{
-		Name:  "logs",
-		Usage: "Show logs for a service",
-		Description: `View service logs.
-
-Local logs:
-  micro logs              # list available logs
-  micro logs myservice    # show logs for myservice
-  micro logs myservice -f # follow logs
-
-Remote logs:
-  micro logs --remote user@host
-  micro logs myservice --remote user@host -f`,
-		Action: Logs,
-		Flags: []cli.Flag{
-			&cli.StringFlag{
-				Name:  "remote",
-				Usage: "View logs on remote server",
-			},
-			&cli.BoolFlag{
-				Name:    "follow",
-				Aliases: []string{"f"},
-				Usage:   "Follow log output",
-			},
-			&cli.IntFlag{
-				Name:    "lines",
-				Aliases: []string{"n"},
-				Usage:   "Number of lines to show (default: 100)",
-				Value:   100,
-			},
-		},
-	})
-
-	cmd.Register(&cli.Command{
-		Name:  "stop",
-		Usage: "Stop a running service",
-		Description: `Stop a running service.
-
-Local:
-  micro stop myservice
-
-Remote:
-  micro stop myservice --remote user@host`,
-		Action: Stop,
-		Flags: []cli.Flag{
-			&cli.StringFlag{
-				Name:  "remote",
-				Usage: "Stop service on remote server",
-			},
-		},
-	})
-}
@@ -1,8 +1,16 @@
-module example
+module go-micro.dev/v5/cmd/micro

-go 1.24
+go 1.24.1

-require go-micro.dev/v5 v5.16.0
+require (
+	github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc
+	github.com/golang-jwt/jwt/v5 v5.3.0
+	github.com/stretchr/objx v0.5.2
+	github.com/urfave/cli/v2 v2.27.6
+	github.com/xlab/treeprint v1.2.0
+	go-micro.dev/v5 v5.11.0
+	golang.org/x/crypto v0.37.0
+)

 require (
 	dario.cat/mergo v1.0.2 // indirect
@@ -45,7 +53,6 @@ require (
 	github.com/pkg/errors v0.9.1 // indirect
 	github.com/rabbitmq/amqp091-go v1.10.0 // indirect
 	github.com/russross/blackfriday/v2 v2.1.0 // indirect
-	github.com/urfave/cli/v2 v2.27.6 // indirect
 	github.com/xrash/smetrics v0.0.0-20240521201337-686a1a2994c1 // indirect
 	go.etcd.io/bbolt v1.4.0 // indirect
 	go.etcd.io/etcd/api/v3 v3.5.21 // indirect
@@ -53,7 +60,6 @@ require (
 	go.etcd.io/etcd/client/v3 v3.5.21 // indirect
 	go.uber.org/multierr v1.10.0 // indirect
 	go.uber.org/zap v1.27.0 // indirect
-	golang.org/x/crypto v0.37.0 // indirect
 	golang.org/x/exp v0.0.0-20250305212735-054e65f0b394 // indirect
 	golang.org/x/mod v0.24.0 // indirect
 	golang.org/x/net v0.38.0 // indirect
@@ -66,5 +72,3 @@ require (
 	google.golang.org/grpc v1.71.1 // indirect
 	google.golang.org/protobuf v1.36.6 // indirect
 )
-
-replace go-micro.dev/v5 => ../..
@@ -64,6 +64,8 @@ github.com/godbus/dbus/v5 v5.0.4/go.mod h1:xhWf0FNVPg57R7Z0UbKHbJfkEywrmjJnf7w5x
 github.com/gogo/protobuf v1.1.1/go.mod h1:r8qH/GZQm5c6nD/R0oafs1akxWv10x8SbQlK7atdtwQ=
 github.com/gogo/protobuf v1.3.2 h1:Ov1cvc58UF3b5XjBnZv7+opcTcQFZebYjWzi34vdm4Q=
 github.com/gogo/protobuf v1.3.2/go.mod h1:P1XiOD3dCwIKUDQYPy72D8LYyHL2YPYrpS2s69NZV8Q=
+github.com/golang-jwt/jwt/v5 v5.3.0 h1:pv4AsKCKKZuqlgs5sUmn4x8UlGa0kEVt/puTpKx9vvo=
+github.com/golang-jwt/jwt/v5 v5.3.0/go.mod h1:fxCRLWMO43lRc8nhHWY6LGqRcf+1gQWArsqaEUEa5bE=
 github.com/golang/protobuf v1.2.0/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
 github.com/golang/protobuf v1.3.1/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
 github.com/golang/protobuf v1.3.2/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
@@ -239,6 +241,7 @@ github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/
 github.com/stretchr/testify v1.2.2/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs=
 github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
 github.com/stretchr/testify v1.4.0/go.mod h1:j7eGeouHqKxXV5pUuKE4zz7dFj8WfuZ+81PSLYec5m4=
+github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
 github.com/stretchr/testify v1.7.2/go.mod h1:R6va5+xMeoiuVRoj+gSkQ7d3FALtqAAGI1FQKckRals=
 github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
 github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
@@ -247,11 +250,15 @@ github.com/test-go/testify v1.1.4/go.mod h1:rH7cfJo/47vWGdi4GPj16x3/t1xGOj2YxzmN
 github.com/tv42/httpunix v0.0.0-20150427012821-b75d8614f926/go.mod h1:9ESjWnEqriFuLhtthL60Sar/7RFoluCcXsuvEwTV5KM=
 github.com/urfave/cli/v2 v2.27.6 h1:VdRdS98FNhKZ8/Az8B7MTyGQmpIr36O1EHybx/LaZ4g=
 github.com/urfave/cli/v2 v2.27.6/go.mod h1:3Sevf16NykTbInEnD0yKkjDAeZDS0A6bzhBH5hrMvTQ=
+github.com/xlab/treeprint v1.2.0 h1:HzHnuAF1plUN2zGlAFHbSQP2qJ0ZAD3XF5XD7OesXRQ=
+github.com/xlab/treeprint v1.2.0/go.mod h1:gj5Gd3gPdKtR1ikdDK6fnFLdmIS0X30kTTuNd/WEJu0=
 github.com/xrash/smetrics v0.0.0-20240521201337-686a1a2994c1 h1:gEOO8jv9F4OT7lGCjxCBTO/36wtF6j2nSip77qHd4x4=
 github.com/xrash/smetrics v0.0.0-20240521201337-686a1a2994c1/go.mod h1:Ohn+xnUBiLI6FVj/9LpzZWtj1/D6lUovWYBkxHVV3aM=
 github.com/yuin/goldmark v1.1.27/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=
 github.com/yuin/goldmark v1.2.1/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=
 github.com/yuin/goldmark v1.3.5/go.mod h1:mwnBkeHKe2W/ZEtQ+71ViKU8L12m81fl3OWwC1Zlc8k=
+go-micro.dev/v5 v5.11.0 h1:Ild7kJ87KNetw/lLyemVlIR7DzaVrbQtFTJJQKT0DPI=
+go-micro.dev/v5 v5.11.0/go.mod h1:mmDdppSKjomfRVogN4WjGX9OUXT+1vNCTV1stSaXEq4=
 go.etcd.io/bbolt v1.4.0 h1:TU77id3TnN/zKr7CO/uk+fBCwF2jGcMuw2B/FMAzYIk=
 go.etcd.io/bbolt v1.4.0/go.mod h1:AsD+OCi/qPN1giOX1aiLAha3o1U8rAz65bvN4j0sRuk=
 go.etcd.io/etcd/api/v3 v3.5.21 h1:A6O2/JDb3tvHhiIz3xf9nJ7REHvtEFJJ3veW3FbCnS8=
@@ -381,5 +388,6 @@ gopkg.in/yaml.v2 v2.2.4/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
 gopkg.in/yaml.v2 v2.2.5/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
 gopkg.in/yaml.v2 v2.4.0 h1:D8xgwECY7CYvx+Y2n4sBz93Jn9JRvxdiyyo8CTfuKaY=
 gopkg.in/yaml.v2 v2.4.0/go.mod h1:RDklbk79AGWmwhnvt/jBztapEOGDOx6ZbXqjP6csGnQ=
+gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
 gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
 gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
@@ -5,9 +5,6 @@ import (
 	"go-micro.dev/v5/cmd"

 	_ "go-micro.dev/v5/cmd/micro/cli"
-	_ "go-micro.dev/v5/cmd/micro/cli/build"
-	_ "go-micro.dev/v5/cmd/micro/cli/deploy"
-	_ "go-micro.dev/v5/cmd/micro/mcp"
 	_ "go-micro.dev/v5/cmd/micro/run"
 	"go-micro.dev/v5/cmd/micro/server"
 )
@@ -1,359 +0,0 @@
-// Package mcp provides the 'micro mcp' command for MCP server management
-package mcp
-
-import (
-	"context"
-	"encoding/json"
-	"fmt"
-	"log"
-	"os"
-	"os/signal"
-	"strings"
-	"syscall"
-
-	"github.com/urfave/cli/v2"
-	"go-micro.dev/v5/client"
-	"go-micro.dev/v5/cmd"
-	"go-micro.dev/v5/codec/bytes"
-	"go-micro.dev/v5/gateway/mcp"
-	"go-micro.dev/v5/registry"
-)
-
-func init() {
-	cmd.Register(&cli.Command{
-		Name:  "mcp",
-		Usage: "MCP server management",
-		Description: `Manage MCP (Model Context Protocol) server for AI agent integration.
-
-Examples:
-  # Start MCP server (stdio for Claude Code)
-  micro mcp serve
-
-  # Start MCP server with HTTP/SSE
-  micro mcp serve --address :3000
-
-  # List available tools
-  micro mcp list
-
-  # Test a tool
-  micro mcp test users.Users.Get
-
-The 'micro mcp' command exposes your microservices as AI-accessible tools via the
-Model Context Protocol (MCP). This enables Claude Code, ChatGPT, and other AI agents
-to discover and call your services automatically.
-
-For Claude Code integration, add to your config:
-  {
-    "mcpServers": {
-      "my-services": {
-        "command": "micro",
-        "args": ["mcp", "serve"]
-      }
-    }
-  }`,
-		Subcommands: []*cli.Command{
-			{
-				Name:  "serve",
-				Usage: "Start MCP server",
-				Description: `Start an MCP server to expose microservices as AI tools.
-
-By default, uses stdio transport (for Claude Code and local AI tools).
-Use --address for HTTP/SSE transport (for web-based agents).
-
-Examples:
-  # Stdio transport (for Claude Code)
-  micro mcp serve
-
-  # HTTP/SSE transport
-  micro mcp serve --address :3000
-
-  # Custom registry
-  micro mcp serve --registry consul --registry_address consul:8500`,
-				Flags: []cli.Flag{
-					&cli.StringFlag{
-						Name:  "address",
-						Usage: "HTTP address to listen on (e.g., :3000). If not set, uses stdio.",
-					},
-					&cli.StringFlag{
-						Name:  "registry",
-						Usage: "Registry for service discovery (mdns, consul, etcd)",
-						Value: "mdns",
-					},
-					&cli.StringFlag{
-						Name:  "registry_address",
-						Usage: "Registry address (e.g., consul:8500)",
-					},
-				},
-				Action: serveAction,
-			},
-			{
-				Name:  "list",
-				Usage: "List available tools",
-				Description: `List all tools available via MCP.
-
-Each service endpoint is exposed as a tool that AI agents can call.
-
-Example:
-  micro mcp list`,
-				Flags: []cli.Flag{
-					&cli.StringFlag{
-						Name:  "registry",
-						Usage: "Registry for service discovery (mdns, consul, etcd)",
-						Value: "mdns",
-					},
-					&cli.StringFlag{
-						Name:  "registry_address",
-						Usage: "Registry address",
-					},
-					&cli.BoolFlag{
-						Name:  "json",
-						Usage: "Output as JSON",
-					},
-				},
-				Action: listAction,
-			},
-			{
-				Name:  "test",
-				Usage: "Test a tool",
-				Description: `Test calling a specific tool.
-
-Example:
-  micro mcp test users.Users.Get '{"id": "123"}'`,
-				Flags: []cli.Flag{
-					&cli.StringFlag{
-						Name:  "registry",
-						Usage: "Registry for service discovery",
-						Value: "mdns",
-					},
-					&cli.StringFlag{
-						Name:  "registry_address",
-						Usage: "Registry address",
-					},
-				},
-				Action: testAction,
-			},
-		},
-	})
-}
-
-// serveAction starts the MCP server
-func serveAction(ctx *cli.Context) error {
-	// Get registry
-	reg := registry.DefaultRegistry
-	if regName := ctx.String("registry"); regName != "" {
-		// TODO: Support other registries (consul, etcd)
-		if regName != "mdns" {
-			return fmt.Errorf("registry %s not yet supported, use mdns", regName)
-		}
-	}
-
-	// Create MCP server options
-	opts := mcp.Options{
-		Registry: reg,
-		Address:  ctx.String("address"),
-		Context:  context.Background(),
-		Logger:   log.Default(),
-	}
-
-	// Handle shutdown gracefully
-	ctx2, cancel := context.WithCancel(opts.Context)
-	opts.Context = ctx2
-	defer cancel()
-
-	sigChan := make(chan os.Signal, 1)
-	signal.Notify(sigChan, os.Interrupt, syscall.SIGTERM)
-	go func() {
-		<-sigChan
-		cancel()
-	}()
-
-	// Start MCP server
-	return mcp.Serve(opts)
-}
-
-// listAction lists available tools
-func listAction(ctx *cli.Context) error {
-	// Get registry
-	reg := registry.DefaultRegistry
-
-	// Create temporary MCP server to discover tools
-	opts := mcp.Options{
-		Registry: reg,
-		Context:  context.Background(),
-		Logger:   log.New(os.Stderr, "", 0), // Log to stderr so stdout is clean
-	}
-
-	// Discover services
-	services, err := opts.Registry.ListServices()
-	if err != nil {
-		return fmt.Errorf("failed to list services: %w", err)
-	}
-
-	if ctx.Bool("json") {
-		// JSON output
-		var tools []map[string]interface{}
-		for _, svc := range services {
-			fullSvcs, err := opts.Registry.GetService(svc.Name)
-			if err != nil || len(fullSvcs) == 0 {
-				continue
-			}
-
-			for _, ep := range fullSvcs[0].Endpoints {
-				tools = append(tools, map[string]interface{}{
-					"name":        fmt.Sprintf("%s.%s", svc.Name, ep.Name),
-					"service":     svc.Name,
-					"endpoint":    ep.Name,
-					"description": fmt.Sprintf("Call %s on %s service", ep.Name, svc.Name),
-				})
-			}
-		}
-
-		enc := json.NewEncoder(os.Stdout)
-		enc.SetIndent("", "  ")
-		return enc.Encode(map[string]interface{}{
-			"tools": tools,
-			"count": len(tools),
-		})
-	}
-
-	// Human-readable output
-	fmt.Printf("Available MCP Tools:\n\n")
-	toolCount := 0
-	for _, svc := range services {
-		fullSvcs, err := opts.Registry.GetService(svc.Name)
-		if err != nil || len(fullSvcs) == 0 {
-			continue
-		}
-
-		fmt.Printf("Service: %s\n", svc.Name)
-		for _, ep := range fullSvcs[0].Endpoints {
-			toolName := fmt.Sprintf("%s.%s", svc.Name, ep.Name)
-			fmt.Printf("  • %s\n", toolName)
-			toolCount++
-		}
-		fmt.Println()
-	}
-
-	fmt.Printf("Total: %d tools\n", toolCount)
-	return nil
-}
-
-// testAction tests a specific tool
-func testAction(ctx *cli.Context) error {
-	if ctx.Args().Len() < 1 {
-		return fmt.Errorf("usage: micro mcp test <tool-name> [input-json]")
-	}
-
-	toolName := ctx.Args().First()
-	inputJSON := "{}"
-	if ctx.Args().Len() > 1 {
-		inputJSON = ctx.Args().Get(1)
-	}
-
-	// Validate input JSON
-	var inputData map[string]interface{}
-	if err := json.Unmarshal([]byte(inputJSON), &inputData); err != nil {
-		return fmt.Errorf("invalid JSON input: %w", err)
-	}
-
-	// Get registry
-	reg := registry.DefaultRegistry
-	if regName := ctx.String("registry"); regName != "" {
-		if regName != "mdns" {
-			return fmt.Errorf("registry %s not yet supported, use mdns", regName)
-		}
-	}
-
-	// Create MCP options
-	opts := mcp.Options{
-		Registry: reg,
-		Context:  context.Background(),
-		Logger:   log.New(os.Stderr, "", 0),
-	}
-
-	// Parse tool name (format: "service.endpoint" or "service.Handler.Method")
-	parts := parseTool(toolName)
-	if len(parts) < 2 {
-		return fmt.Errorf("invalid tool name format. Expected: service.endpoint or service.Handler.Method")
-	}
-
-	serviceName := parts[0]
-	endpointName := parts[1]
-	
-	// If tool name has 3 parts, combine last two for endpoint (e.g., Handler.Method)
-	if len(parts) == 3 {
-		endpointName = parts[1] + "." + parts[2]
-	}
-
-	// Discover the tool from registry
-	services, err := opts.Registry.GetService(serviceName)
-	if err != nil || len(services) == 0 {
-		return fmt.Errorf("service %s not found: %w", serviceName, err)
-	}
-
-	// Find the endpoint
-	var endpoint *registry.Endpoint
-	for _, ep := range services[0].Endpoints {
-		if ep.Name == endpointName {
-			endpoint = ep
-			break
-		}
-	}
-
-	if endpoint == nil {
-		return fmt.Errorf("endpoint %s not found in service %s", endpointName, serviceName)
-	}
-
-	// Display test info
-	fmt.Printf("Testing tool: %s\n", toolName)
-	fmt.Printf("Service: %s\n", serviceName)
-	fmt.Printf("Endpoint: %s\n", endpointName)
-	fmt.Printf("Input: %s\n\n", inputJSON)
-
-	// Convert input to JSON bytes for RPC call
-	inputBytes, err := json.Marshal(inputData)
-	if err != nil {
-		return fmt.Errorf("failed to marshal input: %w", err)
-	}
-
-	// Make RPC call using bytes codec
-	c := opts.Client
-	if c == nil {
-		c = client.DefaultClient
-	}
-	
-	// Create request with bytes frame
-	req := c.NewRequest(serviceName, endpointName, &bytes.Frame{Data: inputBytes})
-	
-	// Make the call
-	var rsp bytes.Frame
-	if err := c.Call(opts.Context, req, &rsp); err != nil {
-		fmt.Printf("❌ Call failed: %v\n", err)
-		return err
-	}
-
-	// Parse and display response
-	fmt.Println("✅ Call successful!")
-	fmt.Println("\nResponse:")
-	
-	// Try to pretty-print JSON response
-	var result interface{}
-	if err := json.Unmarshal(rsp.Data, &result); err == nil {
-		prettyJSON, err := json.MarshalIndent(result, "", "  ")
-		if err == nil {
-			fmt.Println(string(prettyJSON))
-		} else {
-			fmt.Println(string(rsp.Data))
-		}
-	} else {
-		// Not JSON, print raw
-		fmt.Println(string(rsp.Data))
-	}
-
-	return nil
-}
-
-// parseTool splits a tool name into service and endpoint parts
-func parseTool(toolName string) []string {
-	return strings.Split(toolName, ".")
-}
@@ -1,49 +0,0 @@
-package mcp
-
-import (
-	"reflect"
-	"testing"
-)
-
-func TestParseTool(t *testing.T) {
-	tests := []struct {
-		name     string
-		toolName string
-		want     []string
-	}{
-		{
-			name:     "simple two-part tool",
-			toolName: "service.endpoint",
-			want:     []string{"service", "endpoint"},
-		},
-		{
-			name:     "three-part tool (service.Handler.Method)",
-			toolName: "greeter.Greeter.Hello",
-			want:     []string{"greeter", "Greeter", "Hello"},
-		},
-		{
-			name:     "single part (invalid)",
-			toolName: "service",
-			want:     []string{"service"},
-		},
-		{
-			name:     "four-part tool",
-			toolName: "users.Users.Get.All",
-			want:     []string{"users", "Users", "Get", "All"},
-		},
-		{
-			name:     "empty string",
-			toolName: "",
-			want:     []string{""},
-		},
-	}
-
-	for _, tt := range tests {
-		t.Run(tt.name, func(t *testing.T) {
-			got := parseTool(tt.toolName)
-			if !reflect.DeepEqual(got, tt.want) {
-				t.Errorf("parseTool(%q) = %v, want %v", tt.toolName, got, tt.want)
-			}
-		})
-	}
-}
@@ -1,284 +0,0 @@
-// Package config handles micro.mu and micro.json configuration parsing
-package config
-
-import (
-	"bufio"
-	"encoding/json"
-	"fmt"
-	"os"
-	"path/filepath"
-	"strconv"
-	"strings"
-)
-
-// Config represents the micro run configuration
-type Config struct {
-	Services map[string]*Service          `json:"services"`
-	Envs     map[string]map[string]string `json:"env"`
-	Deploy   map[string]*DeployTarget     `json:"deploy"`
-}
-
-// DeployTarget represents a deployment target configuration
-type DeployTarget struct {
-	Name string `json:"-"`
-	SSH  string `json:"ssh"`
-	Path string `json:"path,omitempty"`
-}
-
-// Service represents a service configuration
-type Service struct {
-	Name    string   `json:"-"`
-	Path    string   `json:"path"`
-	Port    int      `json:"port,omitempty"`
-	Depends []string `json:"depends,omitempty"`
-}
-
-// Load attempts to load configuration from micro.mu or micro.json in the given directory
-func Load(dir string) (*Config, error) {
-	// Try micro.mu first (preferred)
-	muPath := filepath.Join(dir, "micro.mu")
-	if _, err := os.Stat(muPath); err == nil {
-		return ParseMu(muPath)
-	}
-
-	// Fall back to micro.json
-	jsonPath := filepath.Join(dir, "micro.json")
-	if _, err := os.Stat(jsonPath); err == nil {
-		return ParseJSON(jsonPath)
-	}
-
-	return nil, nil // No config file, not an error
-}
-
-// ParseJSON parses a micro.json configuration file
-func ParseJSON(path string) (*Config, error) {
-	data, err := os.ReadFile(path)
-	if err != nil {
-		return nil, fmt.Errorf("failed to read %s: %w", path, err)
-	}
-
-	var cfg Config
-	if err := json.Unmarshal(data, &cfg); err != nil {
-		return nil, fmt.Errorf("failed to parse %s: %w", path, err)
-	}
-
-	// Set service names from map keys
-	for name, svc := range cfg.Services {
-		svc.Name = name
-	}
-
-	return &cfg, nil
-}
-
-// ParseMu parses a micro.mu DSL configuration file
-//
-// Format:
-//
-//	service users
-//	    path ./users
-//	    port 8081
-//
-//	service posts
-//	    path ./posts
-//	    port 8082
-//	    depends users
-//
-//	env development
-//	    STORE_ADDRESS file://./data
-func ParseMu(path string) (*Config, error) {
-	file, err := os.Open(path)
-	if err != nil {
-		return nil, fmt.Errorf("failed to open %s: %w", path, err)
-	}
-	defer file.Close()
-
-	cfg := &Config{
-		Services: make(map[string]*Service),
-		Envs:     make(map[string]map[string]string),
-		Deploy:   make(map[string]*DeployTarget),
-	}
-
-	var currentService *Service
-	var currentEnv string
-	var currentEnvMap map[string]string
-	var currentDeploy *DeployTarget
-
-	scanner := bufio.NewScanner(file)
-	lineNum := 0
-
-	for scanner.Scan() {
-		lineNum++
-		line := scanner.Text()
-
-		// Skip empty lines and comments
-		trimmed := strings.TrimSpace(line)
-		if trimmed == "" || strings.HasPrefix(trimmed, "#") {
-			continue
-		}
-
-		// Check indentation
-		indented := strings.HasPrefix(line, "    ") || strings.HasPrefix(line, "\t")
-
-		if !indented {
-			// Top-level declaration
-			parts := strings.Fields(trimmed)
-			if len(parts) < 2 {
-				return nil, fmt.Errorf("%s:%d: expected 'service <name>' or 'env <name>'", path, lineNum)
-			}
-
-			keyword := parts[0]
-			name := parts[1]
-
-			switch keyword {
-			case "service":
-				// Save previous env if any
-				if currentEnv != "" && currentEnvMap != nil {
-					cfg.Envs[currentEnv] = currentEnvMap
-				}
-				currentEnv = ""
-				currentEnvMap = nil
-
-				currentService = &Service{Name: name}
-				cfg.Services[name] = currentService
-
-			case "env":
-				// Save previous env if any
-				if currentEnv != "" && currentEnvMap != nil {
-					cfg.Envs[currentEnv] = currentEnvMap
-				}
-				currentService = nil
-				currentDeploy = nil
-				currentEnv = name
-				currentEnvMap = make(map[string]string)
-
-			case "deploy":
-				// Save previous env if any
-				if currentEnv != "" && currentEnvMap != nil {
-					cfg.Envs[currentEnv] = currentEnvMap
-				}
-				currentService = nil
-				currentEnv = ""
-				currentEnvMap = nil
-				currentDeploy = &DeployTarget{Name: name}
-				cfg.Deploy[name] = currentDeploy
-
-			default:
-				return nil, fmt.Errorf("%s:%d: unknown keyword '%s'", path, lineNum, keyword)
-			}
-		} else {
-			// Indented property
-			parts := strings.Fields(trimmed)
-			if len(parts) < 2 {
-				return nil, fmt.Errorf("%s:%d: expected 'key value'", path, lineNum)
-			}
-
-			key := parts[0]
-			value := strings.Join(parts[1:], " ")
-
-			if currentService != nil {
-				switch key {
-				case "path":
-					currentService.Path = value
-				case "port":
-					port, err := strconv.Atoi(value)
-					if err != nil {
-						return nil, fmt.Errorf("%s:%d: invalid port '%s'", path, lineNum, value)
-					}
-					currentService.Port = port
-				case "depends":
-					currentService.Depends = parts[1:]
-				default:
-					return nil, fmt.Errorf("%s:%d: unknown service property '%s'", path, lineNum, key)
-				}
-			} else if currentDeploy != nil {
-				switch key {
-				case "ssh":
-					currentDeploy.SSH = value
-				case "path":
-					currentDeploy.Path = value
-				default:
-					return nil, fmt.Errorf("%s:%d: unknown deploy property '%s'", path, lineNum, key)
-				}
-			} else if currentEnvMap != nil {
-				// Environment variable
-				currentEnvMap[key] = value
-			} else {
-				return nil, fmt.Errorf("%s:%d: property outside of service, deploy, or env block", path, lineNum)
-			}
-		}
-	}
-
-	// Save final env if any
-	if currentEnv != "" && currentEnvMap != nil {
-		cfg.Envs[currentEnv] = currentEnvMap
-	}
-
-	if err := scanner.Err(); err != nil {
-		return nil, fmt.Errorf("error reading %s: %w", path, err)
-	}
-
-	return cfg, nil
-}
-
-// TopologicalSort returns services in dependency order
-func (c *Config) TopologicalSort() ([]*Service, error) {
-	if c == nil || len(c.Services) == 0 {
-		return nil, nil
-	}
-
-	// Build adjacency list and in-degree count
-	inDegree := make(map[string]int)
-	for name := range c.Services {
-		inDegree[name] = 0
-	}
-
-	for _, svc := range c.Services {
-		for _, dep := range svc.Depends {
-			if _, ok := c.Services[dep]; !ok {
-				return nil, fmt.Errorf("service '%s' depends on unknown service '%s'", svc.Name, dep)
-			}
-			inDegree[svc.Name]++
-		}
-	}
-
-	// Kahn's algorithm
-	var queue []string
-	for name, degree := range inDegree {
-		if degree == 0 {
-			queue = append(queue, name)
-		}
-	}
-
-	var result []*Service
-	for len(queue) > 0 {
-		name := queue[0]
-		queue = queue[1:]
-		result = append(result, c.Services[name])
-
-		// Reduce in-degree for dependents
-		for _, svc := range c.Services {
-			for _, dep := range svc.Depends {
-				if dep == name {
-					inDegree[svc.Name]--
-					if inDegree[svc.Name] == 0 {
-						queue = append(queue, svc.Name)
-					}
-				}
-			}
-		}
-	}
-
-	if len(result) != len(c.Services) {
-		return nil, fmt.Errorf("circular dependency detected")
-	}
-
-	return result, nil
-}
-
-// GetEnv returns environment variables for the given environment name
-func (c *Config) GetEnv(name string) map[string]string {
-	if c == nil || c.Envs == nil {
-		return nil
-	}
-	return c.Envs[name]
-}
@@ -1,217 +0,0 @@
-package config
-
-import (
-	"os"
-	"path/filepath"
-	"testing"
-)
-
-func TestParseMu(t *testing.T) {
-	content := `# Micro configuration
-service users
-    path ./users
-    port 8081
-
-service posts
-    path ./posts
-    port 8082
-    depends users
-
-service web
-    path ./web
-    port 8089
-    depends users posts
-
-env development
-    STORE_ADDRESS file://./data
-    DEBUG true
-
-env production
-    STORE_ADDRESS postgres://localhost/db
-`
-
-	tmpDir := t.TempDir()
-	muPath := filepath.Join(tmpDir, "micro.mu")
-	if err := os.WriteFile(muPath, []byte(content), 0644); err != nil {
-		t.Fatal(err)
-	}
-
-	cfg, err := ParseMu(muPath)
-	if err != nil {
-		t.Fatalf("ParseMu failed: %v", err)
-	}
-
-	// Check services
-	if len(cfg.Services) != 3 {
-		t.Errorf("expected 3 services, got %d", len(cfg.Services))
-	}
-
-	users := cfg.Services["users"]
-	if users == nil {
-		t.Fatal("users service not found")
-	}
-	if users.Path != "./users" {
-		t.Errorf("users.Path = %q, want %q", users.Path, "./users")
-	}
-	if users.Port != 8081 {
-		t.Errorf("users.Port = %d, want %d", users.Port, 8081)
-	}
-
-	posts := cfg.Services["posts"]
-	if posts == nil {
-		t.Fatal("posts service not found")
-	}
-	if len(posts.Depends) != 1 || posts.Depends[0] != "users" {
-		t.Errorf("posts.Depends = %v, want [users]", posts.Depends)
-	}
-
-	web := cfg.Services["web"]
-	if web == nil {
-		t.Fatal("web service not found")
-	}
-	if len(web.Depends) != 2 {
-		t.Errorf("web.Depends = %v, want [users posts]", web.Depends)
-	}
-
-	// Check envs
-	if len(cfg.Envs) != 2 {
-		t.Errorf("expected 2 envs, got %d", len(cfg.Envs))
-	}
-
-	dev := cfg.GetEnv("development")
-	if dev == nil {
-		t.Fatal("development env not found")
-	}
-	if dev["STORE_ADDRESS"] != "file://./data" {
-		t.Errorf("STORE_ADDRESS = %q, want %q", dev["STORE_ADDRESS"], "file://./data")
-	}
-	if dev["DEBUG"] != "true" {
-		t.Errorf("DEBUG = %q, want %q", dev["DEBUG"], "true")
-	}
-}
-
-func TestParseJSON(t *testing.T) {
-	content := `{
-  "services": {
-    "users": {
-      "path": "./users",
-      "port": 8081
-    },
-    "posts": {
-      "path": "./posts",
-      "port": 8082,
-      "depends": ["users"]
-    }
-  },
-  "env": {
-    "development": {
-      "STORE_ADDRESS": "file://./data"
-    }
-  }
-}`
-
-	tmpDir := t.TempDir()
-	jsonPath := filepath.Join(tmpDir, "micro.json")
-	if err := os.WriteFile(jsonPath, []byte(content), 0644); err != nil {
-		t.Fatal(err)
-	}
-
-	cfg, err := ParseJSON(jsonPath)
-	if err != nil {
-		t.Fatalf("ParseJSON failed: %v", err)
-	}
-
-	if len(cfg.Services) != 2 {
-		t.Errorf("expected 2 services, got %d", len(cfg.Services))
-	}
-
-	users := cfg.Services["users"]
-	if users == nil {
-		t.Fatal("users service not found")
-	}
-	if users.Port != 8081 {
-		t.Errorf("users.Port = %d, want %d", users.Port, 8081)
-	}
-}
-
-func TestTopologicalSort(t *testing.T) {
-	cfg := &Config{
-		Services: map[string]*Service{
-			"web":   {Name: "web", Depends: []string{"users", "posts"}},
-			"posts": {Name: "posts", Depends: []string{"users"}},
-			"users": {Name: "users"},
-		},
-	}
-
-	sorted, err := cfg.TopologicalSort()
-	if err != nil {
-		t.Fatalf("TopologicalSort failed: %v", err)
-	}
-
-	if len(sorted) != 3 {
-		t.Fatalf("expected 3 services, got %d", len(sorted))
-	}
-
-	// users must come before posts and web
-	// posts must come before web
-	positions := make(map[string]int)
-	for i, svc := range sorted {
-		positions[svc.Name] = i
-	}
-
-	if positions["users"] > positions["posts"] {
-		t.Error("users should come before posts")
-	}
-	if positions["users"] > positions["web"] {
-		t.Error("users should come before web")
-	}
-	if positions["posts"] > positions["web"] {
-		t.Error("posts should come before web")
-	}
-}
-
-func TestCircularDependency(t *testing.T) {
-	cfg := &Config{
-		Services: map[string]*Service{
-			"a": {Name: "a", Depends: []string{"b"}},
-			"b": {Name: "b", Depends: []string{"a"}},
-		},
-	}
-
-	_, err := cfg.TopologicalSort()
-	if err == nil {
-		t.Error("expected circular dependency error")
-	}
-}
-
-func TestLoad(t *testing.T) {
-	// Test with no config file
-	tmpDir := t.TempDir()
-	cfg, err := Load(tmpDir)
-	if err != nil {
-		t.Fatalf("Load failed: %v", err)
-	}
-	if cfg != nil {
-		t.Error("expected nil config when no file exists")
-	}
-
-	// Test with micro.mu
-	muContent := `service test
-    path ./test
-    port 8080
-`
-	if err := os.WriteFile(filepath.Join(tmpDir, "micro.mu"), []byte(muContent), 0644); err != nil {
-		t.Fatal(err)
-	}
-
-	cfg, err = Load(tmpDir)
-	if err != nil {
-		t.Fatalf("Load failed: %v", err)
-	}
-	if cfg == nil {
-		t.Fatal("expected config to be loaded")
-	}
-	if cfg.Services["test"] == nil {
-		t.Error("test service not found")
-	}
-}
@@ -2,26 +2,20 @@ package run

 import (
 	"bufio"
-	"context"
 	"crypto/md5"
 	"fmt"
 	"io"
-	"net/http"
 	"os"
 	"os/exec"
 	"os/signal"
 	"path/filepath"
 	"strconv"
 	"strings"
-	"sync"
 	"syscall"
 	"time"

 	"github.com/urfave/cli/v2"
 	"go-micro.dev/v5/cmd"
-	"go-micro.dev/v5/cmd/micro/run/config"
-	"go-micro.dev/v5/cmd/micro/run/watcher"
-	"go-micro.dev/v5/cmd/micro/server"
 )

 // Color codes for log output
@@ -34,387 +28,175 @@ var colors = []string{
 	"\033[36m", // cyan
 }

-const colorReset = "\033[0m"
-
 func colorFor(idx int) string {
 	return colors[idx%len(colors)]
 }

-// serviceProcess tracks a running service
-type serviceProcess struct {
-	name       string
-	dir        string
-	binPath    string
-	pidFile    string
-	logFile    string
-	cmd        *exec.Cmd
-	pipeWriter *io.PipeWriter
-	color      string
-	port       int
-	env        []string
-
-	mu      sync.Mutex
-	running bool
-}
-
-func (s *serviceProcess) start(logDir string) error {
-	s.mu.Lock()
-	defer s.mu.Unlock()
-
-	if s.running {
-		return nil
-	}
-
-	// Build
-	buildCmd := exec.Command("go", "build", "-o", s.binPath, ".")
-	buildCmd.Dir = s.dir
-	buildOut, buildErr := buildCmd.CombinedOutput()
-	if buildErr != nil {
-		return fmt.Errorf("build failed: %s\n%s", buildErr, string(buildOut))
-	}
-
-	// Open log file
-	logFile, err := os.OpenFile(s.logFile, os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
-	if err != nil {
-		return fmt.Errorf("failed to open log file: %w", err)
-	}
-
-	// Start process
-	s.cmd = exec.Command(s.binPath)
-	s.cmd.Dir = s.dir
-	s.cmd.Env = append(os.Environ(), s.env...)
-
-	pr, pw := io.Pipe()
-	s.pipeWriter = pw
-	s.cmd.Stdout = pw
-	s.cmd.Stderr = pw
-
-	// Stream output
-	go func(name string, color string, pr *io.PipeReader, logFile *os.File) {
-		defer logFile.Close()
-		scanner := bufio.NewScanner(pr)
-		for scanner.Scan() {
-			line := scanner.Text()
-			fmt.Printf("%s[%s]%s %s\n", color, name, colorReset, line)
-			logFile.WriteString("[" + name + "] " + line + "\n")
-		}
-	}(s.name, s.color, pr, logFile)
-
-	if err := s.cmd.Start(); err != nil {
-		pw.Close()
-		return fmt.Errorf("failed to start: %w", err)
-	}
-
-	// Write PID file
-	os.WriteFile(s.pidFile, []byte(fmt.Sprintf("%d\n%s\n%s\n%s\n",
-		s.cmd.Process.Pid, s.dir, s.name, time.Now().Format(time.RFC3339))), 0644)
-
-	s.running = true
-	fmt.Printf("%s[%s]%s started (pid %d)\n", s.color, s.name, colorReset, s.cmd.Process.Pid)
-
-	return nil
-}
-
-func (s *serviceProcess) stop() {
-	s.mu.Lock()
-	defer s.mu.Unlock()
-
-	if !s.running || s.cmd == nil || s.cmd.Process == nil {
-		return
-	}
-
-	fmt.Printf("%s[%s]%s stopping...\n", s.color, s.name, colorReset)
-
-	// Graceful shutdown
-	s.cmd.Process.Signal(syscall.SIGTERM)
-
-	// Wait with timeout
-	done := make(chan error, 1)
-	go func() {
-		done <- s.cmd.Wait()
-	}()
-
-	select {
-	case <-done:
-	case <-time.After(5 * time.Second):
-		s.cmd.Process.Kill()
-		<-done
-	}
-
-	if s.pipeWriter != nil {
-		s.pipeWriter.Close()
-	}
-
-	os.Remove(s.pidFile)
-	s.running = false
-}
-
-func (s *serviceProcess) restart(logDir string) error {
-	s.stop()
-	return s.start(logDir)
-}
-
-// waitForHealth waits for a service's health endpoint to respond
-func waitForHealth(port int, timeout time.Duration) bool {
-	if port == 0 {
-		return true // No port configured, assume ready
-	}
-
-	deadline := time.Now().Add(timeout)
-	for time.Now().Before(deadline) {
-		resp, err := http.Get(fmt.Sprintf("http://localhost:%d/health", port))
-		if err == nil {
-			resp.Body.Close()
-			if resp.StatusCode == 200 {
-				return true
-			}
-		}
-		time.Sleep(100 * time.Millisecond)
-	}
-	return false
-}
-
 func Run(c *cli.Context) error {
 	dir := c.Args().Get(0)
-	if dir == "" {
+	var tmpDir string
+	if len(dir) == 0 {
 		dir = "."
-	}
-
-	// Handle git URLs
-	if strings.HasPrefix(dir, "github.com/") || strings.HasPrefix(dir, "https://github.com/") {
-		repo := strings.TrimPrefix(dir, "https://")
+	} else if strings.HasPrefix(dir, "github.com/") || strings.HasPrefix(dir, "https://github.com/") {
+		// Handle git URLs
+		repo := dir
+		if strings.HasPrefix(repo, "https://") {
+			repo = strings.TrimPrefix(repo, "https://")
+		}
+		// Clone to a temp directory
 		tmp, err := os.MkdirTemp("", "micro-run-")
 		if err != nil {
 			return fmt.Errorf("failed to create temp dir: %w", err)
 		}
-		defer os.RemoveAll(tmp)
-
-		cloneURL := "https://" + repo
-		cloneCmd := exec.Command("git", "clone", "--depth", "1", cloneURL, tmp)
-		cloneCmd.Stdout = os.Stdout
-		cloneCmd.Stderr = os.Stderr
-		if err := cloneCmd.Run(); err != nil {
-			return fmt.Errorf("failed to clone %s: %w", cloneURL, err)
+		tmpDir = tmp
+		cloneURL := repo
+		if !strings.HasPrefix(cloneURL, "https://") {
+			cloneURL = "https://" + repo
 		}
-		dir = tmp
+		// Run git clone
+		cmd := exec.Command("git", "clone", cloneURL, tmpDir)
+		cmd.Stdout = os.Stdout
+		cmd.Stderr = os.Stderr
+		if err := cmd.Run(); err != nil {
+			return fmt.Errorf("failed to clone repo %s: %w", cloneURL, err)
+		}
+		dir = tmpDir
 	}

-	absDir, err := filepath.Abs(dir)
-	if err != nil {
-		return fmt.Errorf("failed to get absolute path: %w", err)
-	}
-
-	// Setup directories
 	homeDir, err := os.UserHomeDir()
 	if err != nil {
 		return fmt.Errorf("failed to get home dir: %w", err)
 	}
 	logsDir := filepath.Join(homeDir, "micro", "logs")
+	if err := os.MkdirAll(logsDir, 0755); err != nil {
+		return fmt.Errorf("failed to create logs dir: %w", err)
+	}
 	runDir := filepath.Join(homeDir, "micro", "run")
+	if err := os.MkdirAll(runDir, 0755); err != nil {
+		return fmt.Errorf("failed to create run dir: %w", err)
+	}
 	binDir := filepath.Join(homeDir, "micro", "bin")
-
-	for _, d := range []string{logsDir, runDir, binDir} {
-		if err := os.MkdirAll(d, 0755); err != nil {
-			return fmt.Errorf("failed to create %s: %w", d, err)
-		}
+	if err := os.MkdirAll(binDir, 0755); err != nil {
+		return fmt.Errorf("failed to create bin dir: %w", err)
 	}

-	// Load configuration
-	cfg, err := config.Load(absDir)
-	if err != nil {
-		return fmt.Errorf("failed to load config: %w", err)
-	}
-
-	// Get environment
-	envName := c.String("env")
-	if envName == "" {
-		envName = os.Getenv("MICRO_ENV")
-	}
-	if envName == "" {
-		envName = "development"
-	}
-
-	var envVars []string
-	if cfg != nil {
-		if envMap := cfg.GetEnv(envName); envMap != nil {
-			for k, v := range envMap {
-				envVars = append(envVars, k+"="+v)
-			}
-		}
-	}
-
-	// Discover services
-	var services []*serviceProcess
-	servicesByDir := make(map[string]*serviceProcess)
-
-	if cfg != nil && len(cfg.Services) > 0 {
-		// Use configured services in dependency order
-		sorted, err := cfg.TopologicalSort()
+	// Always run all services (find all main.go)
+	var mainFiles []string
+	err = filepath.Walk(dir, func(path string, info os.FileInfo, err error) error {
 		if err != nil {
-			return fmt.Errorf("dependency error: %w", err)
+			return err
 		}
-
-		for i, svc := range sorted {
-			svcDir := filepath.Join(absDir, svc.Path)
-			absSvcDir, _ := filepath.Abs(svcDir)
-			hash := fmt.Sprintf("%x", md5.Sum([]byte(absSvcDir)))[:8]
-
-			sp := &serviceProcess{
-				name:    svc.Name,
-				dir:     absSvcDir,
-				binPath: filepath.Join(binDir, svc.Name+"-"+hash),
-				pidFile: filepath.Join(runDir, svc.Name+"-"+hash+".pid"),
-				logFile: filepath.Join(logsDir, svc.Name+"-"+hash+".log"),
-				color:   colorFor(i),
-				port:    svc.Port,
-				env:     envVars,
-			}
-			services = append(services, sp)
-			servicesByDir[absSvcDir] = sp
-		}
-	} else {
-		// Auto-discover from main.go files
-		var mainFiles []string
-		filepath.Walk(absDir, func(path string, info os.FileInfo, err error) error {
-			if err != nil || info.IsDir() {
-				return nil
-			}
-			if info.Name() == "main.go" {
-				mainFiles = append(mainFiles, path)
-			}
+		if info.IsDir() {
 			return nil
-		})
-
-		if len(mainFiles) == 0 {
-			return fmt.Errorf("no main.go files found in %s", absDir)
 		}
-
-		for i, mainFile := range mainFiles {
-			svcDir := filepath.Dir(mainFile)
-			absSvcDir, _ := filepath.Abs(svcDir)
-
-			var name string
-			if absSvcDir == absDir {
-				name = filepath.Base(absDir)
-			} else {
-				name = filepath.Base(svcDir)
-			}
-
-			hash := fmt.Sprintf("%x", md5.Sum([]byte(absSvcDir)))[:8]
-
-			sp := &serviceProcess{
-				name:    name,
-				dir:     absSvcDir,
-				binPath: filepath.Join(binDir, name+"-"+hash),
-				pidFile: filepath.Join(runDir, name+"-"+hash+".pid"),
-				logFile: filepath.Join(logsDir, name+"-"+hash+".log"),
-				color:   colorFor(i),
-				env:     envVars,
-			}
-			services = append(services, sp)
-			servicesByDir[absSvcDir] = sp
+		if info.Name() == "main.go" {
+			mainFiles = append(mainFiles, path)
 		}
+		return nil
+	})
+	if err != nil {
+		return fmt.Errorf("error walking the path: %w", err)
 	}
-
-	if len(services) == 0 {
-		return fmt.Errorf("no services found")
+	if len(mainFiles) == 0 {
+		return fmt.Errorf("no main.go files found in %s", dir)
 	}
-
-	// Start gateway unless disabled
-	var gw *server.Gateway
-	gatewayAddr := c.String("address")
-	if gatewayAddr == "" {
-		gatewayAddr = ":8080"
-	}
-
-	if !c.Bool("no-gateway") {
-		var err error
-		mcpAddr := c.String("mcp-address")
-		gw, err = server.StartGateway(server.GatewayOptions{
-			Address:     gatewayAddr,
-			AuthEnabled: true, // Auth enabled with default admin/micro user
-			Context:     context.Background(),
-			MCPEnabled:  mcpAddr != "",
-			MCPAddress:  mcpAddr,
-		})
-		if err != nil {
-			return fmt.Errorf("failed to start gateway: %w", err)
+	var procs []*exec.Cmd
+	var pidFiles []string
+	for i, mainFile := range mainFiles {
+		serviceDir := filepath.Dir(mainFile)
+		var serviceName string
+		absServiceDir, _ := filepath.Abs(serviceDir)
+		// Determine service name: if absServiceDir matches the provided dir (which may be "."), use cwd
+		if absServiceDir == dir {
+			cwd, _ := os.Getwd()
+			serviceName = filepath.Base(cwd)
+		} else {
+			serviceName = filepath.Base(serviceDir)
 		}
-	}
+		serviceNameForPid := serviceName + "-" + fmt.Sprintf("%x", md5.Sum([]byte(absServiceDir)))[:8]
+		logFilePath := filepath.Join(logsDir, serviceNameForPid+".log")
+		binPath := filepath.Join(binDir, serviceNameForPid)
+		pidFilePath := filepath.Join(runDir, serviceNameForPid+".pid")

-	// Start services
-	for _, svc := range services {
-		if err := svc.start(logsDir); err != nil {
-			fmt.Fprintf(os.Stderr, "[%s] %v\n", svc.name, err)
-			continue
-		}
-
-		// Wait for health if port configured
-		if svc.port > 0 {
-			if !waitForHealth(svc.port, 10*time.Second) {
-				fmt.Fprintf(os.Stderr, "[%s] health check timeout\n", svc.name)
-			}
-		}
-	}
-
-	// Print startup banner
-	printBanner(services, gw, !c.Bool("no-watch"))
-
-	// Setup signal handling
-	sigCh := make(chan os.Signal, 1)
-	signal.Notify(sigCh, os.Interrupt, syscall.SIGTERM)
-
-	// Watch mode
-	watchEnabled := !c.Bool("no-watch")
-	var watch *watcher.Watcher
-
-	if watchEnabled {
-		var dirs []string
-		for _, svc := range services {
-			dirs = append(dirs, svc.dir)
-		}
-
-		watch = watcher.New(dirs)
-		watch.Start()
-
-		go func() {
-			for event := range watch.Events() {
-				if svc, ok := servicesByDir[event.Dir]; ok {
-					fmt.Printf("%s[%s]%s rebuilding...\n", svc.color, svc.name, colorReset)
-					if err := svc.restart(logsDir); err != nil {
-						fmt.Fprintf(os.Stderr, "%s[%s]%s restart failed: %v\n", svc.color, svc.name, colorReset, err)
+		// Check if pid file exists and process is running
+		if pidBytes, err := os.ReadFile(pidFilePath); err == nil {
+			lines := strings.Split(string(pidBytes), "\n")
+			if len(lines) > 0 && len(lines[0]) > 0 {
+				pid := lines[0]
+				if _, err := os.FindProcess(parsePid(pid)); err == nil {
+					if processRunning(pid) {
+						fmt.Fprintf(os.Stderr, "Service %s already running (pid %s)\n", serviceNameForPid, pid)
+						continue
 					}
 				}
 			}
-		}()
+		}
+
+		logFile, err := os.OpenFile(logFilePath, os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
+		if err != nil {
+			fmt.Fprintf(os.Stderr, "failed to open log file for %s: %v\n", serviceName, err)
+			continue
+		}
+		buildCmd := exec.Command("go", "build", "-o", binPath, ".")
+		buildCmd.Dir = serviceDir
+		buildOut, buildErr := buildCmd.CombinedOutput()
+		if buildErr != nil {
+			logFile.WriteString(string(buildOut))
+			logFile.Close()
+			fmt.Fprintf(os.Stderr, "failed to build %s: %v\n", serviceName, buildErr)
+			continue
+		}
+		cmd := exec.Command(binPath)
+		cmd.Dir = serviceDir
+		pr, pw := io.Pipe()
+		cmd.Stdout = pw
+		cmd.Stderr = pw
+		color := colorFor(i)
+		go func(name string, color string, pr *io.PipeReader, logFile *os.File) {
+			defer logFile.Close()
+			scanner := bufio.NewScanner(pr)
+			for scanner.Scan() {
+				line := scanner.Text()
+				// Write to terminal with color and service name
+				fmt.Printf("%s[%s]\033[0m %s\n", color, name, line)
+				// Write to log file with service name prefix
+				logFile.WriteString("[" + name + "] " + line + "\n")
+			}
+		}(serviceName, color, pr, logFile)
+		if err := cmd.Start(); err != nil {
+			fmt.Fprintf(os.Stderr, "failed to start service %s: %v\n", serviceName, err)
+			pw.Close()
+			continue
+		}
+		procs = append(procs, cmd)
+		pidFiles = append(pidFiles, pidFilePath)
+		os.WriteFile(pidFilePath, []byte(fmt.Sprintf("%d\n%s\n%s\n%s\n", cmd.Process.Pid, absServiceDir, serviceName, time.Now().Format(time.RFC3339))), 0644)
 	}
-
-	// Wait for signal
-	<-sigCh
-	fmt.Println("\nShutting down...")
-
-	if watch != nil {
-		watch.Stop()
+	ch := make(chan os.Signal, 1)
+	signal.Notify(ch, os.Interrupt)
+	go func() {
+		<-ch
+		for _, proc := range procs {
+			if proc.Process != nil {
+				_ = proc.Process.Kill()
+			}
+		}
+		for _, pf := range pidFiles {
+			_ = os.Remove(pf)
+		}
+		os.Exit(1)
+	}()
+	for _, proc := range procs {
+		_ = proc.Wait()
 	}
-
-	if gw != nil {
-		gw.Stop()
-	}
-
-	// Stop services in reverse order
-	for i := len(services) - 1; i >= 0; i-- {
-		services[i].stop()
-	}
-
 	return nil
 }

-// Helper functions
+// Add helpers for process check
 func parsePid(pidStr string) int {
 	pid, _ := strconv.Atoi(pidStr)
 	return pid
 }
-
 func processRunning(pidStr string) bool {
 	pid := parsePid(pidStr)
 	if pid <= 0 {
@@ -424,109 +206,22 @@ func processRunning(pidStr string) bool {
 	if err != nil {
 		return false
 	}
+	// On Unix, sending signal 0 checks if process exists
 	return proc.Signal(syscall.Signal(0)) == nil
 }

-func printBanner(services []*serviceProcess, gw *server.Gateway, watching bool) {
-	fmt.Println()
-	fmt.Println("  ┌─────────────────────────────────────────────────────────────┐")
-	fmt.Println("  │                                                             │")
-	fmt.Println("  │   \033[1mMicro\033[0m                                                    │")
-	fmt.Println("  │                                                             │")
-
-	if gw != nil {
-		fmt.Printf("  │   Web:     \033[36mhttp://localhost%s\033[0m                       │\n", gw.Addr())
-		fmt.Printf("  │   API:     \033[36mhttp://localhost%s/api/{service}/{method}\033[0m  │\n", gw.Addr())
-		fmt.Printf("  │   Health:  \033[36mhttp://localhost%s/health\033[0m                 │\n", gw.Addr())
-	}
-
-	fmt.Println("  │                                                             │")
-	fmt.Println("  │   Services:                                                 │")
-
-	for _, svc := range services {
-		status := "\033[32m●\033[0m" // green dot
-		if !svc.running {
-			status = "\033[31m●\033[0m" // red dot
-		}
-		name := svc.name
-		if len(name) > 20 {
-			name = name[:17] + "..."
-		}
-		fmt.Printf("  │     %s %-20s                                │\n", status, name)
-	}
-
-	fmt.Println("  │                                                             │")
-
-	if watching {
-		fmt.Println("  │   \033[33mWatching for changes...\033[0m                                │")
-		fmt.Println("  │                                                             │")
-	}
-
-	fmt.Println("  │   Auth:    \033[32menabled\033[0m (admin / micro)                        │")
-	fmt.Println("  │                                                             │")
-
-	if gw != nil && len(services) > 0 {
-		svc := services[0]
-		fmt.Println("  │   Try:                                                     │")
-		fmt.Printf("  │   \033[90mcurl -X POST http://localhost%s/api/%s/...\033[0m   │\n", gw.Addr(), svc.name)
-		fmt.Println("  │                                                             │")
-	}
-
-	fmt.Println("  └─────────────────────────────────────────────────────────────┘")
-	fmt.Println()
-}
-
 func init() {
 	cmd.Register(&cli.Command{
-		Name:  "run",
-		Usage: "Run services with API gateway and hot reload",
-		Description: `Run discovers and runs services in a directory.
-
-Starts an HTTP gateway on :8080 providing:
-  - Web dashboard at /
-  - Agent playground at /agent (AI chat with MCP tools)
-  - API explorer at /api
-  - API proxy at /api/{service}/{endpoint}
-  - MCP tools at /api/mcp/tools
-  - Health checks at /health
-
-With a micro.mu or micro.json config file, services start in dependency order.
-Without config, all main.go files are discovered and run.
-
-Examples:
-  micro run                    # Run with gateway on :8080
-  micro run --address :3000    # Gateway on custom port
-  micro run --no-gateway       # Services only, no HTTP gateway
-  micro run --no-watch         # Disable hot reload
-  micro run --env production   # Use production environment
-  micro run --mcp-address :3000  # Enable MCP protocol gateway`,
+		Name:   "run",
+		Usage:  "Run all services in a directory",
 		Action: Run,
 		Flags: []cli.Flag{
 			&cli.StringFlag{
 				Name:    "address",
 				Aliases: []string{"a"},
-				Usage:   "Gateway address (default :8080)",
+				Usage:   "Address to bind the micro web UI (default :8080)",
 				Value:   ":8080",
 			},
-			&cli.BoolFlag{
-				Name:  "no-gateway",
-				Usage: "Disable HTTP gateway",
-			},
-			&cli.BoolFlag{
-				Name:  "no-watch",
-				Usage: "Disable hot reload (file watching)",
-			},
-			&cli.StringFlag{
-				Name:    "env",
-				Aliases: []string{"e"},
-				Usage:   "Environment to use (default: development)",
-				EnvVars: []string{"MICRO_ENV"},
-			},
-			&cli.StringFlag{
-				Name:    "mcp-address",
-				Usage:   "MCP gateway address (e.g., :3000). Enables MCP protocol for AI tools.",
-				EnvVars: []string{"MICRO_MCP_ADDRESS"},
-			},
 		},
 	})
 }
@@ -1,168 +0,0 @@
-// Package watcher provides file watching for hot reload
-package watcher
-
-import (
-	"os"
-	"path/filepath"
-	"strings"
-	"sync"
-	"time"
-)
-
-// Event represents a file change event
-type Event struct {
-	Path string
-	Dir  string // The service directory that was affected
-}
-
-// Watcher watches directories for file changes
-type Watcher struct {
-	dirs     []string
-	events   chan Event
-	done     chan struct{}
-	interval time.Duration
-	debounce time.Duration
-
-	mu       sync.Mutex
-	modTimes map[string]time.Time
-}
-
-// Option configures the watcher
-type Option func(*Watcher)
-
-// WithInterval sets the polling interval
-func WithInterval(d time.Duration) Option {
-	return func(w *Watcher) {
-		w.interval = d
-	}
-}
-
-// WithDebounce sets the debounce duration for rapid changes
-func WithDebounce(d time.Duration) Option {
-	return func(w *Watcher) {
-		w.debounce = d
-	}
-}
-
-// New creates a new file watcher for the given directories
-func New(dirs []string, opts ...Option) *Watcher {
-	w := &Watcher{
-		dirs:     dirs,
-		events:   make(chan Event, 100),
-		done:     make(chan struct{}),
-		interval: 500 * time.Millisecond,
-		debounce: 300 * time.Millisecond,
-		modTimes: make(map[string]time.Time),
-	}
-
-	for _, opt := range opts {
-		opt(w)
-	}
-
-	return w
-}
-
-// Events returns the channel of file change events
-func (w *Watcher) Events() <-chan Event {
-	return w.events
-}
-
-// Start begins watching for file changes
-func (w *Watcher) Start() {
-	// Initial scan to populate mod times
-	w.scan(false)
-
-	go w.watch()
-}
-
-// Stop stops the watcher
-func (w *Watcher) Stop() {
-	close(w.done)
-}
-
-func (w *Watcher) watch() {
-	ticker := time.NewTicker(w.interval)
-	defer ticker.Stop()
-
-	// Track pending events per directory for debouncing
-	pending := make(map[string]time.Time)
-	var pendingMu sync.Mutex
-
-	for {
-		select {
-		case <-w.done:
-			return
-		case <-ticker.C:
-			changed := w.scan(true)
-			now := time.Now()
-
-			pendingMu.Lock()
-			for _, dir := range changed {
-				pending[dir] = now
-			}
-
-			// Emit events for directories that have been stable
-			for dir, t := range pending {
-				if now.Sub(t) >= w.debounce {
-					select {
-					case w.events <- Event{Dir: dir}:
-					default:
-						// Channel full, skip
-					}
-					delete(pending, dir)
-				}
-			}
-			pendingMu.Unlock()
-		}
-	}
-}
-
-func (w *Watcher) scan(notify bool) []string {
-	w.mu.Lock()
-	defer w.mu.Unlock()
-
-	var changed []string
-	changedDirs := make(map[string]bool)
-
-	for _, dir := range w.dirs {
-		absDir, err := filepath.Abs(dir)
-		if err != nil {
-			continue
-		}
-
-		filepath.Walk(dir, func(path string, info os.FileInfo, err error) error {
-			if err != nil {
-				return nil
-			}
-
-			// Skip hidden directories and vendor
-			if info.IsDir() {
-				name := info.Name()
-				if strings.HasPrefix(name, ".") || name == "vendor" || name == "node_modules" {
-					return filepath.SkipDir
-				}
-				return nil
-			}
-
-			// Only watch .go files
-			if !strings.HasSuffix(path, ".go") {
-				return nil
-			}
-
-			modTime := info.ModTime()
-			if oldTime, exists := w.modTimes[path]; exists {
-				if modTime.After(oldTime) && notify {
-					if !changedDirs[absDir] {
-						changedDirs[absDir] = true
-						changed = append(changed, absDir)
-					}
-				}
-			}
-			w.modTimes[path] = modTime
-
-			return nil
-		})
-	}
-
-	return changed
-}
@@ -1,72 +0,0 @@
-package server
-
-import (
-	"fmt"
-	"net/http"
-	"os"
-	"path/filepath"
-
-	"go-micro.dev/v5/gateway/api"
-	"go-micro.dev/v5/registry"
-	"go-micro.dev/v5/store"
-)
-
-// GatewayOptions configures the HTTP gateway (legacy compatibility)
-// Deprecated: Use gateway/api.Options directly
-type GatewayOptions = api.Options
-
-// Gateway represents a running HTTP gateway server (legacy compatibility)
-// Deprecated: Use gateway/api.Gateway directly
-type Gateway = api.Gateway
-
-// StartGateway starts the HTTP gateway with the given options.
-// This is a compatibility wrapper around gateway/api.New().
-//
-// Deprecated: Use gateway/api.New() directly for new code.
-func StartGateway(opts GatewayOptions) (*Gateway, error) {
-	// Initialize auth if enabled (server-specific setup)
-	if opts.AuthEnabled {
-		if err := initAuth(); err != nil {
-			return nil, fmt.Errorf("failed to initialize auth: %w", err)
-		}
-
-		homeDir, _ := os.UserHomeDir()
-		keyDir := filepath.Join(homeDir, "micro", "keys")
-		privPath := filepath.Join(keyDir, "private.pem")
-		pubPath := filepath.Join(keyDir, "public.pem")
-		if err := InitJWTKeys(privPath, pubPath); err != nil {
-			return nil, fmt.Errorf("failed to init JWT keys: %w", err)
-		}
-	}
-
-	// Get store (server-specific default)
-	s := store.DefaultStore
-
-	// Parse templates (server-specific)
-	tmpls := parseTemplates()
-
-	// Create handler registrar that registers server-specific handlers
-	opts.HandlerRegistrar = func(mux *http.ServeMux) error {
-		registerHandlers(mux, tmpls, s, opts.AuthEnabled)
-		return nil
-	}
-
-	// Use default registry if not set
-	if opts.Registry == nil {
-		opts.Registry = registry.DefaultRegistry
-	}
-
-	// Delegate to gateway/api package
-	return api.New(opts)
-}
-
-// RunGateway starts the gateway and blocks until it stops.
-//
-// Deprecated: Use gateway/api.Run() with a custom handler registrar.
-func RunGateway(opts GatewayOptions) error {
-	gw, err := StartGateway(opts)
-	if err != nil {
-		return err
-	}
-	return gw.Wait()
-}
@@ -153,13 +153,6 @@ table tr:nth-child(even) {
  margin: 0;
  padding: 0;
 }
-.no-bullets li {
-  padding: 0.45em 0;
-  border-bottom: 1px solid #e0e0e0;
-}
-.no-bullets li:last-child {
-  border-bottom: none;
-}

 .copy-btn {
  background: #fff;
@@ -1,30 +1,32 @@
 {{define "content"}}
 <h2 class="text-2xl font-bold mb-4">API</h2>
-<p style="background:#f8f8e8; border:1px solid #e0e0b0; padding:1em; margin-bottom:2em; font-size:1.05em; border-radius:6px;">
-  <b>Authentication Required:</b> Include an <b>Authorization: Bearer &lt;token&gt;</b> header with all <code>/api/...</code> requests.
-  Generate tokens on the <a href="/auth/tokens">Tokens page</a>.
+<p class="api-auth-info" style="background:#f8f8e8; border:1px solid #e0e0b0; padding:1em; margin-bottom:2em; font-size:1.08em; border-radius:6px;">
+  <b>API Authentication Required:</b> All API calls to <code>/api/...</code> endpoints (except this page) must include an <b>Authorization: Bearer &lt;token&gt;</b> header.<br>
+  You can generate tokens on the <a href="/auth/tokens">Tokens page</a>.
 </p>
 {{range .Services}}
-  <h3 id="{{.Anchor}}" style="margin-top:2.5em; margin-bottom:0.8em; font-size:1.15em; font-weight:bold; border-bottom:2px solid #ddd; padding-bottom:0.4em;">{{.Name}}</h3>
+  <h3 id="{{.Anchor}}" style="margin-top:3em; font-size:1.2em; font-weight:bold;">{{.Name}}</h3>
  {{if .Endpoints}}
+    <div style="margin-bottom:3em;">
    {{range .Endpoints}}
-      <div style="margin-bottom:1.8em; padding:1.2em 1.4em; background:#fafbfc; border-radius:7px; border:1px solid #e5e5e5;">
-        <div style="display:flex; align-items:baseline; gap:1em; margin-bottom:0.6em;">
-          <span style="font-size:1.08em; font-weight:600;"><a href="{{.Path}}" class="micro-link">{{.Name}}</a></span>
-          <code style="font-size:0.92em; color:#666;">{{.Path}}</code>
+      <div style="margin-bottom:2.8em; padding:1.3em 1.5em; background:#fafbfc; border-radius:7px; border:1px solid #eee;">
+        <div style="font-size:1.12em; margin-bottom:0.7em;"><a href="{{.Path}}" class="micro-link" style="font-weight:bold;">{{.Name}}</a></div>
+        <div style="margin-bottom:0.8em; color:#888; font-size:1em;">
+          <b>HTTP Path:</b> <code>{{.Path}}</code>
        </div>
-        <div style="display:flex; gap:2.5em; flex-wrap:wrap;">
-          <div style="flex:1; min-width:220px;">
-            <div style="font-weight:600; font-size:0.92em; color:#555; text-transform:uppercase; letter-spacing:0.05em; margin-bottom:0.3em;">Request</div>
-            {{.Params}}
+        <div style="display:flex; gap:3em; flex-wrap:wrap;">
+          <div style="min-width:240px;">
+            <b>Request:</b>
+            <pre style="background:#f4f4f4; border-radius:5px; padding:1em 1.2em; margin:0.5em 0 1em 0; font-size:1em;">{{.Params}}</pre>
          </div>
-          <div style="flex:1; min-width:220px;">
-            <div style="font-weight:600; font-size:0.92em; color:#555; text-transform:uppercase; letter-spacing:0.05em; margin-bottom:0.3em;">Response</div>
-            {{.Response}}
+          <div style="min-width:240px;">
+            <b>Response:</b>
+            <pre style="background:#f4f4f4; border-radius:5px; padding:1em 1.2em; margin:0.5em 0 1em 0; font-size:1em;">{{.Response}}</pre>
          </div>
        </div>
      </div>
    {{end}}
+    </div>
  {{else}}
    <p style="color:#888;">No endpoints</p>
  {{end}}
@@ -1,5 +1,5 @@
 {{define "content"}}
-<h2 class="text-2xl font-bold mb-4">Tokens</h2>
+<h2 class="text-2xl font-bold mb-4">Auth Tokens</h2>
 <table style="margin-bottom:2em;">
  <thead>
    <tr><th>ID</th><th>Type</th><th>Scopes</th><th>Metadata</th><th>Token</th><th>Delete</th></tr>
@@ -39,7 +39,7 @@
    {{end}}
  </tbody>
 </table>
-<h3 style="margin-bottom:1em;">Create Token</h3>
+<h3 style="margin-bottom:1em;">Create New Token</h3>
 <form method="POST" action="/auth/tokens">
  <input name="id" placeholder="Name/ID" required style="margin-right:1em;">
  <select name="type" style="margin-right:1em;">
@@ -47,33 +47,9 @@
    <option value="admin">Admin</option>
    <option value="service">Service</option>
  </select>
-  <input name="scopes" placeholder="Scopes (comma separated)" style="margin-right:1em; width:260px;">
+  <input name="scopes" placeholder="Scopes (comma separated)" style="margin-right:1em;">
  <button type="submit">Create</button>
 </form>
-
-<div style="background:#f9f9f9; border:1px solid #eee; padding:1.2em 1.5em; border-radius:6px; font-size:0.97em; line-height:1.6; margin-top:2em;">
-  <h4 style="margin-top:0;">Token Scopes</h4>
-  <p>Scopes define what a token is allowed to access. They work with the <a href="/auth/scopes">Scopes</a> page where you set what each endpoint requires.</p>
-
-  <table style="font-size:0.95em; margin:1em 0;">
-    <thead><tr><th>Scopes</th><th>What it means</th></tr></thead>
-    <tbody>
-      <tr><td><code>*</code></td><td>Full access — bypasses all scope checks (default for admin)</td></tr>
-      <tr><td><code>greeter</code></td><td>Can call any endpoint that requires the <code>greeter</code> scope</td></tr>
-      <tr><td><code>greeter, users</code></td><td>Can call endpoints requiring <code>greeter</code> or <code>users</code></td></tr>
-      <tr><td><code>admin</code></td><td>Can call endpoints requiring the <code>admin</code> scope</td></tr>
-    </tbody>
-  </table>
-
-  <p style="margin-bottom:0;">Scopes are just strings — you define them. Set the same string on a token and on an endpoint, and they match. See <a href="/auth/scopes">Scopes</a> for examples.</p>
-</div>
-
-<h4 style="margin-top:2em;">Using a Token</h4>
-<pre style="background:#fff; border:1px solid #ddd; padding:1em; border-radius:4px; overflow-x:auto; font-size:0.93em;">
-curl http://localhost:8080/api/greeter/Greeter/Hello \
-  -H "Authorization: Bearer &lt;token&gt;" \
-  -d '{"name": "World"}'</pre>
-
 <script>
 function copyToken(btn) {
  const token = btn.getAttribute('data-token');
@@ -3,14 +3,14 @@
 <head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width">
-    <title>Micro | {{.Title}}</title>
+    <title>{{.Title}}</title>
    <link rel="stylesheet" href="/styles.css">
 </head>
 <body>
    <div id="layout" style="display:flex; min-height:100vh;">
        {{if not .HideSidebar}}
-        <nav id="sidebar" style="width:230px; background:#f5f5f5; padding:2em 1.5em 2em 2em; border:1px solid #eee;">
-            <h1 style="margin-bottom:1.2em;"><a href="/" id="title">Micro</a></h1>
+        <nav id="sidebar" style="width:220px; background:#f5f5f5; padding:2em 1.5em 2em 2em; border:1px solid #eee;">
+            <h1 style="margin-bottom:1em;"><a href="/" id="title">Micro</a></h1>
            {{if .User}}
              <div style="margin-bottom:1.5em; font-size:1.05em;">
                <span style="color:#888;">Logged in as</span>
@@ -19,25 +19,19 @@
                  <button type="submit" style="padding:0.25em 0.8em; font-size:0.97em; border-radius:4px; margin:0; cursor:pointer;">Logout</button>
                </form>
              </div>
-            {{else if .AuthEnabled}}
+            {{else}}
              <div style="margin-bottom:1.5em;">
                <a href="/auth/login" class="micro-link">Login</a>
              </div>
            {{end}}
-            <ul class="no-bullets" style="padding-left:0; line-height:2.2;">
-                <li><a href="/" class="micro-link">&#127968; Home</a></li>
-                <li><a href="/agent" class="micro-link">&#129302; Agent</a></li>
-                <li><a href="/api" class="micro-link">&#128268; API</a></li>
-                <li><a href="/logs" class="micro-link">&#128220; Logs</a></li>
-                {{if .AuthEnabled}}
-                <li><a href="/auth/scopes" class="micro-link">&#128274; Scopes</a></li>
-                {{end}}
-                <li><a href="/services" class="micro-link">&#9881; Services</a></li>
-                <li><a href="/status" class="micro-link">&#128308; Status</a></li>
-                {{if .AuthEnabled}}
-                <li><a href="/auth/tokens" class="micro-link">&#128273; Tokens</a></li>
-                <li><a href="/auth/users" class="micro-link">&#128100; Users</a></li>
-                {{end}}
+            <ul class="no-bullets" style="padding-left:0;">
+                <li><a href="/" class="micro-link">Home</a></li>
+                <li><a href="/services" class="micro-link">Services</a></li>
+                <li><a href="/logs" class="micro-link">Logs</a></li>
+                <li><a href="/status" class="micro-link">Status</a></li>
+                <li><a href="/api" class="micro-link">API</a></li>
+                <li><a href="/auth/tokens" class="micro-link">Tokens</a></li>
+                <li><a href="/auth/users" class="micro-link">Users</a></li>
            </ul>
            {{if and .SidebarEndpoints .SidebarEndpointsEnabled}}
            <hr style="margin:2em 0 1em 0;">
@@ -1,5 +1,5 @@
 {{define "content"}}
-<h2 class="text-2xl font-bold mb-4">Home</h2>
+<h2 class="text-2xl font-bold mb-4">Dashboard</h2>
 <div style="display:flex; align-items:center; gap:2em; margin-bottom:2em;">
  <div style="display:flex; align-items:center; gap:0.5em;">
    <span style="font-size:2.2em; vertical-align:middle;">
@@ -17,25 +17,5 @@
  <div style="font-size:1.1em; color:#2ecc40;">Running: <b>{{.RunningCount}}</b></div>
  <div style="font-size:1.1em; color:#ff4136;">Stopped: <b>{{.StoppedCount}}</b></div>
 </div>
-
-{{if .Services}}
-<h3 style="margin-top:1.5em; margin-bottom:0.8em;">Services</h3>
-<table>
-  <thead>
-    <tr><th>Name</th><th></th></tr>
-  </thead>
-  <tbody>
-    {{range .Services}}
-    <tr>
-      <td><a href="/{{.}}" class="micro-link" style="font-weight:500;">{{.}}</a></td>
-      <td style="text-align:right;">
-        <a href="/api#{{.}}" class="micro-link" style="font-size:0.92em; color:#888;">API</a>
-      </td>
-    </tr>
-    {{end}}
-  </tbody>
-</table>
-{{else}}
-<p style="color:#888; margin-top:1.5em;">No services registered yet. Start a service and it will appear here.</p>
-{{end}}
+<p>Welcome to the Micro dashboard. Use the sidebar to navigate services, logs, status, and API.</p>
 {{end}}
@@ -1,184 +0,0 @@
-{{define "content"}}
-<h2>Agent</h2>
-<p>Chat with your microservices using AI. Configure a model API key in settings, then use the prompt to interact with your services.</p>
-
-<h3>Prompt</h3>
-<div id="agent-messages"></div>
-<form onsubmit="return false;" style="display:flex; gap:0.5em; align-items:flex-end;">
-  <input type="text" id="prompt-input" placeholder="e.g. List all users, Create a blog post..." style="flex:1; margin-bottom:0;">
-  <button id="prompt-btn" onclick="sendPrompt()">Send</button>
-</form>
-
-<h3>Settings</h3>
-<form id="settings-form" onsubmit="return false;">
-  <label style="display:block; font-weight:600;">Provider</label>
-  <select id="provider">
-    <option value="openai">OpenAI</option>
-    <option value="anthropic">Anthropic</option>
-  </select>
-  <label style="display:block; font-weight:600;">Model API Key</label>
-  <input type="password" id="api-key" placeholder="sk-... or API key for your model provider">
-  <label style="display:block; font-weight:600;">Model (optional)</label>
-  <input type="text" id="model-name" placeholder="e.g. gpt-4o or claude-sonnet-4-20250514">
-  <label style="display:block; font-weight:600;">Base URL (optional)</label>
-  <input type="text" id="base-url" placeholder="Leave blank for default">
-  <button onclick="saveSettings()">Save Settings</button>
-  <span id="settings-status" style="margin-left:0.5em; color:#888;"></span>
-</form>
-
-<h3>Available Tools</h3>
-<div id="tools-list">
-  <p style="color:#888;">Loading tools...</p>
-</div>
-
-<script>
-(function() {
-  var tools = [];
-
-  loadSettings();
-  loadTools();
-
-  function loadSettings() {
-    fetch('/api/agent/settings')
-      .then(function(r) { return r.json(); })
-      .then(function(data) {
-        if (data.provider) document.getElementById('provider').value = data.provider;
-        if (data.api_key) document.getElementById('api-key').value = data.api_key;
-        if (data.model) document.getElementById('model-name').value = data.model;
-        if (data.base_url) document.getElementById('base-url').value = data.base_url;
-      })
-      .catch(function() {});
-  }
-
-  window.saveSettings = function() {
-    var status = document.getElementById('settings-status');
-    status.textContent = 'Saving...';
-    fetch('/api/agent/settings', {
-      method: 'POST',
-      headers: {'Content-Type': 'application/json'},
-      body: JSON.stringify({
-        provider: document.getElementById('provider').value,
-        api_key: document.getElementById('api-key').value,
-        model: document.getElementById('model-name').value,
-        base_url: document.getElementById('base-url').value
-      })
-    })
-    .then(function(r) { return r.json(); })
-    .then(function() { status.textContent = 'Saved'; })
-    .catch(function(err) { status.textContent = 'Error: ' + err; });
-  };
-
-  function loadTools() {
-    fetch('/api/mcp/tools')
-      .then(function(r) { return r.json(); })
-      .then(function(data) {
-        tools = data.tools || [];
-        renderTools();
-      })
-      .catch(function(err) {
-        document.getElementById('tools-list').innerHTML = '<p style="color:#c00;">Failed to load tools: ' + err + '</p>';
-      });
-  }
-
-  function renderTools() {
-    var el = document.getElementById('tools-list');
-    if (tools.length === 0) {
-      el.innerHTML = '<p style="color:#888;">No tools available. Start some services and they will appear here.</p>';
-      return;
-    }
-    var html = '<table><thead><tr><th>Tool</th><th>Description</th></tr></thead><tbody>';
-    for (var i = 0; i < tools.length; i++) {
-      var t = tools[i];
-      html += '<tr><td><code>' + escapeHtml(t.name) + '</code></td>';
-      html += '<td>' + escapeHtml(t.description || '') + '</td></tr>';
-    }
-    html += '</tbody></table>';
-    el.innerHTML = html;
-  }
-
-  window.sendPrompt = function() {
-    var input = document.getElementById('prompt-input');
-    var text = input.value.trim();
-    if (!text) return;
-    input.value = '';
-
-    addMessage('user', escapeHtml(text));
-
-    var btn = document.getElementById('prompt-btn');
-    btn.disabled = true;
-    btn.textContent = '...';
-
-    fetch('/api/agent/prompt', {
-      method: 'POST',
-      headers: {'Content-Type': 'application/json'},
-      body: JSON.stringify({prompt: text})
-    })
-    .then(function(r) { return r.json(); })
-    .then(function(data) {
-      btn.disabled = false;
-      btn.textContent = 'Send';
-      if (data.error) {
-        addMessage('error', escapeHtml(data.error));
-        return;
-      }
-      if (data.reply) {
-        addMessage('assistant', escapeHtml(data.reply));
-      }
-      if (data.tool_calls && data.tool_calls.length > 0) {
-        for (var i = 0; i < data.tool_calls.length; i++) {
-          var tc = data.tool_calls[i];
-          addMessage('tool', '<b>Tool:</b> <code>' + escapeHtml(tc.tool) + '</code>' +
-            '<pre>' + escapeHtml(JSON.stringify(tc.input, null, 2)) + '</pre>' +
-            '<b>Result:</b><pre>' + escapeHtml(JSON.stringify(tc.result, null, 2)) + '</pre>');
-        }
-      }
-      if (data.answer) {
-        addMessage('assistant', escapeHtml(data.answer));
-      }
-    })
-    .catch(function(err) {
-      btn.disabled = false;
-      btn.textContent = 'Send';
-      addMessage('error', 'Error: ' + escapeHtml(String(err)));
-    });
-  };
-
-  document.getElementById('prompt-input').addEventListener('keydown', function(e) {
-    if (e.key === 'Enter') { e.preventDefault(); window.sendPrompt(); }
-  });
-
-  function addMessage(type, html) {
-    var container = document.getElementById('agent-messages');
-    var div = document.createElement('div');
-    div.style.cssText = 'padding:0.8em 1em; border-radius:7px; margin-bottom:0.8em; line-height:1.6;';
-    if (type === 'user') {
-      div.style.background = '#f7f7f7';
-      div.style.border = '1px solid #eee';
-      div.innerHTML = '<b>You:</b> ' + html;
-    } else if (type === 'assistant' || type === 'answer') {
-      div.style.background = '#fff';
-      div.style.border = '1px solid #ddd';
-      div.innerHTML = '<b>Agent:</b> ' + html;
-    } else if (type === 'tool') {
-      div.style.background = '#fafafa';
-      div.style.border = '1px solid #e0e0e0';
-      div.style.fontSize = '0.95em';
-      div.innerHTML = html;
-    } else if (type === 'error') {
-      div.style.background = '#fff';
-      div.style.border = '1px solid #c00';
-      div.style.color = '#c00';
-      div.innerHTML = html;
-    }
-    container.appendChild(div);
-    container.scrollTop = container.scrollHeight;
-  }
-
-  function escapeHtml(str) {
-    var d = document.createElement('div');
-    d.textContent = str;
-    return d.innerHTML;
-  }
-})();
-</script>
-{{end}}
@@ -1,87 +0,0 @@
-{{define "content"}}
-<h2 class="text-2xl font-bold mb-4">Scopes</h2>
-<p style="color:#666; margin-bottom:1.5em;">
-  Set which scopes are required to call each endpoint. Tokens must carry a matching scope.
-  Endpoints with no scopes are open to any authenticated token.
-</p>
-
-{{if .Success}}
-<div style="background:#e6ffe6; border:1px solid #5a5; padding:0.8em 1.2em; border-radius:6px; margin-bottom:1.5em; color:#050;">
-  &#10003; Scopes updated successfully.
-</div>
-{{end}}
-
-<table style="margin-bottom:2em;">
-  <thead>
-    <tr><th>Service</th><th>Endpoint</th><th>Required Scopes</th><th></th></tr>
-  </thead>
-  <tbody>
-    {{range .Endpoints}}
-    <tr>
-      <td>{{.Service}}</td>
-      <td><code>{{.Endpoint}}</code></td>
-      <td>
-        {{if .Scopes}}
-          {{range .Scopes}}<code>{{.}}</code> {{end}}
-        {{else}}
-          <span style="color:#999;">none</span>
-        {{end}}
-      </td>
-      <td>
-        <form method="POST" action="/auth/scopes" style="display:inline; padding:0; border:0; box-shadow:none; background:none;">
-          <input type="hidden" name="endpoint" value="{{.Name}}">
-          <input name="scopes" value="{{.ScopesStr}}" placeholder="scope names" style="width:180px; margin-right:0.5em;">
-          <button type="submit">Save</button>
-        </form>
-      </td>
-    </tr>
-    {{end}}
-    {{if not .Endpoints}}
-    <tr>
-      <td colspan="4" style="color:#888; text-align:center; padding:2em;">No services discovered. Start some services and they will appear here.</td>
-    </tr>
-    {{end}}
-  </tbody>
-</table>
-
-<h3 style="margin-bottom:1em;">Bulk Set</h3>
-<p style="color:#666; margin-bottom:1em;">Apply scopes to all endpoints matching a pattern. Use <code>*</code> as a suffix wildcard. Leave scopes empty to clear.</p>
-<form method="POST" action="/auth/scopes/bulk" style="margin-bottom:2em;">
-  <input name="pattern" placeholder="Pattern (e.g. greeter.*)" required style="margin-right:0.5em; width:220px;">
-  <input name="scopes" placeholder="Scopes (comma separated)" style="margin-right:0.5em; width:220px;">
-  <button type="submit">Apply</button>
-</form>
-
-<h3 style="margin-bottom:1em;">Examples</h3>
-<div style="background:#f9f9f9; border:1px solid #eee; padding:1.2em 1.5em; border-radius:6px; font-size:0.97em; line-height:1.6;">
-
-  <p style="margin-top:0;">Scopes are strings that you define. A call is allowed when at least one of the token's scopes matches one of the endpoint's required scopes.</p>
-
-  <h4 style="margin-top:1em; margin-bottom:0.5em;">Restrict a whole service</h4>
-  <p>Use Bulk Set with pattern <code>greeter.*</code> and scope <code>greeter</code>.<br>
-  Then create a <a href="/auth/tokens">token</a> with scope <code>greeter</code> — it can call any endpoint on that service.</p>
-
-  <h4 style="margin-top:1em; margin-bottom:0.5em;">Restrict a specific endpoint</h4>
-  <p>Set scope <code>billing</code> on <code>payments.Payments.Charge</code> using the table above.<br>
-  Only tokens with the <code>billing</code> scope can call that endpoint. Other payment endpoints remain unaffected.</p>
-
-  <h4 style="margin-top:1em; margin-bottom:0.5em;">Role-based access</h4>
-  <p>Set scope <code>admin</code> on sensitive endpoints (e.g. <code>users.Users.Delete</code>).<br>
-  Create tokens with <code>admin</code> scope for operators and <code>user</code> scope for regular access.<br>
-  An endpoint can require multiple scopes — the token only needs to match <b>one</b> of them.</p>
-
-  <h4 style="margin-top:1em; margin-bottom:0.5em;">Full access</h4>
-  <p>The default <code>admin</code> user has scope <code>*</code> which bypasses all checks.<br>
-  Create a token with <code>*</code> scope for services that need unrestricted access.</p>
-
-  <h4 style="margin-top:1em; margin-bottom:0.5em;">Where scopes are checked</h4>
-  <table style="font-size:0.95em; margin:0.5em 0;">
-    <thead><tr><th>Access method</th><th>How auth works</th></tr></thead>
-    <tbody>
-      <tr><td>API (<code>/api/service/endpoint</code>)</td><td><code>Authorization: Bearer &lt;token&gt;</code> header</td></tr>
-      <tr><td>MCP tools (<code>/api/mcp/call</code>)</td><td><code>Authorization: Bearer &lt;token&gt;</code> header</td></tr>
-      <tr><td>Agent playground</td><td>Uses your logged-in session and its scopes</td></tr>
-    </tbody>
-  </table>
-</div>
-{{end}}
@@ -5,7 +5,7 @@ This is protobuf code generation for go-micro. We use protoc-gen-micro to reduce
 ## Install

 ```
-go install go-micro.dev/v5/cmd/protoc-gen-micro@v5.16.0
+go install go-micro.dev/v5/cmd/protoc-gen-micro@latest
 ```

 Also required: 
@@ -0,0 +1,24 @@
+module go-micro.dev/v5/cmd/protoc-gen-micro
+
+go 1.24.1
+
+require (
+	go-micro.dev/v5 v5.11.0
+	google.golang.org/genproto/googleapis/api v0.0.0-20250324211829-b45e905df463
+	google.golang.org/protobuf v1.36.6
+)
+
+require (
+	github.com/golang/protobuf v1.5.4 // indirect
+	github.com/google/uuid v1.6.0 // indirect
+	github.com/miekg/dns v1.1.50 // indirect
+	github.com/oxtoacart/bpool v0.0.0-20190530202638-03653db5a59c // indirect
+	github.com/patrickmn/go-cache v2.1.0+incompatible // indirect
+	github.com/pkg/errors v0.9.1 // indirect
+	golang.org/x/mod v0.24.0 // indirect
+	golang.org/x/net v0.38.0 // indirect
+	golang.org/x/sync v0.13.0 // indirect
+	golang.org/x/sys v0.32.0 // indirect
+	golang.org/x/text v0.24.0 // indirect
+	golang.org/x/tools v0.31.0 // indirect
+)
@@ -0,0 +1,81 @@
+github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc h1:U9qPSI2PIWSS1VwoXQT9A3Wy9MM3WgvqSxFWenqJduM=
+github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/golang/protobuf v1.5.4 h1:i7eJL8qZTpSEXOPTxNKhASYpMn+8e5Q6AdndVa1dWek=
+github.com/golang/protobuf v1.5.4/go.mod h1:lnTiLA8Wa4RWRcIUkrtSVa5nRhsEGBg48fD6rSs7xps=
+github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=
+github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=
+github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
+github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
+github.com/klauspost/compress v1.18.0 h1:c/Cqfb0r+Yi+JtIEq73FWXVkRonBlf0CRNYc8Zttxdo=
+github.com/klauspost/compress v1.18.0/go.mod h1:2Pp+KzxcywXVXMr50+X0Q/Lsb43OQHYWRCY2AiWywWQ=
+github.com/miekg/dns v1.1.50 h1:DQUfb9uc6smULcREF09Uc+/Gd46YWqJd5DbpPE9xkcA=
+github.com/miekg/dns v1.1.50/go.mod h1:e3IlAVfNqAllflbibAZEWOXOQ+Ynzk/dDozDxY7XnME=
+github.com/nats-io/nats.go v1.42.0 h1:ynIMupIOvf/ZWH/b2qda6WGKGNSjwOUutTpWRvAmhaM=
+github.com/nats-io/nats.go v1.42.0/go.mod h1:iRWIPokVIFbVijxuMQq4y9ttaBTMe0SFdlZfMDd+33g=
+github.com/nats-io/nkeys v0.4.11 h1:q44qGV008kYd9W1b1nEBkNzvnWxtRSQ7A8BoqRrcfa0=
+github.com/nats-io/nkeys v0.4.11/go.mod h1:szDimtgmfOi9n25JpfIdGw12tZFYXqhGxjhVxsatHVE=
+github.com/nats-io/nuid v1.0.1 h1:5iA8DT8V7q8WK2EScv2padNa/rTESc1KdnPw4TC2paw=
+github.com/nats-io/nuid v1.0.1/go.mod h1:19wcPz3Ph3q0Jbyiqsd0kePYG7A95tJPxeL+1OSON2c=
+github.com/oxtoacart/bpool v0.0.0-20190530202638-03653db5a59c h1:rp5dCmg/yLR3mgFuSOe4oEnDDmGLROTvMragMUXpTQw=
+github.com/oxtoacart/bpool v0.0.0-20190530202638-03653db5a59c/go.mod h1:X07ZCGwUbLaax7L0S3Tw4hpejzu63ZrrQiUe6W0hcy0=
+github.com/patrickmn/go-cache v2.1.0+incompatible h1:HRMgzkcYKYpi3C8ajMPV8OFXaaRUnok+kx1WdO15EQc=
+github.com/patrickmn/go-cache v2.1.0+incompatible/go.mod h1:3Qf8kWWT7OJRJbdiICTKqZju1ZixQ/KpMGzzAfe6+WQ=
+github.com/pkg/errors v0.9.1 h1:FEBLx1zS214owpjy7qsBeixbURkuhQAwrK5UwLGTwt4=
+github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2 h1:Jamvg5psRIccs7FGNTlIRMkT8wgtp5eCXdBlqhYGL6U=
+github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
+github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
+github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
+github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
+github.com/yuin/goldmark v1.3.5/go.mod h1:mwnBkeHKe2W/ZEtQ+71ViKU8L12m81fl3OWwC1Zlc8k=
+go-micro.dev/v5 v5.11.0 h1:Ild7kJ87KNetw/lLyemVlIR7DzaVrbQtFTJJQKT0DPI=
+go-micro.dev/v5 v5.11.0/go.mod h1:mmDdppSKjomfRVogN4WjGX9OUXT+1vNCTV1stSaXEq4=
+golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
+golang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI=
+golang.org/x/crypto v0.37.0 h1:kJNSjF/Xp7kU0iB2Z+9viTPMW4EqqsrywMXLJOOsXSE=
+golang.org/x/crypto v0.37.0/go.mod h1:vg+k43peMZ0pUMhYmVAWysMK35e6ioLh3wB8ZCAfbVc=
+golang.org/x/mod v0.4.2/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA=
+golang.org/x/mod v0.24.0 h1:ZfthKaKaT4NrhGVZHO1/WDTwGES4De8KtWO0SIbNJMU=
+golang.org/x/mod v0.24.0/go.mod h1:IXM97Txy2VM4PJ3gI61r1YEk/gAj6zAHN3AdZt6S9Ww=
+golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
+golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
+golang.org/x/net v0.0.0-20210405180319-a5a99cb37ef4/go.mod h1:p54w0d4576C0XHj96bSt6lcn1PtDYWL6XObtHCRCNQM=
+golang.org/x/net v0.0.0-20210726213435-c6fcb2dbf985/go.mod h1:9nx3DQGgdP8bBQD5qxJ1jj9UTztislL4KSBs9R2vV5Y=
+golang.org/x/net v0.38.0 h1:vRMAPTMaeGqVhG5QyLJHqNDwecKTomGeqbnfZyKlBI8=
+golang.org/x/net v0.38.0/go.mod h1:ivrbrMbzFq5J41QOQh0siUuly180yBYtLp+CKbEaFx8=
+golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.0.0-20210220032951-036812b2e83c/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.13.0 h1:AauUjRAJ9OSnvULf/ARrrVywoJDy0YS2AwQ98I37610=
+golang.org/x/sync v0.13.0/go.mod h1:1dzgHSNfp02xaA81J2MS99Qcpr2w7fw1gpm99rleRqA=
+golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
+golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20210330210617-4fbd30eecc44/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20210423082822-04245dca01da/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20210510120138-977fb7262007/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.0.0-20210630005230-0f9fa26af87c/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.32.0 h1:s77OFDvIQeibCmezSnk/q6iAfkdiQaJi4VzroCFrN20=
+golang.org/x/sys v0.32.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k=
+golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo=
+golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
+golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
+golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
+golang.org/x/text v0.24.0 h1:dd5Bzh4yt5KYA8f9CJHCP4FB4D51c2c6JvN37xJJkJ0=
+golang.org/x/text v0.24.0/go.mod h1:L8rBsPeo2pSS+xqN0d5u2ikmjtmoJbDBT1b7nHvFCdU=
+golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
+golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
+golang.org/x/tools v0.1.6-0.20210726203631-07bc1bf47fb2/go.mod h1:o0xws9oXOQQZyjljx8fwUC0k7L1pTE6eaCbjGeHmOkk=
+golang.org/x/tools v0.31.0 h1:0EedkvKDbh+qistFTd0Bcwe/YLh4vHwWEkiI0toFIBU=
+golang.org/x/tools v0.31.0/go.mod h1:naFTU+Cev749tSJRXJlna0T3WxKvb1kWEx15xA4SdmQ=
+golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+golang.org/x/xerrors v0.0.0-20191011141410-1b5146add898/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+google.golang.org/genproto/googleapis/api v0.0.0-20250324211829-b45e905df463 h1:hE3bRWtU6uceqlh4fhrSnUyjKHMKB9KrTLLG+bc0ddM=
+google.golang.org/genproto/googleapis/api v0.0.0-20250324211829-b45e905df463/go.mod h1:U90ffi8eUL9MwPcrJylN5+Mk2v3vuPDptd5yyNUiRR8=
+google.golang.org/protobuf v1.36.6 h1:z1NpPI8ku2WgiWnf+t9wTPsn6eP1L7ksHUlkfLvd9xY=
+google.golang.org/protobuf v1.36.6/go.mod h1:jduwjTPXsFjZGTmRluh+L6NjiWu7pchiJ2/5YcXBHnY=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
@@ -1,91 +0,0 @@
-package json
-
-import (
-	"encoding/json"
-	"testing"
-
-	"google.golang.org/protobuf/types/known/anypb"
-	"google.golang.org/protobuf/types/known/wrapperspb"
-)
-
-// TestAnyTypeMarshaling tests that google.protobuf.Any types are properly marshaled with @type field
-func TestAnyTypeMarshaling(t *testing.T) {
-	marshaler := Marshaler{}
-
-	// Create a StringValue message
-	stringValue := wrapperspb.String("test value")
-
-	// Wrap it in an Any message
-	anyMsg, err := anypb.New(stringValue)
-	if err != nil {
-		t.Fatalf("Failed to create Any message: %v", err)
-	}
-
-	// Marshal using our JSON marshaler
-	data, err := marshaler.Marshal(anyMsg)
-	if err != nil {
-		t.Fatalf("Failed to marshal Any message: %v", err)
-	}
-
-	// Unmarshal into a map to check for @type field
-	var result map[string]interface{}
-	if err := json.Unmarshal(data, &result); err != nil {
-		t.Fatalf("Failed to unmarshal JSON: %v", err)
-	}
-
-	// Check that @type field exists
-	typeURL, ok := result["@type"].(string)
-	if !ok {
-		t.Fatalf("@type field not found in JSON output. Got: %v", string(data))
-	}
-
-	// Verify the type URL is correct
-	expectedTypeURL := "type.googleapis.com/google.protobuf.StringValue"
-	if typeURL != expectedTypeURL {
-		t.Errorf("Expected @type to be %s, got %s", expectedTypeURL, typeURL)
-	}
-
-	// Verify the value field exists
-	if _, ok := result["value"]; !ok {
-		t.Errorf("value field not found in JSON output. Got: %v", string(data))
-	}
-
-	t.Logf("Successfully marshaled Any type with @type field: %s", string(data))
-}
-
-// TestAnyTypeUnmarshaling tests that JSON with @type field can be unmarshaled into google.protobuf.Any
-func TestAnyTypeUnmarshaling(t *testing.T) {
-	marshaler := Marshaler{}
-
-	// JSON representation of an Any message with @type field
-	jsonData := []byte(`{
-		"@type": "type.googleapis.com/google.protobuf.StringValue",
-		"value": "test value"
-	}`)
-
-	// Unmarshal into an Any message
-	anyMsg := &anypb.Any{}
-	if err := marshaler.Unmarshal(jsonData, anyMsg); err != nil {
-		t.Fatalf("Failed to unmarshal Any message: %v", err)
-	}
-
-	// Verify the type URL is set
-	expectedTypeURL := "type.googleapis.com/google.protobuf.StringValue"
-	if anyMsg.TypeUrl != expectedTypeURL {
-		t.Errorf("Expected TypeUrl to be %s, got %s", expectedTypeURL, anyMsg.TypeUrl)
-	}
-
-	// Unmarshal the contained message
-	stringValue := &wrapperspb.StringValue{}
-	if err := anyMsg.UnmarshalTo(stringValue); err != nil {
-		t.Fatalf("Failed to unmarshal contained message: %v", err)
-	}
-
-	// Verify the value
-	expectedValue := "test value"
-	if stringValue.Value != expectedValue {
-		t.Errorf("Expected value to be %s, got %s", expectedValue, stringValue.Value)
-	}
-
-	t.Logf("Successfully unmarshaled Any type from JSON with @type field")
-}
@@ -1,98 +0,0 @@
-package json
-
-import (
-	"bytes"
-	"encoding/json"
-	"testing"
-
-	"go-micro.dev/v5/codec"
-	"google.golang.org/protobuf/types/known/anypb"
-	"google.golang.org/protobuf/types/known/wrapperspb"
-)
-
-// mockReadWriteCloser implements io.ReadWriteCloser for testing
-type mockReadWriteCloser struct {
-	*bytes.Buffer
-}
-
-func (m *mockReadWriteCloser) Close() error {
-	return nil
-}
-
-// TestCodecAnyTypeWrite tests that google.protobuf.Any types are properly written with @type field
-func TestCodecAnyTypeWrite(t *testing.T) {
-	buf := &mockReadWriteCloser{Buffer: bytes.NewBuffer(nil)}
-	c := NewCodec(buf).(*Codec)
-
-	// Create a StringValue message
-	stringValue := wrapperspb.String("test value")
-
-	// Wrap it in an Any message
-	anyMsg, err := anypb.New(stringValue)
-	if err != nil {
-		t.Fatalf("Failed to create Any message: %v", err)
-	}
-
-	// Write the message
-	msg := &codec.Message{
-		Type: codec.Response,
-	}
-	if err := c.Write(msg, anyMsg); err != nil {
-		t.Fatalf("Failed to write Any message: %v", err)
-	}
-
-	// Parse the written JSON
-	var result map[string]interface{}
-	if err := json.Unmarshal(buf.Bytes(), &result); err != nil {
-		t.Fatalf("Failed to unmarshal JSON: %v", err)
-	}
-
-	// Check that @type field exists
-	typeURL, ok := result["@type"].(string)
-	if !ok {
-		t.Fatalf("@type field not found in JSON output. Got: %v", buf.String())
-	}
-
-	// Verify the type URL is correct
-	expectedTypeURL := "type.googleapis.com/google.protobuf.StringValue"
-	if typeURL != expectedTypeURL {
-		t.Errorf("Expected @type to be %s, got %s", expectedTypeURL, typeURL)
-	}
-
-	t.Logf("Successfully wrote Any type with @type field: %s", buf.String())
-}
-
-// TestCodecAnyTypeRead tests that JSON with @type field can be read into google.protobuf.Any
-func TestCodecAnyTypeRead(t *testing.T) {
-	// JSON representation of an Any message with @type field
-	jsonData := `{"@type":"type.googleapis.com/google.protobuf.StringValue","value":"test value"}`
-
-	buf := &mockReadWriteCloser{Buffer: bytes.NewBufferString(jsonData + "\n")}
-	c := NewCodec(buf).(*Codec)
-
-	// Read into an Any message
-	anyMsg := &anypb.Any{}
-	if err := c.ReadBody(anyMsg); err != nil {
-		t.Fatalf("Failed to read Any message: %v", err)
-	}
-
-	// Verify the type URL is set
-	expectedTypeURL := "type.googleapis.com/google.protobuf.StringValue"
-	if anyMsg.TypeUrl != expectedTypeURL {
-		t.Errorf("Expected TypeUrl to be %s, got %s", expectedTypeURL, anyMsg.TypeUrl)
-	}
-
-	// Unmarshal the contained message
-	stringValue := &wrapperspb.StringValue{}
-	if err := anyMsg.UnmarshalTo(stringValue); err != nil {
-		t.Fatalf("Failed to unmarshal contained message: %v", err)
-	}
-
-	// Verify the value
-	expectedValue := "test value"
-	if stringValue.Value != expectedValue {
-		t.Errorf("Expected value to be %s, got %s", expectedValue, stringValue.Value)
-	}
-
-	t.Logf("Successfully read Any type from JSON with @type field")
-}
@@ -5,9 +5,9 @@ import (
 	"encoding/json"
 	"io"

+	"github.com/golang/protobuf/jsonpb"
+	"github.com/golang/protobuf/proto"
 	"go-micro.dev/v5/codec"
-	"google.golang.org/protobuf/encoding/protojson"
-	"google.golang.org/protobuf/proto"
 )

 type Codec struct {
@@ -25,12 +25,7 @@ func (c *Codec) ReadBody(b interface{}) error {
 		return nil
 	}
 	if pb, ok := b.(proto.Message); ok {
-		// Read all JSON data from decoder
-		var raw json.RawMessage
-		if err := c.Decoder.Decode(&raw); err != nil {
-			return err
-		}
-		return protojson.Unmarshal(raw, pb)
+		return jsonpb.UnmarshalNext(c.Decoder, pb)
 	}
 	return c.Decoder.Decode(b)
 }
@@ -39,15 +34,6 @@ func (c *Codec) Write(m *codec.Message, b interface{}) error {
 	if b == nil {
 		return nil
 	}
-	if pb, ok := b.(proto.Message); ok {
-		data, err := protojson.Marshal(pb)
-		if err != nil {
-			return err
-		}
-		// Write the marshaled data to the encoder
-		var raw json.RawMessage = data
-		return c.Encoder.Encode(raw)
-	}
 	return c.Encoder.Encode(b)
 }

@@ -1,28 +1,36 @@
 package json

 import (
+	"bytes"
 	"encoding/json"

-	"google.golang.org/protobuf/encoding/protojson"
-	"google.golang.org/protobuf/proto"
+	"github.com/golang/protobuf/jsonpb"
+	"github.com/golang/protobuf/proto"
+	"github.com/oxtoacart/bpool"
 )

-var protojsonMarshaler = protojson.MarshalOptions{
-	EmitUnpopulated: false,
-}
+var jsonpbMarshaler = &jsonpb.Marshaler{}
+
+// create buffer pool with 16 instances each preallocated with 256 bytes.
+var bufferPool = bpool.NewSizedBufferPool(16, 256)

 type Marshaler struct{}

 func (j Marshaler) Marshal(v interface{}) ([]byte, error) {
 	if pb, ok := v.(proto.Message); ok {
-		return protojsonMarshaler.Marshal(pb)
+		buf := bufferPool.Get()
+		defer bufferPool.Put(buf)
+		if err := jsonpbMarshaler.Marshal(buf, pb); err != nil {
+			return nil, err
+		}
+		return buf.Bytes(), nil
 	}
 	return json.Marshal(v)
 }

 func (j Marshaler) Unmarshal(d []byte, v interface{}) error {
 	if pb, ok := v.(proto.Message); ok {
-		return protojson.Unmarshal(d, pb)
+		return jsonpb.Unmarshal(bytes.NewReader(d), pb)
 	}
 	return json.Unmarshal(d, v)
 }
@@ -15,7 +15,6 @@ type nats struct {
 	url    string
 	bucket string
 	key    string
-	conn   *natsgo.Conn // store connection for lifecycle management
 	kv     natsgo.KeyValue
 	opts   source.Options
 }
@@ -129,18 +128,7 @@ func NewSource(opts ...source.Option) source.Source {
 		url:    config.Url,
 		bucket: bucket,
 		key:    key,
-		conn:   nc, // store connection reference
 		kv:     kv,
 		opts:   options,
 	}
 }
-
-// Close implements io.Closer and closes the underlying NATS connection.
-// This method is optional but recommended to prevent connection leaks.
-func (n *nats) Close() error {
-	if n.conn != nil {
-		n.conn.Close()
-		n.conn = nil
-	}
-	return nil
-}
@@ -108,9 +108,7 @@ func (m *mem) Consume(topic string, opts ...ConsumeOption) (<-chan Event, error)
 	for _, o := range opts {
 		o(&options)
 	}
-
-	// Note: RetryLimit is configured but retry logic is basic for the in-memory implementation.
-	// For production use with advanced retry capabilities, use NATS JetStream.
+	// TODO RetryLimit

 	// setup the subscriber
 	sub := &subscriber{
@@ -5,7 +5,6 @@ import (
 	"context"
 	"encoding/json"
 	"fmt"
-	"io"
 	"strings"
 	"time"

@@ -36,12 +35,11 @@ func NewStream(opts ...Option) (events.Stream, error) {

 	s := &stream{opts: options}

-	conn, natsJetStreamCtx, err := connectToNatsJetStream(options)
+	natsJetStreamCtx, err := connectToNatsJetStream(options)
 	if err != nil {
 		return nil, fmt.Errorf("error connecting to nats cluster %v: %w", options.ClusterID, err)
 	}

-	s.conn = conn
 	s.natsJetStreamCtx = natsJetStreamCtx

 	return s, nil
@@ -49,11 +47,10 @@ func NewStream(opts ...Option) (events.Stream, error) {

 type stream struct {
 	opts             Options
-	conn             *nats.Conn // store connection for lifecycle management
 	natsJetStreamCtx nats.JetStreamContext
 }

-func connectToNatsJetStream(options Options) (*nats.Conn, nats.JetStreamContext, error) {
+func connectToNatsJetStream(options Options) (nats.JetStreamContext, error) {
 	nopts := nats.GetDefaultOptions()
 	if options.TLSConfig != nil {
 		nopts.Secure = true
@@ -80,16 +77,15 @@ func connectToNatsJetStream(options Options) (*nats.Conn, nats.JetStreamContext,
 	conn, err := nopts.Connect()
 	if err != nil {
 		tls := nopts.TLSConfig != nil
-		return nil, nil, fmt.Errorf("error connecting to nats at %v with tls enabled (%v): %w", options.Address, tls, err)
+		return nil, fmt.Errorf("error connecting to nats at %v with tls enabled (%v): %w", options.Address, tls, err)
 	}

 	js, err := conn.JetStream()
 	if err != nil {
-		conn.Close() // Close connection if JetStream context fails
-		return nil, nil, fmt.Errorf("error while obtaining JetStream context: %w", err)
+		return nil, fmt.Errorf("error while obtaining JetStream context: %w", err)
 	}

-	return conn, js, nil
+	return js, nil
 }

 // Publish a message to a topic.
@@ -272,16 +268,3 @@ func (s *stream) Consume(topic string, opts ...events.ConsumeOption) (<-chan eve

 	return channel, nil
 }
-
-// Close implements io.Closer and closes the underlying NATS connection.
-// This method is optional but recommended to prevent connection leaks.
-func (s *stream) Close() error {
-	if s.conn != nil {
-		s.conn.Close()
-		s.conn = nil
-	}
-	return nil
-}
-
-// Ensure stream implements io.Closer
-var _ io.Closer = (*stream)(nil)
@@ -53,7 +53,6 @@ func runTestStream(t *testing.T, stream Stream) {

 		// setup the subscriber async
 		var wg sync.WaitGroup
-		wg.Add(1)

 		go func() {
 			timeout := time.NewTimer(time.Millisecond * 250)
@@ -76,6 +75,7 @@ func runTestStream(t *testing.T, stream Stream) {

 		err = stream.Publish("test", payload, WithMetadata(metadata))
 		assert.Nil(t, err, "Publishing a valid message should not return an error")
+		wg.Add(1)

 		// wait for the subscriber to recieve the message or timeout
 		wg.Wait()
@@ -95,7 +95,6 @@ func runTestStream(t *testing.T, stream Stream) {

 		// setup the subscriber async
 		var wg sync.WaitGroup
-		wg.Add(2)

 		go func() {
 			timeout := time.NewTimer(time.Millisecond * 250)
@@ -118,6 +117,7 @@ func runTestStream(t *testing.T, stream Stream) {

 		err = stream.Publish(topic, payload, WithMetadata(metadata))
 		assert.Nil(t, err, "Publishing a valid message should not return an error")
+		wg.Add(2)

 		// create the second subscriber
 		evChan2, err := stream.Consume(topic,
@@ -1,62 +0,0 @@
-# Go Micro Examples
-
-This directory contains runnable examples demonstrating various go-micro features and patterns.
-
-## Quick Start
-
-Each example can be run with `go run .` from its directory.
-
-## Examples
-
-### [hello-world](./hello-world/)
-Basic RPC service demonstrating core concepts:
- Service creation and registration
- Handler implementation
- Client calls
- Health checks
-
-**Run it:**
-```bash
-cd hello-world
-go run .
-```
-
-### [web-service](./web-service/)
-HTTP web service with service discovery:
- HTTP handlers
- Service registration
- Health checks
- JSON REST API
-
-**Run it:**
-```bash
-cd web-service
-go run .
-```
-
-## Coming Soon
-
-The following examples are planned:
-
- **pubsub-events** - Event-driven architecture with NATS
- **grpc-integration** - Using go-micro with gRPC
- **production-ready** - Complete production-grade service with observability
-
-## Prerequisites
-
-Some examples require external dependencies:
-
- **NATS**: `docker run -p 4222:4222 nats:latest`
- **Consul**: `docker run -p 8500:8500 consul:latest agent -dev -ui -client=0.0.0.0`
- **Redis**: `docker run -p 6379:6379 redis:latest`
-
-## Contributing
-
-To add a new example:
-
-1. Create a new directory
-2. Add a descriptive README.md
-3. Include working code with comments
-4. Add to this index
-5. Ensure it runs with `go run .`
-
@@ -1,12 +0,0 @@
-# Compiled binaries
-server/server
-client/client
-
-# Test binaries
-*.test
-
-# Output files
-*.out
-
-# Temporary files
-*.tmp
@@ -1,396 +0,0 @@
-# Auth Example
-
-This example demonstrates how to use the auth wrappers to protect your microservices with authentication and authorization.
-
-## Overview
-
-The example includes:
-
- **Server** - A Greeter service with:
-  - Protected endpoint: `Greeter.Hello` (requires auth)
-  - Public endpoint: `Greeter.Health` (no auth required)
-
- **Client** - Makes calls to the server:
-  - With authentication (successful)
-  - Without authentication (fails as expected)
-
-## Architecture
-
-```
-┌─────────────────────────────────────────┐
-│            Client                       │
-│  ┌────────────────────────────────┐    │
-│  │  AuthClient Wrapper            │    │
-│  │  - Adds Bearer token           │    │
-│  │  - To all requests             │    │
-│  └────────────────────────────────┘    │
-└──────────────┬──────────────────────────┘
-               │ RPC with Authorization: Bearer <token>
-               │
-               ▼
-┌─────────────────────────────────────────┐
-│            Server                       │
-│  ┌────────────────────────────────┐    │
-│  │  AuthHandler Wrapper           │    │
-│  │  - Extracts token              │    │
-│  │  - Verifies with auth.Inspect()│    │
-│  │  - Checks with rules.Verify()  │    │
-│  │  - Returns 401/403 if denied   │    │
-│  └────────────────────────────────┘    │
-│               │                         │
-│               ▼                         │
-│  ┌────────────────────────────────┐    │
-│  │  Handler (Greeter.Hello)       │    │
-│  │  - Gets account from context   │    │
-│  │  - Processes request           │    │
-│  └────────────────────────────────┘    │
-└─────────────────────────────────────────┘
-```
-
-## Files
-
-```
-examples/auth/
-├── README.md              # This file
-├── proto/
-│   ├── greeter.proto     # Service definition
-│   └── greeter.pb.go     # Generated Go code
-├── server/
-│   └── main.go           # Protected service
-└── client/
-    └── main.go           # Client with auth
-```
-
-## Running the Example
-
-### 1. Start the Server
-
-```bash
-cd server
-go run main.go
-```
-
-The server will:
- Start the Greeter service
- Apply auth wrapper to protect endpoints
- Generate a test token and print it
-
-Output:
-```
-=== Test Token Generated ===
-Use this token to test the client:
-TOKEN=eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9... go run client/main.go
-
-2026/02/11 10:00:00 Server [greeter] Listening on [::]:54321
-```
-
-### 2. Run the Client (With Auth)
-
-In a new terminal:
-
-```bash
-cd client
-TOKEN=<token-from-server> go run main.go
-```
-
-Output:
-```
-=== Test 1: Protected endpoint WITH auth ===
-Response: Hello, test-user!
-
-=== Test 2: Public endpoint (no auth needed) ===
-Health Status: ok
-
-=== Test 3: Protected endpoint WITHOUT auth (should fail) ===
-Expected error: {"id":"greeter","code":401,"detail":"missing authorization token","status":"Unauthorized"}
-```
-
-### 3. Run the Client (Without Auth)
-
-```bash
-cd client
-go run main.go
-```
-
-This will auto-generate a token for testing.
-
-## Code Walkthrough
-
-### Server Setup
-
-```go
-// 1. Create auth provider
-// For this example we use the noop auth (accepts all tokens)
-// In production, use JWT or a custom auth provider
-authProvider := noop.NewAuth()
-
-// 2. Create authorization rules
-rules := auth.NewRules()
-rules.Grant(&auth.Rule{
-    ID:       "public-health",
-    Scope:    "",
-    Resource: &auth.Resource{Endpoint: "Greeter.Health"},
-    Access:   auth.AccessGranted,
-})
-
-// 3. Wrap service with auth handler
-service := micro.NewService(
-    micro.Name("greeter"),
-    micro.WrapHandler(
-        authWrapper.AuthHandler(authWrapper.HandlerOptions{
-            Auth:          authProvider,
-            Rules:         rules,
-            SkipEndpoints: []string{"Greeter.Health"},
-        }),
-    ),
-)
-```
-
-### Client Setup
-
-```go
-// 1. Get or generate token
-token := os.Getenv("TOKEN")
-
-// 2. Wrap client with auth
-service := micro.NewService(
-    micro.Name("greeter.client"),
-    micro.WrapClient(
-        authWrapper.FromToken(token),
-    ),
-)
-
-// 3. Make calls (token automatically added)
-greeterClient := pb.NewGreeterService("greeter", service.Client())
-rsp, err := greeterClient.Hello(ctx, &pb.Request{Name: "John"})
-```
-
-### Handler Implementation
-
-```go
-func (g *Greeter) Hello(ctx context.Context, req *pb.Request, rsp *pb.Response) error {
-    // Get account from context (added by auth wrapper)
-    acc, ok := auth.AccountFromContext(ctx)
-    if !ok {
-        return errors.Unauthorized("greeter", "authentication required")
-    }
-
-    rsp.Msg = "Hello, " + acc.ID + "!"
-    return nil
-}
-```
-
-## Auth Wrapper Features
-
-### Server Wrapper (`AuthHandler`)
-
- **Token Extraction**: Reads `Authorization: Bearer <token>` from metadata
- **Token Verification**: Validates token using `auth.Inspect()`
- **Authorization**: Checks permissions using `rules.Verify()`
- **Context Injection**: Adds account to context for handlers
- **Error Handling**: Returns 401/403 with clear error messages
- **Skip Endpoints**: Allows public endpoints without auth
-
-### Client Wrapper (`AuthClient`)
-
- **Automatic Token Injection**: Adds Bearer token to all requests
- **Context-Aware**: Can extract account from context
- **Static Token**: Use `FromToken()` for pre-generated tokens
- **Dynamic Token**: Use `FromContext()` to generate per-request
-
-## Auth Strategies
-
-### 1. All Endpoints Protected
-
-```go
-micro.WrapHandler(
-    authWrapper.AuthRequired(authProvider, rules),
-)
-```
-
-### 2. Some Public Endpoints
-
-```go
-micro.WrapHandler(
-    authWrapper.PublicEndpoints(authProvider, rules, []string{
-        "Health.Check",
-        "Status.Version",
-    }),
-)
-```
-
-### 3. Optional Auth (Extract but Don't Enforce)
-
-```go
-micro.WrapHandler(
-    authWrapper.AuthOptional(authProvider),
-)
-```
-
-## Authorization Rules
-
-### Grant Public Access
-
-```go
-rules.Grant(&auth.Rule{
-    ID:       "public",
-    Scope:    "",  // No scope = public
-    Resource: &auth.Resource{Endpoint: "Health.Check"},
-    Access:   auth.AccessGranted,
-})
-```
-
-### Require Authentication
-
-```go
-rules.Grant(&auth.Rule{
-    ID:       "authenticated",
-    Scope:    "*",  // Any authenticated user
-    Resource: &auth.Resource{Endpoint: "*"},
-    Access:   auth.AccessGranted,
-})
-```
-
-### Require Specific Scope
-
-```go
-rules.Grant(&auth.Rule{
-    ID:       "admin-only",
-    Scope:    "admin",  // Only admin scope
-    Resource: &auth.Resource{Endpoint: "Admin.*"},
-    Access:   auth.AccessGranted,
-})
-```
-
-### Deny Access
-
-```go
-rules.Grant(&auth.Rule{
-    ID:       "deny-delete",
-    Scope:    "*",
-    Resource: &auth.Resource{Endpoint: "User.Delete"},
-    Access:   auth.AccessDenied,
-    Priority: 100,  // Higher priority = evaluated first
-})
-```
-
-## Testing Without Server
-
-You can test auth logic without a running server:
-
-```go
-import "go-micro.dev/v5/auth/noop"
-
-// Create auth provider (noop for testing)
-authProvider := noop.NewAuth()
-
-// Generate account
-acc, _ := authProvider.Generate("test-user", auth.WithScopes("admin"))
-
-// Generate token
-token, _ := authProvider.Token(auth.WithCredentials(acc.ID, acc.Secret))
-
-// Verify token
-verified, _ := authProvider.Inspect(token.AccessToken)
-fmt.Println(verified.ID) // Returns a generated UUID
-```
-
-## Production Considerations
-
-### 1. Use Production Auth Provider
-
-The noop auth provider (`auth.NewAuth()`) is for development only. It accepts any token.
-
-For production, implement a proper auth provider or use the JWT implementation:
-
-```go
-// Option 1: Implement custom auth.Auth interface
-type MyAuth struct {
-    // Your implementation
-}
-
-func (m *MyAuth) Generate(id string, opts ...auth.GenerateOption) (*auth.Account, error) {
-    // Generate real accounts
-}
-
-func (m *MyAuth) Inspect(token string) (*auth.Account, error) {
-    // Verify real tokens (JWT, OAuth, etc.)
-}
-
-// Option 2: Use JWT auth (requires jwt package implementation)
-// Note: The jwt package in auth/jwt depends on an external plugin
-// You may need to implement your own JWT auth or use a third-party library
-```
-
-### 3. Add Gateway Auth
-
-If using HTTP gateway:
-
-```go
-// Add auth to HTTP gateway
-http.Handle("/", gateway.Handler(
-    gateway.WithAuth(authProvider),
-))
-```
-
-### 4. Service-to-Service Auth
-
-Services calling other services:
-
-```go
-// Service A calls Service B with its own token
-client := micro.NewService(
-    micro.WrapClient(
-        authWrapper.FromContext(authProvider),
-    ),
-)
-```
-
-### 5. Token Refresh
-
-```go
-// Check if token is expiring
-if time.Until(token.Expiry) < 5*time.Minute {
-    token, _ = authProvider.Token(auth.WithToken(token.RefreshToken))
-}
-```
-
-## Troubleshooting
-
-### Error: "missing authorization token"
-
- **Cause**: Client didn't send Authorization header
- **Fix**: Wrap client with `authWrapper.FromToken(token)`
-
-### Error: "invalid token"
-
- **Cause**: Token is expired or malformed
- **Fix**: Generate a new token
-
-### Error: "access denied"
-
- **Cause**: Account doesn't have required permissions
- **Fix**: Check authorization rules with `rules.List()`
-
-### Error: "token verification failed"
-
- **Cause**: Server can't verify token (wrong keys, expired, etc.)
- **Fix**: Ensure server and client use same auth provider
-
-## Next Steps
-
- Read the [Auth Documentation](/docs/auth)
- Explore [JWT Auth](/auth/jwt)
- Try [Custom Auth Provider](/examples/auth/custom)
- See [Multi-Tenant Auth](/examples/auth/multi-tenant)
-
-## Summary
-
-The auth wrappers make it easy to:
-
-1. **Protect services**: Add `WrapHandler(AuthHandler(...))`
-2. **Add authentication to clients**: Add `WrapClient(FromToken(...))`
-3. **Control access**: Define rules with `rules.Grant()`
-4. **Access account info**: Use `auth.AccountFromContext(ctx)`
-
-That's it! Your microservices now have enterprise-grade authentication and authorization.
@@ -1,85 +0,0 @@
-package main
-
-import (
-	"context"
-	"fmt"
-	"log"
-	"os"
-
-	"go-micro.dev/v5"
-	"go-micro.dev/v5/auth"
-	"go-micro.dev/v5/auth/noop"
-	"go-micro.dev/v5/client"
-	authWrapper "go-micro.dev/v5/wrapper/auth"
-
-	pb "go-micro.dev/v5/examples/auth/proto"
-)
-
-func main() {
-	// Get token from environment or generate one
-	token := os.Getenv("TOKEN")
-
-	// Create auth provider (same as server)
-	authProvider := noop.NewAuth()
-
-	// If no token provided, generate one
-	if token == "" {
-		log.Println("No TOKEN env var provided, generating test token...")
-		acc, err := authProvider.Generate("test-user")
-		if err != nil {
-			log.Fatal(err)
-		}
-
-		t, err := authProvider.Token(auth.WithCredentials(acc.ID, acc.Secret))
-		if err != nil {
-			log.Fatal(err)
-		}
-
-		token = t.AccessToken
-		log.Printf("Generated token: %s\n", token)
-	}
-
-	// Create service with auth client wrapper
-	service := micro.NewService(
-		micro.Name("greeter.client"),
-		micro.WrapClient(
-			authWrapper.FromToken(token), // Add token to all requests
-		),
-	)
-
-	service.Init()
-
-	// Create greeter client
-	greeterClient := pb.NewGreeterService("greeter", service.Client())
-
-	// Test 1: Call protected endpoint (Hello) with auth
-	fmt.Println("\n=== Test 1: Protected endpoint WITH auth ===")
-	rsp, err := greeterClient.Hello(context.Background(), &pb.Request{Name: "John"})
-	if err != nil {
-		log.Printf("Error: %v", err)
-	} else {
-		fmt.Printf("Response: %s\n", rsp.Msg)
-	}
-
-	// Test 2: Call public endpoint (Health) without auth
-	fmt.Println("\n=== Test 2: Public endpoint (no auth needed) ===")
-	// Create client without auth wrapper for this test
-	plainClient := client.NewClient()
-	plainGreeterClient := pb.NewGreeterService("greeter", plainClient)
-
-	healthRsp, err := plainGreeterClient.Health(context.Background(), &pb.HealthRequest{})
-	if err != nil {
-		log.Printf("Error: %v", err)
-	} else {
-		fmt.Printf("Health Status: %s\n", healthRsp.Status)
-	}
-
-	// Test 3: Call protected endpoint WITHOUT auth (should fail)
-	fmt.Println("\n=== Test 3: Protected endpoint WITHOUT auth (should fail) ===")
-	_, err = plainGreeterClient.Hello(context.Background(), &pb.Request{Name: "John"})
-	if err != nil {
-		fmt.Printf("Expected error: %v\n", err)
-	} else {
-		fmt.Println("Unexpected: Call succeeded without auth!")
-	}
-}
@@ -1,144 +0,0 @@
-// Code generated by protoc-gen-go. DO NOT EDIT.
-// source: greeter.proto
-
-package greeter
-
-import (
-	context "context"
-	fmt "fmt"
-	client "go-micro.dev/v5/client"
-	server "go-micro.dev/v5/server"
-)
-
-// Reference imports to suppress errors if they are not otherwise used.
-var _ = fmt.Errorf
-
-type Request struct {
-	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
-}
-
-func (m *Request) Reset()         { *m = Request{} }
-func (m *Request) String() string { return fmt.Sprintf("Request{Name:%s}", m.Name) }
-func (*Request) ProtoMessage()    {}
-
-func (m *Request) GetName() string {
-	if m != nil {
-		return m.Name
-	}
-	return ""
-}
-
-type Response struct {
-	Msg string `protobuf:"bytes,1,opt,name=msg,proto3" json:"msg,omitempty"`
-}
-
-func (m *Response) Reset()         { *m = Response{} }
-func (m *Response) String() string { return fmt.Sprintf("Response{Msg:%s}", m.Msg) }
-func (*Response) ProtoMessage()    {}
-
-func (m *Response) GetMsg() string {
-	if m != nil {
-		return m.Msg
-	}
-	return ""
-}
-
-type HealthRequest struct{}
-
-func (m *HealthRequest) Reset()         { *m = HealthRequest{} }
-func (m *HealthRequest) String() string { return "HealthRequest{}" }
-func (*HealthRequest) ProtoMessage()    {}
-
-type HealthResponse struct {
-	Status string `protobuf:"bytes,1,opt,name=status,proto3" json:"status,omitempty"`
-}
-
-func (m *HealthResponse) Reset()         { *m = HealthResponse{} }
-func (m *HealthResponse) String() string { return fmt.Sprintf("HealthResponse{Status:%s}", m.Status) }
-func (*HealthResponse) ProtoMessage()    {}
-
-func (m *HealthResponse) GetStatus() string {
-	if m != nil {
-		return m.Status
-	}
-	return ""
-}
-
-func init() {
-	// Types registered
-}
-
-// Reference imports to suppress errors if they are not otherwise used.
-var _ context.Context
-var _ client.Option
-var _ server.Option
-
-// Client API for Greeter service
-
-type GreeterService interface {
-	Hello(ctx context.Context, in *Request, opts ...client.CallOption) (*Response, error)
-	Health(ctx context.Context, in *HealthRequest, opts ...client.CallOption) (*HealthResponse, error)
-}
-
-type greeterService struct {
-	c    client.Client
-	name string
-}
-
-func NewGreeterService(name string, c client.Client) GreeterService {
-	return &greeterService{
-		c:    c,
-		name: name,
-	}
-}
-
-func (c *greeterService) Hello(ctx context.Context, in *Request, opts ...client.CallOption) (*Response, error) {
-	req := c.c.NewRequest(c.name, "Greeter.Hello", in)
-	out := new(Response)
-	err := c.c.Call(ctx, req, out, opts...)
-	if err != nil {
-		return nil, err
-	}
-	return out, nil
-}
-
-func (c *greeterService) Health(ctx context.Context, in *HealthRequest, opts ...client.CallOption) (*HealthResponse, error) {
-	req := c.c.NewRequest(c.name, "Greeter.Health", in)
-	out := new(HealthResponse)
-	err := c.c.Call(ctx, req, out, opts...)
-	if err != nil {
-		return nil, err
-	}
-	return out, nil
-}
-
-// Server API for Greeter service
-
-type GreeterHandler interface {
-	Hello(context.Context, *Request, *Response) error
-	Health(context.Context, *HealthRequest, *HealthResponse) error
-}
-
-func RegisterGreeterHandler(s server.Server, hdlr GreeterHandler, opts ...server.HandlerOption) error {
-	type greeter interface {
-		Hello(ctx context.Context, in *Request, out *Response) error
-		Health(ctx context.Context, in *HealthRequest, out *HealthResponse) error
-	}
-	type Greeter struct {
-		greeter
-	}
-	h := &greeterHandler{hdlr}
-	return s.Handle(s.NewHandler(&Greeter{h}, opts...))
-}
-
-type greeterHandler struct {
-	GreeterHandler
-}
-
-func (h *greeterHandler) Hello(ctx context.Context, in *Request, out *Response) error {
-	return h.GreeterHandler.Hello(ctx, in, out)
-}
-
-func (h *greeterHandler) Health(ctx context.Context, in *HealthRequest, out *HealthResponse) error {
-	return h.GreeterHandler.Health(ctx, in, out)
-}
@@ -1,24 +0,0 @@
-syntax = "proto3";
-
-package greeter;
-
-option go_package = "go-micro.dev/v5/examples/auth/proto;greeter";
-
-service Greeter {
-	rpc Hello(Request) returns (Response) {}
-	rpc Health(HealthRequest) returns (HealthResponse) {}
-}
-
-message Request {
-	string name = 1;
-}
-
-message Response {
-	string msg = 1;
-}
-
-message HealthRequest {}
-
-message HealthResponse {
-	string status = 1;
-}
@@ -1,96 +0,0 @@
-package main
-
-import (
-	"context"
-	"log"
-
-	"go-micro.dev/v5"
-	"go-micro.dev/v5/auth"
-	"go-micro.dev/v5/auth/noop"
-	authWrapper "go-micro.dev/v5/wrapper/auth"
-
-	pb "go-micro.dev/v5/examples/auth/proto"
-)
-
-// Greeter implements the Greeter service
-type Greeter struct{}
-
-// Hello is a protected endpoint that requires authentication
-func (g *Greeter) Hello(ctx context.Context, req *pb.Request, rsp *pb.Response) error {
-	// Get account from context (added by auth wrapper)
-	acc, ok := auth.AccountFromContext(ctx)
-	if !ok {
-		rsp.Msg = "Hello, anonymous!"
-		return nil
-	}
-
-	rsp.Msg = "Hello, " + acc.ID + "!"
-	return nil
-}
-
-// Health is a public endpoint that doesn't require auth
-func (g *Greeter) Health(ctx context.Context, req *pb.HealthRequest, rsp *pb.HealthResponse) error {
-	rsp.Status = "ok"
-	return nil
-}
-
-func main() {
-	// Create auth provider (noop for this example)
-	// In production, use JWT or custom auth provider
-	authProvider := noop.NewAuth()
-
-	// Create authorization rules
-	rules := auth.NewRules()
-
-	// Grant public access to health endpoint
-	rules.Grant(&auth.Rule{
-		ID:       "public-health",
-		Scope:    "",
-		Resource: &auth.Resource{Type: "service", Name: "*", Endpoint: "Greeter.Health"},
-		Access:   auth.AccessGranted,
-		Priority: 100,
-	})
-
-	// Require authentication for other endpoints
-	rules.Grant(&auth.Rule{
-		ID:       "authenticated-hello",
-		Scope:    "*",
-		Resource: &auth.Resource{Type: "service", Name: "*", Endpoint: "*"},
-		Access:   auth.AccessGranted,
-		Priority: 50,
-	})
-
-	// Create service with auth wrapper
-	service := micro.NewService(
-		micro.Name("greeter"),
-		micro.Version("latest"),
-		micro.WrapHandler(
-			authWrapper.AuthHandler(authWrapper.HandlerOptions{
-				Auth:          authProvider,
-				Rules:         rules,
-				SkipEndpoints: []string{"Greeter.Health"}, // Public endpoints
-			}),
-		),
-	)
-
-	service.Init()
-
-	// Register handler
-	if err := pb.RegisterGreeterHandler(service.Server(), &Greeter{}); err != nil {
-		log.Fatal(err)
-	}
-
-	// Generate a test token for demonstration
-	if acc, err := authProvider.Generate("test-user"); err == nil {
-		if token, err := authProvider.Token(auth.WithCredentials(acc.ID, acc.Secret)); err == nil {
-			log.Printf("\n=== Test Token Generated ===")
-			log.Printf("Use this token to test the client:")
-			log.Printf("TOKEN=%s go run client/main.go\n", token.AccessToken)
-		}
-	}
-
-	// Run service
-	if err := service.Run(); err != nil {
-		log.Fatal(err)
-	}
-}
@@ -1,62 +0,0 @@
-# Hello World Example
-
-The simplest go-micro service demonstrating core concepts.
-
-## What It Does
-
-This example creates a basic RPC service that:
- Listens on port 8080
- Exposes a `Greeter.Hello` method
- Returns a greeting message
- Demonstrates both programmatic and HTTP access
-
-## Run It
-
-```bash
-go run main.go
-```
-
-The service will start and make test calls to itself, then wait for incoming requests.
-
-## Test It
-
-### Using curl
-
-```bash
-curl -X POST http://localhost:8080 \
-  -H 'Content-Type: application/json' \
-  -H 'Micro-Endpoint: Greeter.Hello' \
-  -d '{"name": "Alice"}'
-```
-
-Expected response:
-```json
-{"message": "Hello Alice"}
-```
-
-### Using the micro CLI
-
-```bash
-micro call greeter Greeter.Hello '{"name": "Bob"}'
-```
-
-## Code Walkthrough
-
-1. **Define types** - Request and Response structures
-2. **Implement handler** - The `Greeter` service with `Hello` method
-3. **Create service** - Using `micro.New()` with options
-4. **Register handler** - Link the handler to the service
-5. **Run service** - Start listening for requests
-
-## Key Concepts
-
- **RPC Pattern**: Method signature `func(ctx, req, rsp) error`
- **Service Discovery**: Automatic registration
- **Multiple Transports**: Works over HTTP, gRPC, etc.
- **Type Safety**: Strongly typed requests/responses
-
-## Next Steps
-
- See [pubsub-events](../pubsub-events/) for event-driven patterns
- See [production-ready](../production-ready/) for a complete example
- Read the [Getting Started Guide](../../internal/website/docs/getting-started.md)
@@ -1,90 +0,0 @@
-package main
-
-import (
-	"context"
-	"fmt"
-	"log"
-
-	"go-micro.dev/v5"
-	"go-micro.dev/v5/client"
-)
-
-// Request and Response types
-type Request struct {
-	Name string `json:"name"`
-}
-
-type Response struct {
-	Message string `json:"message"`
-}
-
-// Greeter service handler
-type Greeter struct{}
-
-// Hello is the RPC method handler
-func (g *Greeter) Hello(ctx context.Context, req *Request, rsp *Response) error {
-	rsp.Message = "Hello " + req.Name
-	log.Printf("Received request: %s", req.Name)
-	return nil
-}
-
-func main() {
-	// Create a new service
-	service := micro.New(
-		micro.Name("greeter"),
-		micro.Version("latest"),
-		micro.Address(":8080"),
-	)
-
-	// Initialize the service
-	service.Init()
-
-	// Register the handler
-	if err := service.Handle(new(Greeter)); err != nil {
-		log.Fatal(err)
-	}
-
-	// Run the service in a goroutine
-	go func() {
-		if err := service.Run(); err != nil {
-			log.Fatal(err)
-		}
-	}()
-
-	// Wait for service to start
-	fmt.Println("Service started on :8080")
-	fmt.Println("Testing the service...")
-
-	// Create a client to test the service
-	c := service.Client()
-
-	// Make a request
-	req := c.NewRequest("greeter", "Greeter.Hello", &Request{Name: "World"})
-	rsp := &Response{}
-
-	if err := c.Call(context.Background(), req, rsp); err != nil {
-		log.Printf("Error calling service: %v", err)
-	} else {
-		fmt.Printf("Response: %s\n", rsp.Message)
-	}
-
-	// Make another request
-	req2 := c.NewRequest("greeter", "Greeter.Hello", &Request{Name: "Go Micro"})
-	rsp2 := &Response{}
-
-	if err := c.Call(context.Background(), req2, rsp2); err != nil {
-		log.Printf("Error calling service: %v", err)
-	} else {
-		fmt.Printf("Response: %s\n", rsp2.Message)
-	}
-
-	// Test with HTTP client
-	fmt.Println("\nYou can also test with curl:")
-	fmt.Println("curl -X POST http://localhost:8080 \\")
-	fmt.Println("  -H 'Content-Type: application/json' \\")
-	fmt.Println("  -H 'Micro-Endpoint: Greeter.Hello' \\")
-	fmt.Println("  -d '{\"name\": \"Alice\"}'")
-
-	// Keep service running
-	select {}
-}
@@ -1,198 +0,0 @@
-# MCP Examples
-
-Examples demonstrating Model Context Protocol (MCP) integration with go-micro.
-
-## Examples
-
-### [hello](./hello/) - Minimal Example ⭐ Start Here
-
-The simplest possible MCP-enabled service. Perfect for learning the basics.
-
-**What it shows:**
- Automatic documentation extraction from Go comments
- MCP gateway setup with 3 lines
- Ready for Claude Code
-
-**Run it:**
-```bash
-cd hello
-go run main.go
-```
-
-### [documented](./documented/) - Full-Featured Example
-
-Complete example showing all MCP features with a user service.
-
-**What it shows:**
- Multiple endpoints (GetUser, CreateUser)
- Rich documentation with examples
- Per-endpoint auth scopes via `server.WithEndpointScopes()`
- Pre-populated test data
- Production-ready patterns
-
-**Run it:**
-```bash
-cd documented
-go run main.go
-```
-
-## Quick Start
-
-### 1. Write Your Service
-
-Add Go doc comments to your handler methods:
-
-```go
-// SayHello greets a person by name. Returns a friendly greeting message.
-//
-// @example {"name": "Alice"}
-func (g *Greeter) SayHello(ctx context.Context, req *HelloRequest, rsp *HelloResponse) error {
-    rsp.Message = "Hello " + req.Name + "!"
-    return nil
-}
-
-type HelloRequest struct {
-    Name string `json:"name" description:"Person's name to greet"`
-}
-```
-
-### 2. Register Handler (Auto-Extracts Docs!)
-
-```go
-handler := service.Server().NewHandler(new(Greeter))
-service.Server().Handle(handler)
-```
-
-### 3. Start MCP Gateway
-
-```go
-go mcp.ListenAndServe(":3000", mcp.Options{
-    Registry: service.Options().Registry,
-})
-```
-
-## Testing
-
-### HTTP API
-
-```bash
-# List tools
-curl http://localhost:3000/mcp/tools | jq
-
-# Call a tool
-curl -X POST http://localhost:3000/mcp/call \
-  -H "Content-Type: application/json" \
-  -d '{
-    "tool": "greeter.Greeter.SayHello",
-    "input": {"name": "Alice"}
-  }' | jq
-```
-
-### Claude Code (Stdio)
-
-Start MCP server:
-```bash
-micro mcp serve
-```
-
-Add to `~/.claude/claude_desktop_config.json`:
-```json
-{
-  "mcpServers": {
-    "my-services": {
-      "command": "micro",
-      "args": ["mcp", "serve"]
-    }
-  }
-}
-```
-
-Restart Claude Code and ask Claude to use your services!
-
-## Features
-
-### ✅ Automatic Documentation Extraction
-
-Just write Go comments - documentation is extracted automatically:
-
- **Go doc comments** → Tool descriptions
- **@example tags** → Example inputs for AI
- **Struct tags** → Parameter descriptions
-
-### ✅ Multiple Transports
-
- **Stdio** - For Claude Code (recommended)
- **HTTP/SSE** - For web-based agents
-
-### ✅ MCP Command Line
-
-```bash
-micro mcp serve              # Start with stdio
-micro mcp serve --address :3000  # Start with HTTP
-micro mcp list               # List tools
-micro mcp test <tool-name>   # Test a tool
-```
-
-### ✅ Zero Configuration
-
- No manual tool registration
- No API wrappers
- No code generation
- Just write normal Go code!
-
-### ✅ Per-Tool Auth Scopes
-
-Declare required scopes when registering a handler:
-
-```go
-handler := service.Server().NewHandler(
-    new(BlogService),
-    server.WithEndpointScopes("Blog.Create", "blog:write"),
-    server.WithEndpointScopes("Blog.Delete", "blog:admin"),
-)
-```
-
-Or define scopes at the gateway layer without changing services:
-
-```go
-mcp.Serve(mcp.Options{
-    Registry: reg,
-    Auth:     authProvider,
-    Scopes: map[string][]string{
-        "blog.Blog.Create": {"blog:write"},
-        "blog.Blog.Delete": {"blog:admin"},
-    },
-})
-```
-
-### ✅ Tracing, Rate Limiting & Audit Logging
-
-Every tool call generates a trace ID that propagates through the RPC chain.
-Configure rate limiting and audit logging at the gateway:
-
-```go
-mcp.Serve(mcp.Options{
-    Registry: reg,
-    Auth:     authProvider,
-    RateLimit: &mcp.RateLimitConfig{
-        RequestsPerSecond: 10,
-        Burst:             20,
-    },
-    AuditFunc: func(r mcp.AuditRecord) {
-        log.Printf("[audit] trace=%s tool=%s account=%s allowed=%v",
-            r.TraceID, r.Tool, r.AccountID, r.Allowed)
-    },
-})
-```
-
-## Documentation
-
- [Full MCP Documentation](../../internal/website/docs/mcp.md)
- [MCP Gateway Implementation](../../gateway/mcp/)
- [Documentation Guide](../../gateway/mcp/DOCUMENTATION.md)
- [Blog Post](../../internal/website/blog/2.md)
-
-## Learn More
-
- [Model Context Protocol Spec](https://modelcontextprotocol.io/)
- [Go Micro Documentation](https://go-micro.dev)
@@ -1,306 +0,0 @@
-# Documented Service Example
-
-This example demonstrates how to document your go-micro service handlers so that AI agents can understand them better. The MCP gateway parses Go comments and struct tags to generate rich tool descriptions.
-
-## Documentation Features
-
-### 1. **Go Doc Comments**
-
-Standard Go documentation comments are used as the tool description:
-
-```go
-// GetUser retrieves a user by ID from the database.
-//
-// This endpoint fetches a user's complete profile including their name,
-// email, and age. If the user doesn't exist, an error is returned.
-func (u *Users) GetUser(ctx context.Context, req *GetUserRequest, rsp *GetUserResponse) error {
-    // ...
-}
-```
-
-### 2. **JSDoc-Style Tags**
-
-Use `@param`, `@return`, and `@example` tags for detailed documentation:
-
-```go
-// CreateUser creates a new user in the system.
-//
-// @param name {string} User's full name (required, 1-100 characters)
-// @param email {string} User's email address (required, must be valid email format)
-// @param age {number} User's age (optional, must be 0-150 if provided)
-// @return {User} The newly created user with generated ID
-// @example
-//   {
-//     "name": "Alice Smith",
-//     "email": "alice@example.com",
-//     "age": 30
-//   }
-func (u *Users) CreateUser(ctx context.Context, req *CreateUserRequest, rsp *CreateUserResponse) error {
-    // ...
-}
-```
-
-### 3. **Struct Tags**
-
-Add `description` tags to struct fields for better schema:
-
-```go
-type User struct {
-    ID    string `json:"id" description:"User's unique identifier (UUID format)"`
-    Name  string `json:"name" description:"User's full name"`
-    Email string `json:"email" description:"User's email address"`
-    Age   int    `json:"age,omitempty" description:"User's age (optional)"`
-}
-```
-
-## Running the Example
-
-### 1. Start the Service
-
-```bash
-cd examples/mcp/documented
-go run main.go
-```
-
-Output:
-```
-Users service starting...
-Service: users
-Endpoints:
-  - Users.GetUser
-  - Users.CreateUser
-MCP Gateway: http://localhost:3000
-```
-
-### 2. Test MCP Tools
-
-List available tools:
-```bash
-curl http://localhost:3000/mcp/tools | jq
-```
-
-You'll see rich descriptions:
-
-```json
-{
-  "tools": [
-    {
-      "name": "users.Users.GetUser",
-      "description": "GetUser retrieves a user by ID from the database",
-      "inputSchema": {
-        "type": "object",
-        "properties": {
-          "id": {
-            "type": "string",
-            "description": "User ID in UUID format (e.g., \"123e4567-e89b-12d3-a456-426614174000\")"
-          }
-        },
-        "required": ["id"],
-        "examples": [
-          "{\"id\": \"123e4567-e89b-12d3-a456-426614174000\"}"
-        ]
-      }
-    },
-    {
-      "name": "users.Users.CreateUser",
-      "description": "CreateUser creates a new user in the system",
-      "inputSchema": {
-        "type": "object",
-        "properties": {
-          "name": {
-            "type": "string",
-            "description": "User's full name (required, 1-100 characters)"
-          },
-          "email": {
-            "type": "string",
-            "description": "User's email address (required, must be valid email format)"
-          },
-          "age": {
-            "type": "number",
-            "description": "User's age (optional, must be 0-150 if provided)"
-          }
-        },
-        "required": ["name", "email"],
-        "examples": [
-          "{\"name\": \"Alice Smith\", \"email\": \"alice@example.com\", \"age\": 30}"
-        ]
-      }
-    }
-  ]
-}
-```
-
-### 3. Call a Tool
-
-Get existing user:
-```bash
-curl -X POST http://localhost:3000/mcp/call \
-  -H "Content-Type: application/json" \
-  -d '{
-    "tool": "users.Users.GetUser",
-    "input": {"id": "user-1"}
-  }'
-```
-
-Create new user:
-```bash
-curl -X POST http://localhost:3000/mcp/call \
-  -H "Content-Type: application/json" \
-  -d '{
-    "tool": "users.Users.CreateUser",
-    "input": {
-      "name": "Alice Smith",
-      "email": "alice@example.com",
-      "age": 30
-    }
-  }'
-```
-
-### 4. Use with Claude Code
-
-Add to your `claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "users-service": {
-      "command": "go",
-      "args": ["run", "/path/to/examples/mcp/documented/main.go"]
-    }
-  }
-}
-```
-
-Then in Claude Code, ask:
-```
-> You: "Show me user-1's profile"
-
-Claude will:
-1. See the GetUser tool with rich description
-2. Understand it needs an "id" parameter (UUID format)
-3. Call users.Users.GetUser with {"id": "user-1"}
-4. Return the user profile
-```
-
-## Documentation Best Practices
-
-### DO: Write Clear Descriptions
-
-```go
-// ✅ Good: Clear, explains what and why
-// GetUser retrieves a user by ID from the database.
-// Returns full profile including email, name, and preferences.
-```
-
-```go
-// ❌ Bad: Vague, no context
-// Get gets a user
-```
-
-### DO: Specify Parameter Constraints
-
-```go
-// ✅ Good: Specifies format and constraints
-// @param id {string} User ID in UUID format (e.g., "123e4567-e89b-12d3-a456-426614174000")
-// @param age {number} User's age (must be 0-150)
-```
-
-```go
-// ❌ Bad: No constraints or format
-// @param id {string} The ID
-```
-
-### DO: Provide Examples
-
-```go
-// ✅ Good: Real example agents can use
-// @example
-//   {
-//     "name": "Alice Smith",
-//     "email": "alice@example.com",
-//     "age": 30
-//   }
-```
-
-```go
-// ❌ Bad: No example
-// (agents have to guess the format)
-```
-
-### DO: Use Descriptive Struct Tags
-
-```go
-// ✅ Good: Explains what the field is
-type User struct {
-    ID string `json:"id" description:"User's unique identifier (UUID format)"`
-}
-```
-
-```go
-// ❌ Bad: No description
-type User struct {
-    ID string `json:"id"`
-}
-```
-
-## How It Works
-
-1. **Go Doc Parsing**
-   - The MCP gateway reads your service's Go comments
-   - First line becomes the tool description
-   - Full comment becomes the detailed description
-
-2. **JSDoc Tag Parsing**
-   - `@param` tags enhance parameter descriptions
-   - `@return` tags describe what the tool returns
-   - `@example` tags provide usage examples
-
-3. **Struct Tag Reading**
-   - `description` tags add context to fields
-   - `json:"field,omitempty"` marks optional fields
-   - Used to generate JSON Schema for parameters
-
-4. **Schema Generation**
-   - Combines parsed documentation with type information
-   - Creates rich JSON Schema for each tool
-   - Agents use this to understand how to call your service
-
-## Impact on Agent Performance
-
-### Without Documentation
-
-```
-Tool: users.Users.GetUser
-Description: Call GetUser on users service
-Parameters: { "id": "string" }
-```
-
-Agent thinks: *"What's an ID? What format? What if I pass the wrong thing?"*
-
-### With Documentation
-
-```
-Tool: users.Users.GetUser
-Description: Retrieves a user by ID from the database. Returns full profile
-             including email, name, and preferences.
-Parameters:
-  - id (string, required): User ID in UUID format
-    Example: "123e4567-e89b-12d3-a456-426614174000"
-Example:
-  {"id": "user-1"}
-```
-
-Agent thinks: *"I need a UUID format ID. I can use 'user-1' from the example!"*
-
-**Result:** Agent calls your service correctly on the first try!
-
-## Next Steps
-
- Document all your service handlers with clear descriptions
- Add `@param`, `@return`, and `@example` tags
- Use `description` tags in struct fields
- Test with Claude Code to see how agents understand your services
-
-## License
-
-Apache 2.0
@@ -1,160 +0,0 @@
-// Package main demonstrates how to document your service handlers for better
-// AI agent integration using endpoint metadata.
-//
-// Services register descriptions with their endpoints, and the MCP gateway
-// reads these descriptions from the registry to generate rich tool descriptions.
-package main
-
-import (
-	"context"
-	"fmt"
-	"log"
-
-	"go-micro.dev/v5"
-	"go-micro.dev/v5/gateway/mcp"
-	"go-micro.dev/v5/server"
-)
-
-// User represents a user in the system
-type User struct {
-	ID    string `json:"id" description:"User's unique identifier (UUID format)"`
-	Name  string `json:"name" description:"User's full name"`
-	Email string `json:"email" description:"User's email address"`
-	Age   int    `json:"age,omitempty" description:"User's age (optional)"`
-}
-
-// GetUserRequest is the request for getting a user
-type GetUserRequest struct {
-	ID string `json:"id" description:"User ID to retrieve"`
-}
-
-// GetUserResponse is the response containing user data
-type GetUserResponse struct {
-	User *User `json:"user" description:"The requested user object"`
-}
-
-// CreateUserRequest is the request for creating a user
-type CreateUserRequest struct {
-	Name  string `json:"name" description:"User's full name (required)"`
-	Email string `json:"email" description:"User's email address (required)"`
-	Age   int    `json:"age,omitempty" description:"User's age (optional)"`
-}
-
-// CreateUserResponse contains the newly created user
-type CreateUserResponse struct {
-	User *User `json:"user" description:"The newly created user"`
-}
-
-// Users service handles user-related operations
-type Users struct {
-	users map[string]*User
-}
-
-// GetUser retrieves a user by ID from the database. Returns full profile including email, name, and preferences. If the user doesn't exist, an error is returned.
-//
-// @example {"id": "user-1"}
-func (u *Users) GetUser(ctx context.Context, req *GetUserRequest, rsp *GetUserResponse) error {
-	user, exists := u.users[req.ID]
-	if !exists {
-		return fmt.Errorf("user not found: %s", req.ID)
-	}
-
-	rsp.User = user
-	return nil
-}
-
-// CreateUser creates a new user in the system. Validates the user data and creates a new profile. Name and email are required fields, while age is optional. Email must be unique across all users.
-//
-// @example {"name": "Alice Smith", "email": "alice@example.com", "age": 30}
-func (u *Users) CreateUser(ctx context.Context, req *CreateUserRequest, rsp *CreateUserResponse) error {
-	// Validate input
-	if req.Name == "" || req.Email == "" {
-		return fmt.Errorf("name and email are required")
-	}
-
-	// Generate ID (simplified for example)
-	id := fmt.Sprintf("user-%d", len(u.users)+1)
-
-	user := &User{
-		ID:    id,
-		Name:  req.Name,
-		Email: req.Email,
-		Age:   req.Age,
-	}
-
-	u.users[id] = user
-	rsp.User = user
-
-	return nil
-}
-
-func main() {
-	// Create service
-	service := micro.NewService(
-		micro.Name("users"),
-		micro.Version("1.0.0"),
-	)
-
-	service.Init()
-
-	// Register handler with pre-populated test data
-	usersService := &Users{
-		users: map[string]*User{
-			"user-1": {
-				ID:    "user-1",
-				Name:  "John Doe",
-				Email: "john@example.com",
-				Age:   25,
-			},
-			"user-2": {
-				ID:    "user-2",
-				Name:  "Jane Smith",
-				Email: "jane@example.com",
-				Age:   30,
-			},
-		},
-	}
-
-	// Register handler - documentation is automatically extracted from method comments.
-	// Use WithEndpointScopes to declare required auth scopes per endpoint.
-	handler := service.Server().NewHandler(
-		usersService,
-		server.WithEndpointScopes("Users.GetUser", "users:read"),
-		server.WithEndpointScopes("Users.CreateUser", "users:write"),
-	)
-
-	if err := service.Server().Handle(handler); err != nil {
-		log.Fatal(err)
-	}
-
-	// Start MCP gateway on port 3000
-	go func() {
-		log.Println("Starting MCP gateway on :3000")
-		if err := mcp.ListenAndServe(":3000", mcp.Options{
-			Registry: service.Options().Registry,
-		}); err != nil {
-			log.Printf("MCP gateway error: %v", err)
-		}
-	}()
-
-	log.Println("Users service starting...")
-	log.Println("Service: users")
-	log.Println("Endpoints:")
-	log.Println("  - Users.GetUser")
-	log.Println("  - Users.CreateUser")
-	log.Println("MCP Gateway: http://localhost:3000")
-	log.Println("")
-	log.Println("Test with:")
-	log.Println("  curl http://localhost:3000/mcp/tools")
-	log.Println("")
-	log.Println("Or add to Claude Code:")
-	log.Println(`  "users-service": {`)
-	log.Println(`    "command": "micro",`)
-	log.Println(`    "args": ["mcp", "serve"]`)
-	log.Println(`  }`)
-
-	// Run service
-	if err := service.Run(); err != nil {
-		log.Fatal(err)
-	}
-}
@@ -1,131 +0,0 @@
-# MCP Hello World Example
-
-The simplest possible MCP-enabled go-micro service.
-
-## What This Shows
-
- ✅ Automatic documentation extraction from Go comments
- ✅ MCP gateway setup with 3 lines of code
- ✅ Ready for Claude Code integration
- ✅ HTTP endpoint for testing
-
-## Run It
-
-```bash
-cd examples/mcp/hello
-go run main.go
-```
-
-## Test It
-
-### Option 1: HTTP API
-
-```bash
-# List available tools
-curl http://localhost:3000/mcp/tools | jq
-
-# Call the SayHello tool
-curl -X POST http://localhost:3000/mcp/call \
-  -H "Content-Type: application/json" \
-  -d '{
-    "tool": "greeter.Greeter.SayHello",
-    "input": {"name": "Alice"}
-  }' | jq
-```
-
-### Option 2: Claude Code
-
-In a separate terminal:
-
-```bash
-micro mcp serve
-```
-
-Add to `~/.claude/claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "greeter": {
-      "command": "micro",
-      "args": ["mcp", "serve"]
-    }
-  }
-}
-```
-
-Restart Claude Code and ask:
-
-> "Say hello to Bob using the greeter service"
-
-## How It Works
-
-### 1. Write Normal Go Code
-
-```go
-// SayHello greets a person by name. Returns a friendly greeting message.
-//
-// @example {"name": "Alice"}
-func (g *Greeter) SayHello(ctx context.Context, req *HelloRequest, rsp *HelloResponse) error {
-    rsp.Message = "Hello " + req.Name + "!"
-    return nil
-}
-```
-
-### 2. Register the Handler
-
-```go
-// Documentation is extracted automatically!
-handler := service.Server().NewHandler(new(Greeter))
-service.Server().Handle(handler)
-```
-
-### 3. Start MCP Gateway
-
-```go
-go mcp.ListenAndServe(":3000", mcp.Options{
-    Registry: service.Options().Registry,
-})
-```
-
-**That's it!** Your service is now AI-accessible.
-
-## What Gets Extracted
-
-From this code:
-
-```go
-// SayHello greets a person by name. Returns a friendly greeting message.
-//
-// @example {"name": "Alice"}
-func (g *Greeter) SayHello(...)
-
-type HelloRequest struct {
-    Name string `json:"name" description:"Person's name to greet"`
-}
-```
-
-Claude sees:
-
-```json
-{
-  "name": "greeter.Greeter.SayHello",
-  "description": "SayHello greets a person by name. Returns a friendly greeting message.",
-  "inputSchema": {
-    "type": "object",
-    "properties": {
-      "name": {
-        "type": "string",
-        "description": "Person's name to greet"
-      }
-    },
-    "examples": ["{\"name\": \"Alice\"}"]
-  }
-}
-```
-
-## Next Steps
-
- See `examples/mcp/documented` for a more complete example with multiple endpoints
- Read `/docs/mcp.md` for full documentation
- Check out the [MCP specification](https://modelcontextprotocol.io/)
@@ -1,78 +0,0 @@
-// Package main demonstrates a minimal MCP-enabled service.
-//
-// This is the simplest possible example showing:
-// - Automatic documentation extraction from Go comments
-// - MCP gateway setup
-// - Ready for use with Claude Code
-package main
-
-import (
-	"context"
-	"log"
-
-	"go-micro.dev/v5"
-	"go-micro.dev/v5/gateway/mcp"
-)
-
-// Greeter service handles greeting operations
-type Greeter struct{}
-
-// SayHello greets a person by name. Returns a friendly greeting message.
-//
-// @example {"name": "Alice"}
-func (g *Greeter) SayHello(ctx context.Context, req *HelloRequest, rsp *HelloResponse) error {
-	rsp.Message = "Hello " + req.Name + "!"
-	return nil
-}
-
-// HelloRequest contains the greeting parameters
-type HelloRequest struct {
-	Name string `json:"name" description:"Person's name to greet"`
-}
-
-// HelloResponse contains the greeting result
-type HelloResponse struct {
-	Message string `json:"message" description:"The greeting message"`
-}
-
-func main() {
-	// Create service
-	service := micro.NewService(
-		micro.Name("greeter"),
-		micro.Version("1.0.0"),
-	)
-
-	service.Init()
-
-	// Register handler - documentation extracted automatically from comments!
-	handler := service.Server().NewHandler(new(Greeter))
-	if err := service.Server().Handle(handler); err != nil {
-		log.Fatal(err)
-	}
-
-	// Start MCP gateway on port 3000
-	go func() {
-		log.Println("Starting MCP gateway on :3000")
-		if err := mcp.ListenAndServe(":3000", mcp.Options{
-			Registry: service.Options().Registry,
-		}); err != nil {
-			log.Printf("MCP gateway error: %v", err)
-		}
-	}()
-
-	log.Println("Greeter service starting...")
-	log.Println("Service: greeter")
-	log.Println("Endpoint: Greeter.SayHello")
-	log.Println("MCP Gateway: http://localhost:3000")
-	log.Println("")
-	log.Println("Test with:")
-	log.Println("  curl http://localhost:3000/mcp/tools")
-	log.Println("")
-	log.Println("Or use with Claude Code:")
-	log.Println("  micro mcp serve")
-
-	// Run service
-	if err := service.Run(); err != nil {
-		log.Fatal(err)
-	}
-}
@@ -1,59 +0,0 @@
-# Web Service Example
-
-HTTP web service with automatic service discovery and registration.
-
-## What It Does
-
-This example creates an HTTP service that:
- Serves RESTful API endpoints
- Registers with service discovery
- Provides health checks
- Uses standard Go HTTP handlers
-
-## Run It
-
-```bash
-go run main.go
-```
-
-## Test It
-
-```bash
-# Get service info
-curl http://localhost:9090/
-
-# List all users
-curl http://localhost:9090/users
-
-# Get specific user
-curl http://localhost:9090/users/1
-
-# Health check
-curl http://localhost:9090/health
-```
-
-## Key Features
-
- **Standard HTTP**: Use familiar `http.Handler` interface
- **Service Discovery**: Automatically registers with registry
- **Health Checks**: Built-in health endpoint
- **JSON APIs**: Easy REST API development
-
-## When to Use
-
-Use `web.Service` when:
- Building REST APIs
- Serving web UIs
- Working with HTTP-specific features
- Migrating existing HTTP services
-
-Use regular `micro.Service` when:
- Building RPC services
- Need bidirectional streaming
- Want automatic load balancing
- Prefer structured RPC over HTTP
-
-## Next Steps
-
- See [hello-world](../hello-world/) for RPC services
- See [production-ready](../production-ready/) for observability
@@ -1,70 +0,0 @@
-module example
-
-go 1.24
-
-require go-micro.dev/v5 v5.16.0
-
-require (
-	dario.cat/mergo v1.0.2 // indirect
-	github.com/armon/go-metrics v0.4.1 // indirect
-	github.com/bitly/go-simplejson v0.5.0 // indirect
-	github.com/cespare/xxhash/v2 v2.3.0 // indirect
-	github.com/coreos/go-semver v0.3.0 // indirect
-	github.com/coreos/go-systemd/v22 v22.3.2 // indirect
-	github.com/cornelk/hashmap v1.0.8 // indirect
-	github.com/cpuguy83/go-md2man/v2 v2.0.5 // indirect
-	github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f // indirect
-	github.com/fatih/color v1.16.0 // indirect
-	github.com/fsnotify/fsnotify v1.6.0 // indirect
-	github.com/go-redis/redis/v8 v8.11.5 // indirect
-	github.com/gogo/protobuf v1.3.2 // indirect
-	github.com/golang/protobuf v1.5.4 // indirect
-	github.com/google/uuid v1.6.0 // indirect
-	github.com/hashicorp/consul/api v1.32.1 // indirect
-	github.com/hashicorp/errwrap v1.1.0 // indirect
-	github.com/hashicorp/go-cleanhttp v0.5.2 // indirect
-	github.com/hashicorp/go-hclog v1.5.0 // indirect
-	github.com/hashicorp/go-immutable-radix v1.3.1 // indirect
-	github.com/hashicorp/go-multierror v1.1.1 // indirect
-	github.com/hashicorp/go-rootcerts v1.0.2 // indirect
-	github.com/hashicorp/golang-lru v1.0.2 // indirect
-	github.com/hashicorp/serf v0.10.1 // indirect
-	github.com/klauspost/compress v1.18.0 // indirect
-	github.com/lib/pq v1.10.9 // indirect
-	github.com/mattn/go-colorable v0.1.13 // indirect
-	github.com/mattn/go-isatty v0.0.20 // indirect
-	github.com/miekg/dns v1.1.50 // indirect
-	github.com/mitchellh/go-homedir v1.1.0 // indirect
-	github.com/mitchellh/hashstructure v1.1.0 // indirect
-	github.com/mitchellh/mapstructure v1.5.0 // indirect
-	github.com/nats-io/nats.go v1.42.0 // indirect
-	github.com/nats-io/nkeys v0.4.11 // indirect
-	github.com/nats-io/nuid v1.0.1 // indirect
-	github.com/oxtoacart/bpool v0.0.0-20190530202638-03653db5a59c // indirect
-	github.com/patrickmn/go-cache v2.1.0+incompatible // indirect
-	github.com/pkg/errors v0.9.1 // indirect
-	github.com/rabbitmq/amqp091-go v1.10.0 // indirect
-	github.com/russross/blackfriday/v2 v2.1.0 // indirect
-	github.com/urfave/cli/v2 v2.27.6 // indirect
-	github.com/xrash/smetrics v0.0.0-20240521201337-686a1a2994c1 // indirect
-	go.etcd.io/bbolt v1.4.0 // indirect
-	go.etcd.io/etcd/api/v3 v3.5.21 // indirect
-	go.etcd.io/etcd/client/pkg/v3 v3.5.21 // indirect
-	go.etcd.io/etcd/client/v3 v3.5.21 // indirect
-	go.uber.org/multierr v1.10.0 // indirect
-	go.uber.org/zap v1.27.0 // indirect
-	golang.org/x/crypto v0.37.0 // indirect
-	golang.org/x/exp v0.0.0-20250305212735-054e65f0b394 // indirect
-	golang.org/x/mod v0.24.0 // indirect
-	golang.org/x/net v0.38.0 // indirect
-	golang.org/x/sync v0.13.0 // indirect
-	golang.org/x/sys v0.32.0 // indirect
-	golang.org/x/text v0.24.0 // indirect
-	golang.org/x/tools v0.31.0 // indirect
-	google.golang.org/genproto/googleapis/api v0.0.0-20250324211829-b45e905df463 // indirect
-	google.golang.org/genproto/googleapis/rpc v0.0.0-20250324211829-b45e905df463 // indirect
-	google.golang.org/grpc v1.71.1 // indirect
-	google.golang.org/protobuf v1.36.6 // indirect
-)
-
-replace go-micro.dev/v5 => ../..
@@ -1,385 +0,0 @@
-dario.cat/mergo v1.0.2 h1:85+piFYR1tMbRrLcDwR18y4UKJ3aH1Tbzi24VRW1TK8=
-dario.cat/mergo v1.0.2/go.mod h1:E/hbnu0NxMFBjpMIE34DRGLWqDy0g5FuKDhCb31ngxA=
-filippo.io/edwards25519 v1.1.0 h1:FNf4tywRC1HmFuKW5xopWpigGjJKiJSV0Cqo0cJWDaA=
-filippo.io/edwards25519 v1.1.0/go.mod h1:BxyFTGdWcka3PhytdK4V28tE5sGfRvvvRV7EaN4VDT4=
-github.com/DataDog/datadog-go v3.2.0+incompatible/go.mod h1:LButxg5PwREeZtORoXG3tL4fMGNddJ+vMq1mwgfaqoQ=
-github.com/alecthomas/template v0.0.0-20160405071501-a0175ee3bccc/go.mod h1:LOuyumcjzFXgccqObfd/Ljyb9UuFJ6TxHnclSeseNhc=
-github.com/alecthomas/template v0.0.0-20190718012654-fb15b899a751/go.mod h1:LOuyumcjzFXgccqObfd/Ljyb9UuFJ6TxHnclSeseNhc=
-github.com/alecthomas/units v0.0.0-20151022065526-2efee857e7cf/go.mod h1:ybxpYRFXyAe+OPACYpWeL0wqObRcbAqCMya13uyzqw0=
-github.com/alecthomas/units v0.0.0-20190717042225-c3de453c63f4/go.mod h1:ybxpYRFXyAe+OPACYpWeL0wqObRcbAqCMya13uyzqw0=
-github.com/armon/circbuf v0.0.0-20150827004946-bbbad097214e/go.mod h1:3U/XgcO3hCbHZ8TKRvWD2dDTCfh9M9ya+I9JpbB7O8o=
-github.com/armon/go-metrics v0.0.0-20180917152333-f0300d1749da/go.mod h1:Q73ZrmVTwzkszR9V5SSuryQ31EELlFMUz1kKyl939pY=
-github.com/armon/go-metrics v0.4.1 h1:hR91U9KYmb6bLBYLQjyM+3j+rcd/UhE+G78SFnF8gJA=
-github.com/armon/go-metrics v0.4.1/go.mod h1:E6amYzXo6aW1tqzoZGT755KkbgrJsSdpwZ+3JqfkOG4=
-github.com/armon/go-radix v0.0.0-20180808171621-7fddfc383310/go.mod h1:ufUuZ+zHj4x4TnLV4JWEpy2hxWSpsRywHrMgIH9cCH8=
-github.com/armon/go-radix v1.0.0/go.mod h1:ufUuZ+zHj4x4TnLV4JWEpy2hxWSpsRywHrMgIH9cCH8=
-github.com/beorn7/perks v0.0.0-20180321164747-3a771d992973/go.mod h1:Dwedo/Wpr24TaqPxmxbtue+5NUziq4I4S80YR8gNf3Q=
-github.com/beorn7/perks v1.0.0/go.mod h1:KWe93zE9D1o94FZ5RNwFwVgaQK1VOXiVxmqh+CedLV8=
-github.com/beorn7/perks v1.0.1/go.mod h1:G2ZrVWU2WbWT9wwq4/hrbKbnv/1ERSJQ0ibhJ6rlkpw=
-github.com/bgentry/speakeasy v0.1.0/go.mod h1:+zsyZBPWlz7T6j88CTgSN5bM796AkVf0kBD4zp0CCIs=
-github.com/bitly/go-simplejson v0.5.0 h1:6IH+V8/tVMab511d5bn4M7EwGXZf9Hj6i2xSwkNEM+Y=
-github.com/bitly/go-simplejson v0.5.0/go.mod h1:cXHtHw4XUPsvGaxgjIAn8PhEWG9NfngEKAMDJEczWVA=
-github.com/bmizerany/assert v0.0.0-20160611221934-b7ed37b82869 h1:DDGfHa7BWjL4YnC6+E63dPcxHo2sUxDIu8g3QgEJdRY=
-github.com/bmizerany/assert v0.0.0-20160611221934-b7ed37b82869/go.mod h1:Ekp36dRnpXw/yCqJaO+ZrUyxD+3VXMFFr56k5XYrpB4=
-github.com/cespare/xxhash/v2 v2.1.1/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
-github.com/cespare/xxhash/v2 v2.3.0 h1:UL815xU9SqsFlibzuggzjXhog7bL6oX9BbNZnL2UFvs=
-github.com/cespare/xxhash/v2 v2.3.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
-github.com/circonus-labs/circonus-gometrics v2.3.1+incompatible/go.mod h1:nmEj6Dob7S7YxXgwXpfOuvO54S+tGdZdw9fuRZt25Ag=
-github.com/circonus-labs/circonusllhist v0.1.3/go.mod h1:kMXHVDlOchFAehlya5ePtbp5jckzBHf4XRpQvBOLI+I=
-github.com/coreos/go-semver v0.3.0 h1:wkHLiw0WNATZnSG7epLsujiMCgPAc9xhjJ4tgnAxmfM=
-github.com/coreos/go-semver v0.3.0/go.mod h1:nnelYz7RCh+5ahJtPPxZlU+153eP4D4r3EedlOD2RNk=
-github.com/coreos/go-systemd/v22 v22.3.2 h1:D9/bQk5vlXQFZ6Kwuu6zaiXJ9oTPe68++AzAJc1DzSI=
-github.com/coreos/go-systemd/v22 v22.3.2/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSVTIJ3seZv2GcEnc=
-github.com/cornelk/hashmap v1.0.8 h1:nv0AWgw02n+iDcawr5It4CjQIAcdMMKRrs10HOJYlrc=
-github.com/cornelk/hashmap v1.0.8/go.mod h1:RfZb7JO3RviW/rT6emczVuC/oxpdz4UsSB2LJSclR1k=
-github.com/cpuguy83/go-md2man/v2 v2.0.5 h1:ZtcqGrnekaHpVLArFSe4HK5DoKx1T0rq2DwVB0alcyc=
-github.com/cpuguy83/go-md2man/v2 v2.0.5/go.mod h1:tgQtvFlXSQOSOSIRvRPT7W67SCa46tRHOmNcaadrF8o=
-github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
-github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
-github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc h1:U9qPSI2PIWSS1VwoXQT9A3Wy9MM3WgvqSxFWenqJduM=
-github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
-github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f h1:lO4WD4F/rVNCu3HqELle0jiPLLBs70cWOduZpkS1E78=
-github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f/go.mod h1:cuUVRXasLTGF7a8hSLbxyZXjz+1KgoB3wDUb6vlszIc=
-github.com/fatih/color v1.7.0/go.mod h1:Zm6kSWBoL9eyXnKyktHP6abPY2pDugNf5KwzbycvMj4=
-github.com/fatih/color v1.9.0/go.mod h1:eQcE1qtQxscV5RaZvpXrrb8Drkc3/DdQ+uUYCNjL+zU=
-github.com/fatih/color v1.13.0/go.mod h1:kLAiJbzzSOZDVNGyDpeOxJ47H46qBXwg5ILebYFFOfk=
-github.com/fatih/color v1.16.0 h1:zmkK9Ngbjj+K0yRhTVONQh1p/HknKYSlNT+vZCzyokM=
-github.com/fatih/color v1.16.0/go.mod h1:fL2Sau1YI5c0pdGEVCbKQbLXB6edEj1ZgiY4NijnWvE=
-github.com/fsnotify/fsnotify v1.6.0 h1:n+5WquG0fcWoWp6xPWfHdbskMCQaFnG6PfBrh1Ky4HY=
-github.com/fsnotify/fsnotify v1.6.0/go.mod h1:sl3t1tCWJFWoRz9R8WJCbQihKKwmorjAbSClcnxKAGw=
-github.com/go-kit/kit v0.8.0/go.mod h1:xBxKIO96dXMWWy0MnWVtmwkA9/13aqxPnvrjFYMA2as=
-github.com/go-kit/kit v0.9.0/go.mod h1:xBxKIO96dXMWWy0MnWVtmwkA9/13aqxPnvrjFYMA2as=
-github.com/go-logfmt/logfmt v0.3.0/go.mod h1:Qt1PoO58o5twSAckw1HlFXLmHsOX5/0LbT9GBnD5lWE=
-github.com/go-logfmt/logfmt v0.4.0/go.mod h1:3RMwSq7FuexP4Kalkev3ejPJsZTpXXBr9+V4qmtdjCk=
-github.com/go-logr/logr v1.4.2 h1:6pFjapn8bFcIbiKo3XT4j/BhANplGihG6tvd+8rYgrY=
-github.com/go-logr/logr v1.4.2/go.mod h1:9T104GzyrTigFIr8wt5mBrctHMim0Nb2HLGrmQ40KvY=
-github.com/go-logr/stdr v1.2.2 h1:hSWxHoqTgW2S2qGc0LTAI563KZ5YKYRhT3MFKZMbjag=
-github.com/go-logr/stdr v1.2.2/go.mod h1:mMo/vtBO5dYbehREoey6XUKy/eSumjCCveDpRre4VKE=
-github.com/go-redis/redis/v8 v8.11.5 h1:AcZZR7igkdvfVmQTPnu9WE37LRrO/YrBH5zWyjDC0oI=
-github.com/go-redis/redis/v8 v8.11.5/go.mod h1:gREzHqY1hg6oD9ngVRbLStwAWKhA0FEgq8Jd4h5lpwo=
-github.com/go-sql-driver/mysql v1.9.2 h1:4cNKDYQ1I84SXslGddlsrMhc8k4LeDVj6Ad6WRjiHuU=
-github.com/go-sql-driver/mysql v1.9.2/go.mod h1:qn46aNg1333BRMNU69Lq93t8du/dwxI64Gl8i5p1WMU=
-github.com/go-stack/stack v1.8.0/go.mod h1:v0f6uXyyMGvRgIKkXu+yp6POWl0qKG85gN/melR3HDY=
-github.com/godbus/dbus/v5 v5.0.4/go.mod h1:xhWf0FNVPg57R7Z0UbKHbJfkEywrmjJnf7w5xrFpKfA=
-github.com/gogo/protobuf v1.1.1/go.mod h1:r8qH/GZQm5c6nD/R0oafs1akxWv10x8SbQlK7atdtwQ=
-github.com/gogo/protobuf v1.3.2 h1:Ov1cvc58UF3b5XjBnZv7+opcTcQFZebYjWzi34vdm4Q=
-github.com/gogo/protobuf v1.3.2/go.mod h1:P1XiOD3dCwIKUDQYPy72D8LYyHL2YPYrpS2s69NZV8Q=
-github.com/golang/protobuf v1.2.0/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
-github.com/golang/protobuf v1.3.1/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
-github.com/golang/protobuf v1.3.2/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
-github.com/golang/protobuf v1.5.4 h1:i7eJL8qZTpSEXOPTxNKhASYpMn+8e5Q6AdndVa1dWek=
-github.com/golang/protobuf v1.5.4/go.mod h1:lnTiLA8Wa4RWRcIUkrtSVa5nRhsEGBg48fD6rSs7xps=
-github.com/google/btree v0.0.0-20180813153112-4030bb1f1f0c/go.mod h1:lNA+9X1NB3Zf8V7Ke586lFgjr2dZNuvo3lPJSGZ5JPQ=
-github.com/google/btree v1.0.1 h1:gK4Kx5IaGY9CD5sPJ36FHiBJ6ZXl0kilRiiCj+jdYp4=
-github.com/google/btree v1.0.1/go.mod h1:xXMiIv4Fb/0kKde4SpL7qlzvu5cMJDRkFDxJfI9uaxA=
-github.com/google/go-cmp v0.3.1/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU=
-github.com/google/go-cmp v0.4.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
-github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=
-github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=
-github.com/google/go-tpm v0.9.3 h1:+yx0/anQuGzi+ssRqeD6WpXjW2L/V0dItUayO0i9sRc=
-github.com/google/go-tpm v0.9.3/go.mod h1:h9jEsEECg7gtLis0upRBQU+GhYVH6jMjrFxI8u6bVUY=
-github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg=
-github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
-github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
-github.com/hashicorp/consul/api v1.32.1 h1:0+osr/3t/aZNAdJX558crU3PEjVrG4x6715aZHRgceE=
-github.com/hashicorp/consul/api v1.32.1/go.mod h1:mXUWLnxftwTmDv4W3lzxYCPD199iNLLUyLfLGFJbtl4=
-github.com/hashicorp/consul/sdk v0.16.1 h1:V8TxTnImoPD5cj0U9Spl0TUxcytjcbbJeADFF07KdHg=
-github.com/hashicorp/consul/sdk v0.16.1/go.mod h1:fSXvwxB2hmh1FMZCNl6PwX0Q/1wdWtHJcZ7Ea5tns0s=
-github.com/hashicorp/errwrap v1.0.0/go.mod h1:YH+1FKiLXxHSkmPseP+kNlulaMuP3n2brvKWEqk/Jc4=
-github.com/hashicorp/errwrap v1.1.0 h1:OxrOeh75EUXMY8TBjag2fzXGZ40LB6IKw45YeGUDY2I=
-github.com/hashicorp/errwrap v1.1.0/go.mod h1:YH+1FKiLXxHSkmPseP+kNlulaMuP3n2brvKWEqk/Jc4=
-github.com/hashicorp/go-cleanhttp v0.5.0/go.mod h1:JpRdi6/HCYpAwUzNwuwqhbovhLtngrth3wmdIIUrZ80=
-github.com/hashicorp/go-cleanhttp v0.5.2 h1:035FKYIWjmULyFRBKPs8TBQoi0x6d9G4xc9neXJWAZQ=
-github.com/hashicorp/go-cleanhttp v0.5.2/go.mod h1:kO/YDlP8L1346E6Sodw+PrpBSV4/SoxCXGY6BqNFT48=
-github.com/hashicorp/go-hclog v1.5.0 h1:bI2ocEMgcVlz55Oj1xZNBsVi900c7II+fWDyV9o+13c=
-github.com/hashicorp/go-hclog v1.5.0/go.mod h1:W4Qnvbt70Wk/zYJryRzDRU/4r0kIg0PVHBcfoyhpF5M=
-github.com/hashicorp/go-immutable-radix v1.0.0/go.mod h1:0y9vanUI8NX6FsYoO3zeMjhV/C5i9g4Q3DwcSNZ4P60=
-github.com/hashicorp/go-immutable-radix v1.3.1 h1:DKHmCUm2hRBK510BaiZlwvpD40f8bJFeZnpfm2KLowc=
-github.com/hashicorp/go-immutable-radix v1.3.1/go.mod h1:0y9vanUI8NX6FsYoO3zeMjhV/C5i9g4Q3DwcSNZ4P60=
-github.com/hashicorp/go-msgpack v0.5.3/go.mod h1:ahLV/dePpqEmjfWmKiqvPkv/twdG7iPBM1vqhUKIvfM=
-github.com/hashicorp/go-msgpack v0.5.5 h1:i9R9JSrqIz0QVLz3sz+i3YJdT7TTSLcfLLzJi9aZTuI=
-github.com/hashicorp/go-msgpack v0.5.5/go.mod h1:ahLV/dePpqEmjfWmKiqvPkv/twdG7iPBM1vqhUKIvfM=
-github.com/hashicorp/go-multierror v1.0.0/go.mod h1:dHtQlpGsu+cZNNAkkCN/P3hoUDHhCYQXV3UM06sGGrk=
-github.com/hashicorp/go-multierror v1.1.0/go.mod h1:spPvp8C1qA32ftKqdAHm4hHTbPw+vmowP0z+KUhOZdA=
-github.com/hashicorp/go-multierror v1.1.1 h1:H5DkEtf6CXdFp0N0Em5UCwQpXMWke8IA0+lD48awMYo=
-github.com/hashicorp/go-multierror v1.1.1/go.mod h1:iw975J/qwKPdAO1clOe2L8331t/9/fmwbPZ6JB6eMoM=
-github.com/hashicorp/go-retryablehttp v0.5.3/go.mod h1:9B5zBasrRhHXnJnui7y6sL7es7NDiJgTc6Er0maI1Xs=
-github.com/hashicorp/go-rootcerts v1.0.2 h1:jzhAVGtqPKbwpyCPELlgNWhE1znq+qwJtW5Oi2viEzc=
-github.com/hashicorp/go-rootcerts v1.0.2/go.mod h1:pqUvnprVnM5bf7AOirdbb01K4ccR319Vf4pU3K5EGc8=
-github.com/hashicorp/go-sockaddr v1.0.0/go.mod h1:7Xibr9yA9JjQq1JpNB2Vw7kxv8xerXegt+ozgdvDeDU=
-github.com/hashicorp/go-sockaddr v1.0.2 h1:ztczhD1jLxIRjVejw8gFomI1BQZOe2WoVOu0SyteCQc=
-github.com/hashicorp/go-sockaddr v1.0.2/go.mod h1:rB4wwRAUzs07qva3c5SdrY/NEtAUjGlgmH/UkBUC97A=
-github.com/hashicorp/go-syslog v1.0.0/go.mod h1:qPfqrKkXGihmCqbJM2mZgkZGvKG1dFdvsLplgctolz4=
-github.com/hashicorp/go-uuid v1.0.0/go.mod h1:6SBZvOh/SIDV7/2o3Jml5SYk/TvGqwFJ/bN7x4byOro=
-github.com/hashicorp/go-uuid v1.0.1/go.mod h1:6SBZvOh/SIDV7/2o3Jml5SYk/TvGqwFJ/bN7x4byOro=
-github.com/hashicorp/go-uuid v1.0.3 h1:2gKiV6YVmrJ1i2CKKa9obLvRieoRGviZFL26PcT/Co8=
-github.com/hashicorp/go-uuid v1.0.3/go.mod h1:6SBZvOh/SIDV7/2o3Jml5SYk/TvGqwFJ/bN7x4byOro=
-github.com/hashicorp/go-version v1.2.1 h1:zEfKbn2+PDgroKdiOzqiE8rsmLqU2uwi5PB5pBJ3TkI=
-github.com/hashicorp/go-version v1.2.1/go.mod h1:fltr4n8CU8Ke44wwGCBoEymUuxUHl09ZGVZPK5anwXA=
-github.com/hashicorp/golang-lru v0.5.0/go.mod h1:/m3WP610KZHVQ1SGc6re/UDhFvYD7pJ4Ao+sR/qLZy8=
-github.com/hashicorp/golang-lru v1.0.2 h1:dV3g9Z/unq5DpblPpw+Oqcv4dU/1omnb4Ok8iPY6p1c=
-github.com/hashicorp/golang-lru v1.0.2/go.mod h1:iADmTwqILo4mZ8BN3D2Q6+9jd8WM5uGBxy+E8yxSoD4=
-github.com/hashicorp/logutils v1.0.0/go.mod h1:QIAnNjmIWmVIIkWDTG1z5v++HQmx9WQRO+LraFDTW64=
-github.com/hashicorp/mdns v1.0.4/go.mod h1:mtBihi+LeNXGtG8L9dX59gAEa12BDtBQSp4v/YAJqrc=
-github.com/hashicorp/memberlist v0.5.0 h1:EtYPN8DpAURiapus508I4n9CzHs2W+8NZGbmmR/prTM=
-github.com/hashicorp/memberlist v0.5.0/go.mod h1:yvyXLpo0QaGE59Y7hDTsTzDD25JYBZ4mHgHUZ8lrOI0=
-github.com/hashicorp/serf v0.10.1 h1:Z1H2J60yRKvfDYAOZLd2MU0ND4AH/WDz7xYHDWQsIPY=
-github.com/hashicorp/serf v0.10.1/go.mod h1:yL2t6BqATOLGc5HF7qbFkTfXoPIY0WZdWHfEvMqbG+4=
-github.com/json-iterator/go v1.1.6/go.mod h1:+SdeFBvtyEkXs7REEP0seUULqWtbJapLOCVDaaPEHmU=
-github.com/json-iterator/go v1.1.9/go.mod h1:KdQUCv79m/52Kvf8AW2vK1V8akMuk1QjK/uOdHXbAo4=
-github.com/julienschmidt/httprouter v1.2.0/go.mod h1:SYymIcj16QtmaHHD7aYtjjsJG7VTCxuUUipMqKk8s4w=
-github.com/kisielk/errcheck v1.5.0/go.mod h1:pFxgyoBC7bSaBwPgfKdkLd5X25qrDl4LWUI2bnpBCr8=
-github.com/kisielk/gotool v1.0.0/go.mod h1:XhKaO+MFFWcvkIS/tQcRk01m1F5IRFswLeQ+oQHNcck=
-github.com/klauspost/compress v1.18.0 h1:c/Cqfb0r+Yi+JtIEq73FWXVkRonBlf0CRNYc8Zttxdo=
-github.com/klauspost/compress v1.18.0/go.mod h1:2Pp+KzxcywXVXMr50+X0Q/Lsb43OQHYWRCY2AiWywWQ=
-github.com/konsorten/go-windows-terminal-sequences v1.0.1/go.mod h1:T0+1ngSBFLxvqU3pZ+m/2kptfBszLMUkC4ZK/EgS/cQ=
-github.com/kr/logfmt v0.0.0-20140226030751-b84e30acd515/go.mod h1:+0opPa2QZZtGFBFZlji/RkVcI2GknAs/DXo4wKdlNEc=
-github.com/kr/pretty v0.1.0/go.mod h1:dAy3ld7l9f0ibDNOQOHHMYYIIbhfbHSm3C4ZsoJORNo=
-github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE=
-github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk=
-github.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ=
-github.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI=
-github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
-github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
-github.com/lib/pq v1.10.9 h1:YXG7RB+JIjhP29X+OtkiDnYaXQwpS4JEWq7dtCCRUEw=
-github.com/lib/pq v1.10.9/go.mod h1:AlVN5x4E4T544tWzH6hKfbfQvm3HdbOxrmggDNAPY9o=
-github.com/mattn/go-colorable v0.0.9/go.mod h1:9vuHe8Xs5qXnSaW/c/ABM9alt+Vo+STaOChaDxuIBZU=
-github.com/mattn/go-colorable v0.1.4/go.mod h1:U0ppj6V5qS13XJ6of8GYAs25YV2eR4EVcfRqFIhoBtE=
-github.com/mattn/go-colorable v0.1.6/go.mod h1:u6P/XSegPjTcexA+o6vUJrdnUu04hMope9wVRipJSqc=
-github.com/mattn/go-colorable v0.1.9/go.mod h1:u6P/XSegPjTcexA+o6vUJrdnUu04hMope9wVRipJSqc=
-github.com/mattn/go-colorable v0.1.12/go.mod h1:u5H1YNBxpqRaxsYJYSkiCWKzEfiAb1Gb520KVy5xxl4=
-github.com/mattn/go-colorable v0.1.13 h1:fFA4WZxdEF4tXPZVKMLwD8oUnCTTo08duU7wxecdEvA=
-github.com/mattn/go-colorable v0.1.13/go.mod h1:7S9/ev0klgBDR4GtXTXX8a3vIGJpMovkB8vQcUbaXHg=
-github.com/mattn/go-isatty v0.0.3/go.mod h1:M+lRXTBqGeGNdLjl/ufCoiOlB5xdOkqRJdNxMWT7Zi4=
-github.com/mattn/go-isatty v0.0.8/go.mod h1:Iq45c/XA43vh69/j3iqttzPXn0bhXyGjM0Hdxcsrc5s=
-github.com/mattn/go-isatty v0.0.11/go.mod h1:PhnuNfih5lzO57/f3n+odYbM4JtupLOxQOAqxQCu2WE=
-github.com/mattn/go-isatty v0.0.12/go.mod h1:cbi8OIDigv2wuxKPP5vlRcQ1OAZbq2CE4Kysco4FUpU=
-github.com/mattn/go-isatty v0.0.14/go.mod h1:7GGIvUiUoEMVVmxf/4nioHXj79iQHKdU27kJ6hsGG94=
-github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/yFXSvRLM=
-github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
-github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
-github.com/matttproud/golang_protobuf_extensions v1.0.1/go.mod h1:D8He9yQNgCq6Z5Ld7szi9bcBfOoFv/3dc6xSMkL2PC0=
-github.com/miekg/dns v1.1.26/go.mod h1:bPDLeHnStXmXAq1m/Ch/hvfNHr14JKNPMBo3VZKjuso=
-github.com/miekg/dns v1.1.41/go.mod h1:p6aan82bvRIyn+zDIv9xYNUpwa73JcSh9BKwknJysuI=
-github.com/miekg/dns v1.1.50 h1:DQUfb9uc6smULcREF09Uc+/Gd46YWqJd5DbpPE9xkcA=
-github.com/miekg/dns v1.1.50/go.mod h1:e3IlAVfNqAllflbibAZEWOXOQ+Ynzk/dDozDxY7XnME=
-github.com/minio/highwayhash v1.0.3 h1:kbnuUMoHYyVl7szWjSxJnxw11k2U709jqFPPmIUyD6Q=
-github.com/minio/highwayhash v1.0.3/go.mod h1:GGYsuwP/fPD6Y9hMiXuapVvlIUEhFhMTh0rxU3ik1LQ=
-github.com/mitchellh/cli v1.1.0/go.mod h1:xcISNoH86gajksDmfB23e/pu+B+GeFRMYmoHXxx3xhI=
-github.com/mitchellh/go-homedir v1.1.0 h1:lukF9ziXFxDFPkA1vsr5zpc1XuPDn/wFntq5mG+4E0Y=
-github.com/mitchellh/go-homedir v1.1.0/go.mod h1:SfyaCUpYCn1Vlf4IUYiD9fPX4A5wJrkLzIz1N1q0pr0=
-github.com/mitchellh/hashstructure v1.1.0 h1:P6P1hdjqAAknpY/M1CGipelZgp+4y9ja9kmUZPXP+H0=
-github.com/mitchellh/hashstructure v1.1.0/go.mod h1:xUDAozZz0Wmdiufv0uyhnHkUTN6/6d8ulp4AwfLKrmA=
-github.com/mitchellh/mapstructure v0.0.0-20160808181253-ca63d7c062ee/go.mod h1:FVVH3fgwuzCH5S8UJGiWEs2h04kUh9fWfEaFds41c1Y=
-github.com/mitchellh/mapstructure v1.5.0 h1:jeMsZIYE/09sWLaz43PL7Gy6RuMjD2eJVyuac5Z2hdY=
-github.com/mitchellh/mapstructure v1.5.0/go.mod h1:bFUtVrKA4DC2yAKiSyO/QUcy7e+RRV2QTWOzhPopBRo=
-github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
-github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
-github.com/modern-go/reflect2 v0.0.0-20180701023420-4b7aa43c6742/go.mod h1:bx2lNnkwVCuqBIxFjflWJWanXIb3RllmbCylyMrvgv0=
-github.com/modern-go/reflect2 v1.0.1/go.mod h1:bx2lNnkwVCuqBIxFjflWJWanXIb3RllmbCylyMrvgv0=
-github.com/mwitkow/go-conntrack v0.0.0-20161129095857-cc309e4a2223/go.mod h1:qRWi+5nqEBWmkhHvq77mSJWrCKwh8bxhgT7d/eI7P4U=
-github.com/nats-io/jwt/v2 v2.7.4 h1:jXFuDDxs/GQjGDZGhNgH4tXzSUK6WQi2rsj4xmsNOtI=
-github.com/nats-io/jwt/v2 v2.7.4/go.mod h1:me11pOkwObtcBNR8AiMrUbtVOUGkqYjMQZ6jnSdVUIA=
-github.com/nats-io/nats-server/v2 v2.11.3 h1:AbGtXxuwjo0gBroLGGr/dE0vf24kTKdRnBq/3z/Fdoc=
-github.com/nats-io/nats-server/v2 v2.11.3/go.mod h1:6Z6Fd+JgckqzKig7DYwhgrE7bJ6fypPHnGPND+DqgMY=
-github.com/nats-io/nats.go v1.42.0 h1:ynIMupIOvf/ZWH/b2qda6WGKGNSjwOUutTpWRvAmhaM=
-github.com/nats-io/nats.go v1.42.0/go.mod h1:iRWIPokVIFbVijxuMQq4y9ttaBTMe0SFdlZfMDd+33g=
-github.com/nats-io/nkeys v0.4.11 h1:q44qGV008kYd9W1b1nEBkNzvnWxtRSQ7A8BoqRrcfa0=
-github.com/nats-io/nkeys v0.4.11/go.mod h1:szDimtgmfOi9n25JpfIdGw12tZFYXqhGxjhVxsatHVE=
-github.com/nats-io/nuid v1.0.1 h1:5iA8DT8V7q8WK2EScv2padNa/rTESc1KdnPw4TC2paw=
-github.com/nats-io/nuid v1.0.1/go.mod h1:19wcPz3Ph3q0Jbyiqsd0kePYG7A95tJPxeL+1OSON2c=
-github.com/nxadm/tail v1.4.8 h1:nPr65rt6Y5JFSKQO7qToXr7pePgD6Gwiw05lkbyAQTE=
-github.com/nxadm/tail v1.4.8/go.mod h1:+ncqLTQzXmGhMZNUePPaPqPvBxHAIsmXswZKocGu+AU=
-github.com/onsi/ginkgo v1.16.5 h1:8xi0RTUf59SOSfEtZMvwTvXYMzG4gV23XVHOZiXNtnE=
-github.com/onsi/ginkgo v1.16.5/go.mod h1:+E8gABHa3K6zRBolWtd+ROzc/U5bkGt0FwiG042wbpU=
-github.com/onsi/gomega v1.18.1 h1:M1GfJqGRrBrrGGsbxzV5dqM2U2ApXefZCQpkukxYRLE=
-github.com/onsi/gomega v1.18.1/go.mod h1:0q+aL8jAiMXy9hbwj2mr5GziHiwhAIQpFmmtT5hitRs=
-github.com/oxtoacart/bpool v0.0.0-20190530202638-03653db5a59c h1:rp5dCmg/yLR3mgFuSOe4oEnDDmGLROTvMragMUXpTQw=
-github.com/oxtoacart/bpool v0.0.0-20190530202638-03653db5a59c/go.mod h1:X07ZCGwUbLaax7L0S3Tw4hpejzu63ZrrQiUe6W0hcy0=
-github.com/pascaldekloe/goe v0.0.0-20180627143212-57f6aae5913c/go.mod h1:lzWF7FIEvWOWxwDKqyGYQf6ZUaNfKdP144TG7ZOy1lc=
-github.com/pascaldekloe/goe v0.1.0 h1:cBOtyMzM9HTpWjXfbbunk26uA6nG3a8n06Wieeh0MwY=
-github.com/pascaldekloe/goe v0.1.0/go.mod h1:lzWF7FIEvWOWxwDKqyGYQf6ZUaNfKdP144TG7ZOy1lc=
-github.com/patrickmn/go-cache v2.1.0+incompatible h1:HRMgzkcYKYpi3C8ajMPV8OFXaaRUnok+kx1WdO15EQc=
-github.com/patrickmn/go-cache v2.1.0+incompatible/go.mod h1:3Qf8kWWT7OJRJbdiICTKqZju1ZixQ/KpMGzzAfe6+WQ=
-github.com/pkg/errors v0.8.0/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
-github.com/pkg/errors v0.8.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
-github.com/pkg/errors v0.9.1 h1:FEBLx1zS214owpjy7qsBeixbURkuhQAwrK5UwLGTwt4=
-github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
-github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
-github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2 h1:Jamvg5psRIccs7FGNTlIRMkT8wgtp5eCXdBlqhYGL6U=
-github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
-github.com/posener/complete v1.1.1/go.mod h1:em0nMJCgc9GFtwrmVmEMR/ZL6WyhyjMBndrE9hABlRI=
-github.com/posener/complete v1.2.3/go.mod h1:WZIdtGGp+qx0sLrYKtIRAruyNpv6hFCicSgv7Sy7s/s=
-github.com/prometheus/client_golang v0.9.1/go.mod h1:7SWBe2y4D6OKWSNQJUaRYU/AaXPKyh/dDVn+NZz0KFw=
-github.com/prometheus/client_golang v1.0.0/go.mod h1:db9x61etRT2tGnBNRi70OPL5FsnadC4Ky3P0J6CfImo=
-github.com/prometheus/client_golang v1.4.0/go.mod h1:e9GMxYsXl05ICDXkRhurwBS4Q3OK1iX/F2sw+iXX5zU=
-github.com/prometheus/client_model v0.0.0-20180712105110-5c3871d89910/go.mod h1:MbSGuTsp3dbXC40dX6PRTWyKYBIrTGTE9sqQNg2J8bo=
-github.com/prometheus/client_model v0.0.0-20190129233127-fd36f4220a90/go.mod h1:xMI15A0UPsDsEKsMN9yxemIoYk6Tm2C1GtYGdfGttqA=
-github.com/prometheus/client_model v0.2.0/go.mod h1:xMI15A0UPsDsEKsMN9yxemIoYk6Tm2C1GtYGdfGttqA=
-github.com/prometheus/common v0.4.1/go.mod h1:TNfzLD0ON7rHzMJeJkieUDPYmFC7Snx/y86RQel1bk4=
-github.com/prometheus/common v0.9.1/go.mod h1:yhUN8i9wzaXS3w1O07YhxHEBxD+W35wd8bs7vj7HSQ4=
-github.com/prometheus/procfs v0.0.0-20181005140218-185b4288413d/go.mod h1:c3At6R/oaqEKCNdg8wHV1ftS6bRYblBhIjjI8uT2IGk=
-github.com/prometheus/procfs v0.0.2/go.mod h1:TjEm7ze935MbeOT/UhFTIMYKhuLP4wbCsTZCD3I8kEA=
-github.com/prometheus/procfs v0.0.8/go.mod h1:7Qr8sr6344vo1JqZ6HhLceV9o3AJ1Ff+GxbHq6oeK9A=
-github.com/rabbitmq/amqp091-go v1.10.0 h1:STpn5XsHlHGcecLmMFCtg7mqq0RnD+zFr4uzukfVhBw=
-github.com/rabbitmq/amqp091-go v1.10.0/go.mod h1:Hy4jKW5kQART1u+JkDTF9YYOQUHXqMuhrgxOEeS7G4o=
-github.com/rogpeppe/go-internal v1.13.1 h1:KvO1DLK/DRN07sQ1LQKScxyZJuNnedQ5/wKSR38lUII=
-github.com/rogpeppe/go-internal v1.13.1/go.mod h1:uMEvuHeurkdAXX61udpOXGD/AzZDWNMNyH2VO9fmH0o=
-github.com/russross/blackfriday/v2 v2.1.0 h1:JIOH55/0cWyOuilr9/qlrm0BSXldqnqwMsf35Ld67mk=
-github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
-github.com/ryanuber/columnize v0.0.0-20160712163229-9b3edd62028f/go.mod h1:sm1tb6uqfes/u+d4ooFouqFdy9/2g9QGwK3SQygK0Ts=
-github.com/sean-/seed v0.0.0-20170313163322-e2103e2c3529 h1:nn5Wsu0esKSJiIVhscUtVbo7ada43DJhG55ua/hjS5I=
-github.com/sean-/seed v0.0.0-20170313163322-e2103e2c3529/go.mod h1:DxrIzT+xaE7yg65j358z/aeFdxmN0P9QXhEzd20vsDc=
-github.com/sirupsen/logrus v1.2.0/go.mod h1:LxeOpSwHxABJmUn/MG1IvRgCAasNZTLOkJPxbbu5VWo=
-github.com/sirupsen/logrus v1.4.2/go.mod h1:tLMulIdttU9McNUspp0xgXVQah82FyeX6MwdIuYE2rE=
-github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
-github.com/stretchr/objx v0.1.1/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
-github.com/stretchr/objx v0.5.2 h1:xuMeJ0Sdp5ZMRXx/aWO6RZxdr3beISkG5/G/aIRr3pY=
-github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA=
-github.com/stretchr/testify v1.2.2/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs=
-github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
-github.com/stretchr/testify v1.4.0/go.mod h1:j7eGeouHqKxXV5pUuKE4zz7dFj8WfuZ+81PSLYec5m4=
-github.com/stretchr/testify v1.7.2/go.mod h1:R6va5+xMeoiuVRoj+gSkQ7d3FALtqAAGI1FQKckRals=
-github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
-github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
-github.com/test-go/testify v1.1.4 h1:Tf9lntrKUMHiXQ07qBScBTSA0dhYQlu83hswqelv1iE=
-github.com/test-go/testify v1.1.4/go.mod h1:rH7cfJo/47vWGdi4GPj16x3/t1xGOj2YxzmNQzk2ghU=
-github.com/tv42/httpunix v0.0.0-20150427012821-b75d8614f926/go.mod h1:9ESjWnEqriFuLhtthL60Sar/7RFoluCcXsuvEwTV5KM=
-github.com/urfave/cli/v2 v2.27.6 h1:VdRdS98FNhKZ8/Az8B7MTyGQmpIr36O1EHybx/LaZ4g=
-github.com/urfave/cli/v2 v2.27.6/go.mod h1:3Sevf16NykTbInEnD0yKkjDAeZDS0A6bzhBH5hrMvTQ=
-github.com/xrash/smetrics v0.0.0-20240521201337-686a1a2994c1 h1:gEOO8jv9F4OT7lGCjxCBTO/36wtF6j2nSip77qHd4x4=
-github.com/xrash/smetrics v0.0.0-20240521201337-686a1a2994c1/go.mod h1:Ohn+xnUBiLI6FVj/9LpzZWtj1/D6lUovWYBkxHVV3aM=
-github.com/yuin/goldmark v1.1.27/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=
-github.com/yuin/goldmark v1.2.1/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=
-github.com/yuin/goldmark v1.3.5/go.mod h1:mwnBkeHKe2W/ZEtQ+71ViKU8L12m81fl3OWwC1Zlc8k=
-go.etcd.io/bbolt v1.4.0 h1:TU77id3TnN/zKr7CO/uk+fBCwF2jGcMuw2B/FMAzYIk=
-go.etcd.io/bbolt v1.4.0/go.mod h1:AsD+OCi/qPN1giOX1aiLAha3o1U8rAz65bvN4j0sRuk=
-go.etcd.io/etcd/api/v3 v3.5.21 h1:A6O2/JDb3tvHhiIz3xf9nJ7REHvtEFJJ3veW3FbCnS8=
-go.etcd.io/etcd/api/v3 v3.5.21/go.mod h1:c3aH5wcvXv/9dqIw2Y810LDXJfhSYdHQ0vxmP3CCHVY=
-go.etcd.io/etcd/client/pkg/v3 v3.5.21 h1:lPBu71Y7osQmzlflM9OfeIV2JlmpBjqBNlLtcoBqUTc=
-go.etcd.io/etcd/client/pkg/v3 v3.5.21/go.mod h1:BgqT/IXPjK9NkeSDjbzwsHySX3yIle2+ndz28nVsjUs=
-go.etcd.io/etcd/client/v3 v3.5.21 h1:T6b1Ow6fNjOLOtM0xSoKNQt1ASPCLWrF9XMHcH9pEyY=
-go.etcd.io/etcd/client/v3 v3.5.21/go.mod h1:mFYy67IOqmbRf/kRUvsHixzo3iG+1OF2W2+jVIQRAnU=
-go.opentelemetry.io/auto/sdk v1.1.0 h1:cH53jehLUN6UFLY71z+NDOiNJqDdPRaXzTel0sJySYA=
-go.opentelemetry.io/auto/sdk v1.1.0/go.mod h1:3wSPjt5PWp2RhlCcmmOial7AvC4DQqZb7a7wCow3W8A=
-go.opentelemetry.io/otel v1.35.0 h1:xKWKPxrxB6OtMCbmMY021CqC45J+3Onta9MqjhnusiQ=
-go.opentelemetry.io/otel v1.35.0/go.mod h1:UEqy8Zp11hpkUrL73gSlELM0DupHoiq72dR+Zqel/+Y=
-go.opentelemetry.io/otel/metric v1.35.0 h1:0znxYu2SNyuMSQT4Y9WDWej0VpcsxkuklLa4/siN90M=
-go.opentelemetry.io/otel/metric v1.35.0/go.mod h1:nKVFgxBZ2fReX6IlyW28MgZojkoAkJGaE8CpgeAU3oE=
-go.opentelemetry.io/otel/sdk v1.34.0 h1:95zS4k/2GOy069d321O8jWgYsW3MzVV+KuSPKp7Wr1A=
-go.opentelemetry.io/otel/sdk v1.34.0/go.mod h1:0e/pNiaMAqaykJGKbi+tSjWfNNHMTxoC9qANsCzbyxU=
-go.opentelemetry.io/otel/sdk/metric v1.34.0 h1:5CeK9ujjbFVL5c1PhLuStg1wxA7vQv7ce1EK0Gyvahk=
-go.opentelemetry.io/otel/sdk/metric v1.34.0/go.mod h1:jQ/r8Ze28zRKoNRdkjCZxfs6YvBTG1+YIqyFVFYec5w=
-go.opentelemetry.io/otel/trace v1.35.0 h1:dPpEfJu1sDIqruz7BHFG3c7528f6ddfSWfFDVt/xgMs=
-go.opentelemetry.io/otel/trace v1.35.0/go.mod h1:WUk7DtFp1Aw2MkvqGdwiXYDZZNvA/1J8o6xRXLrIkyc=
-go.uber.org/goleak v1.3.0 h1:2K3zAYmnTNqV73imy9J1T3WC+gmCePx2hEGkimedGto=
-go.uber.org/goleak v1.3.0/go.mod h1:CoHD4mav9JJNrW/WLlf7HGZPjdw8EucARQHekz1X6bE=
-go.uber.org/multierr v1.10.0 h1:S0h4aNzvfcFsC3dRF1jLoaov7oRaKqRGC/pUEJ2yvPQ=
-go.uber.org/multierr v1.10.0/go.mod h1:20+QtiLqy0Nd6FdQB9TLXag12DsQkrbs3htMFfDN80Y=
-go.uber.org/zap v1.27.0 h1:aJMhYGrd5QSmlpLMr2MftRKl7t8J8PTZPA732ud/XR8=
-go.uber.org/zap v1.27.0/go.mod h1:GB2qFLM7cTU87MWRP2mPIjqfIDnGu+VIO4V/SdhGo2E=
-golang.org/x/crypto v0.0.0-20180904163835-0709b304e793/go.mod h1:6SG95UA2DQfeDnfUPMdvaQW0Q7yPrPDi9nlGo2tz2b4=
-golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
-golang.org/x/crypto v0.0.0-20190923035154-9ee001bba392/go.mod h1:/lpIB1dKB+9EgE3H3cr1v9wB50oz8l4C4h62xy7jSTY=
-golang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI=
-golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto=
-golang.org/x/crypto v0.37.0 h1:kJNSjF/Xp7kU0iB2Z+9viTPMW4EqqsrywMXLJOOsXSE=
-golang.org/x/crypto v0.37.0/go.mod h1:vg+k43peMZ0pUMhYmVAWysMK35e6ioLh3wB8ZCAfbVc=
-golang.org/x/exp v0.0.0-20250305212735-054e65f0b394 h1:nDVHiLt8aIbd/VzvPWN6kSOPE7+F/fNFDSXLVYkE/Iw=
-golang.org/x/exp v0.0.0-20250305212735-054e65f0b394/go.mod h1:sIifuuw/Yco/y6yb6+bDNfyeQ/MdPUy/hKEMYQV17cM=
-golang.org/x/mod v0.2.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA=
-golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA=
-golang.org/x/mod v0.4.2/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA=
-golang.org/x/mod v0.24.0 h1:ZfthKaKaT4NrhGVZHO1/WDTwGES4De8KtWO0SIbNJMU=
-golang.org/x/mod v0.24.0/go.mod h1:IXM97Txy2VM4PJ3gI61r1YEk/gAj6zAHN3AdZt6S9Ww=
-golang.org/x/net v0.0.0-20181114220301-adae6a3d119a/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4=
-golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
-golang.org/x/net v0.0.0-20190613194153-d28f0bde5980/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
-golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
-golang.org/x/net v0.0.0-20190923162816-aa69164e4478/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
-golang.org/x/net v0.0.0-20200226121028-0de0cce0169b/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
-golang.org/x/net v0.0.0-20201021035429-f5854403a974/go.mod h1:sp8m0HH+o8qH0wwXwYZr8TS3Oi6o0r6Gce1SSxlDquU=
-golang.org/x/net v0.0.0-20210226172049-e18ecbb05110/go.mod h1:m0MpNAwzfU5UDzcl9v0D8zg8gWTRqZa9RBIspLL5mdg=
-golang.org/x/net v0.0.0-20210405180319-a5a99cb37ef4/go.mod h1:p54w0d4576C0XHj96bSt6lcn1PtDYWL6XObtHCRCNQM=
-golang.org/x/net v0.0.0-20210410081132-afb366fc7cd1/go.mod h1:9tjilg8BloeKEkVJvy7fQ90B1CfIiPueXVOjqfkSzI8=
-golang.org/x/net v0.0.0-20210726213435-c6fcb2dbf985/go.mod h1:9nx3DQGgdP8bBQD5qxJ1jj9UTztislL4KSBs9R2vV5Y=
-golang.org/x/net v0.38.0 h1:vRMAPTMaeGqVhG5QyLJHqNDwecKTomGeqbnfZyKlBI8=
-golang.org/x/net v0.38.0/go.mod h1:ivrbrMbzFq5J41QOQh0siUuly180yBYtLp+CKbEaFx8=
-golang.org/x/sync v0.0.0-20181108010431-42b317875d0f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
-golang.org/x/sync v0.0.0-20181221193216-37e7f081c4d4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
-golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
-golang.org/x/sync v0.0.0-20190911185100-cd5d95a43a6e/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
-golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
-golang.org/x/sync v0.0.0-20210220032951-036812b2e83c/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
-golang.org/x/sync v0.13.0 h1:AauUjRAJ9OSnvULf/ARrrVywoJDy0YS2AwQ98I37610=
-golang.org/x/sync v0.13.0/go.mod h1:1dzgHSNfp02xaA81J2MS99Qcpr2w7fw1gpm99rleRqA=
-golang.org/x/sys v0.0.0-20180823144017-11551d06cbcc/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
-golang.org/x/sys v0.0.0-20180905080454-ebe1bf3edb33/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
-golang.org/x/sys v0.0.0-20181116152217-5ac8a444bdc5/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
-golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
-golang.org/x/sys v0.0.0-20190222072716-a9d3bda3a223/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
-golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20190422165155-953cdadca894/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20190922100055-0a153f010e69/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20190924154521-2837fb4f24fe/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20191026070338-33540a1f6037/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20200116001909-b77594299b42/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20200122134326-e047566fdf82/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20200223170610-d5e6a3e2c0ae/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20200930185726-fdedc70b468f/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20210303074136-134d130e1a04/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20210330210617-4fbd30eecc44/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20210423082822-04245dca01da/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20210510120138-977fb7262007/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.0.0-20210630005230-0f9fa26af87c/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.0.0-20210927094055-39ccf1dd6fa6/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.0.0-20220503163025-988cb79eb6c6/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.0.0-20220728004956-3c1f35247d10/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.0.0-20220908164124-27713097b956/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.32.0 h1:s77OFDvIQeibCmezSnk/q6iAfkdiQaJi4VzroCFrN20=
-golang.org/x/sys v0.32.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k=
-golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo=
-golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
-golang.org/x/text v0.3.2/go.mod h1:bEr9sfX3Q8Zfm5fL9x+3itogRgK3+ptLWKqgva+5dAk=
-golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
-golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
-golang.org/x/text v0.24.0 h1:dd5Bzh4yt5KYA8f9CJHCP4FB4D51c2c6JvN37xJJkJ0=
-golang.org/x/text v0.24.0/go.mod h1:L8rBsPeo2pSS+xqN0d5u2ikmjtmoJbDBT1b7nHvFCdU=
-golang.org/x/time v0.11.0 h1:/bpjEDfN9tkoN/ryeYHnv5hcMlc8ncjMcM4XBk5NWV0=
-golang.org/x/time v0.11.0/go.mod h1:CDIdPxbZBQxdj6cxyCIdrNogrJKMJ7pr37NYpMcMDSg=
-golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
-golang.org/x/tools v0.0.0-20190907020128-2ca718005c18/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
-golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
-golang.org/x/tools v0.0.0-20200619180055-7c47624df98f/go.mod h1:EkVYQZoAsY45+roYkvgYkIh4xh/qjgUK9TdY2XT94GE=
-golang.org/x/tools v0.0.0-20210106214847-113979e3529a/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA=
-golang.org/x/tools v0.1.6-0.20210726203631-07bc1bf47fb2/go.mod h1:o0xws9oXOQQZyjljx8fwUC0k7L1pTE6eaCbjGeHmOkk=
-golang.org/x/tools v0.31.0 h1:0EedkvKDbh+qistFTd0Bcwe/YLh4vHwWEkiI0toFIBU=
-golang.org/x/tools v0.31.0/go.mod h1:naFTU+Cev749tSJRXJlna0T3WxKvb1kWEx15xA4SdmQ=
-golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
-golang.org/x/xerrors v0.0.0-20191011141410-1b5146add898/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
-golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
-golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
-google.golang.org/genproto/googleapis/api v0.0.0-20250324211829-b45e905df463 h1:hE3bRWtU6uceqlh4fhrSnUyjKHMKB9KrTLLG+bc0ddM=
-google.golang.org/genproto/googleapis/api v0.0.0-20250324211829-b45e905df463/go.mod h1:U90ffi8eUL9MwPcrJylN5+Mk2v3vuPDptd5yyNUiRR8=
-google.golang.org/genproto/googleapis/rpc v0.0.0-20250324211829-b45e905df463 h1:e0AIkUUhxyBKh6ssZNrAMeqhA7RKUj42346d1y02i2g=
-google.golang.org/genproto/googleapis/rpc v0.0.0-20250324211829-b45e905df463/go.mod h1:qQ0YXyHHx3XkvlzUtpXDkS29lDSafHMZBAZDc03LQ3A=
-google.golang.org/grpc v1.71.1 h1:ffsFWr7ygTUscGPI0KKK6TLrGz0476KUvvsbqWK0rPI=
-google.golang.org/grpc v1.71.1/go.mod h1:H0GRtasmQOh9LkFoCPDu3ZrwUtD1YGE+b2vYBYd/8Ec=
-google.golang.org/protobuf v1.36.6 h1:z1NpPI8ku2WgiWnf+t9wTPsn6eP1L7ksHUlkfLvd9xY=
-google.golang.org/protobuf v1.36.6/go.mod h1:jduwjTPXsFjZGTmRluh+L6NjiWu7pchiJ2/5YcXBHnY=
-gopkg.in/alecthomas/kingpin.v2 v2.2.6/go.mod h1:FMv+mEhP44yOT+4EoQTLFTRgOQ1FBLkstjWtayDeSgw=
-gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
-gopkg.in/check.v1 v1.0.0-20190902080502-41f04d3bba15/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
-gopkg.in/tomb.v1 v1.0.0-20141024135613-dd632973f1e7 h1:uRGJdciOHaEIrze2W8Q3AKkepLTh2hOroT7a+7czfdQ=
-gopkg.in/tomb.v1 v1.0.0-20141024135613-dd632973f1e7/go.mod h1:dt/ZhP58zS4L8KSrWDmTeBkI65Dw0HsyUHuEVlX15mw=
-gopkg.in/yaml.v2 v2.2.1/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
-gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
-gopkg.in/yaml.v2 v2.2.4/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
-gopkg.in/yaml.v2 v2.2.5/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
-gopkg.in/yaml.v2 v2.4.0 h1:D8xgwECY7CYvx+Y2n4sBz93Jn9JRvxdiyyo8CTfuKaY=
-gopkg.in/yaml.v2 v2.4.0/go.mod h1:RDklbk79AGWmwhnvt/jBztapEOGDOx6ZbXqjP6csGnQ=
-gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
-gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
@@ -1,102 +0,0 @@
-package main
-
-import (
-	"encoding/json"
-	"fmt"
-	"log"
-	"net/http"
-	"time"
-
-	"go-micro.dev/v5/web"
-)
-
-type User struct {
-	ID        string    `json:"id"`
-	Name      string    `json:"name"`
-	Email     string    `json:"email"`
-	CreatedAt time.Time `json:"created_at"`
-}
-
-var users = map[string]*User{
-	"1": {ID: "1", Name: "Alice", Email: "alice@example.com", CreatedAt: time.Now()},
-	"2": {ID: "2", Name: "Bob", Email: "bob@example.com", CreatedAt: time.Now()},
-}
-
-func main() {
-	// Create a new web service
-	service := web.NewService(
-		web.Name("web.service"),
-		web.Version("latest"),
-		web.Address(":9090"),
-	)
-
-	// Initialize
-	service.Init()
-
-	// Register handlers
-	service.HandleFunc("/", homeHandler)
-	service.HandleFunc("/users", usersHandler)
-	service.HandleFunc("/users/", userHandler)
-	service.HandleFunc("/health", healthHandler)
-
-	fmt.Println("Web service starting on :9090")
-	fmt.Println("Try:")
-	fmt.Println("  curl http://localhost:9090/")
-	fmt.Println("  curl http://localhost:9090/users")
-	fmt.Println("  curl http://localhost:9090/users/1")
-	fmt.Println("  curl http://localhost:9090/health")
-
-	// Run the service
-	if err := service.Run(); err != nil {
-		log.Fatal(err)
-	}
-}
-
-func homeHandler(w http.ResponseWriter, r *http.Request) {
-	w.Header().Set("Content-Type", "application/json")
-	json.NewEncoder(w).Encode(map[string]string{
-		"service": "web.service",
-		"version": "latest",
-		"status":  "running",
-	})
-}
-
-func usersHandler(w http.ResponseWriter, r *http.Request) {
-	w.Header().Set("Content-Type", "application/json")
-	
-	// Return all users
-	userList := make([]*User, 0, len(users))
-	for _, user := range users {
-		userList = append(userList, user)
-	}
-	
-	json.NewEncoder(w).Encode(userList)
-}
-
-func userHandler(w http.ResponseWriter, r *http.Request) {
-	w.Header().Set("Content-Type", "application/json")
-	
-	// Extract user ID from path
-	id := r.URL.Path[len("/users/"):]
-	
-	user, exists := users[id]
-	if !exists {
-		w.WriteHeader(http.StatusNotFound)
-		json.NewEncoder(w).Encode(map[string]string{
-			"error": "User not found",
-		})
-		return
-	}
-	
-	json.NewEncoder(w).Encode(user)
-}
-
-func healthHandler(w http.ResponseWriter, r *http.Request) {
-	w.Header().Set("Content-Type", "application/json")
-	w.WriteHeader(http.StatusOK)
-	json.NewEncoder(w).Encode(map[string]interface{}{
-		"status":    "healthy",
-		"timestamp": time.Now().Unix(),
-		"uptime":    "running",
-	})
-}
@@ -1,288 +0,0 @@
-# API Gateway
-
-The `gateway/api` package provides HTTP API gateway functionality for go-micro services. It translates HTTP requests into RPC calls and serves a web dashboard for browsing and calling services.
-
-## Features
-
- **HTTP to RPC translation** - Call microservices via HTTP
- **Web dashboard** - Browse and test services in the browser
- **Authentication** - Optional JWT-based auth
- **MCP integration** - Expose services to AI agents
- **Flexible configuration** - Use in dev or production
- **Service discovery** - Auto-detect services from registry
-
-## Usage
-
-### Basic Gateway
-
-```go
-package main
-
-import (
-    "context"
-    "net/http"
-
-    "go-micro.dev/v5/gateway/api"
-)
-
-func main() {
-    // Create gateway with custom handler
-    gw, err := api.New(api.Options{
-        Address: ":8080",
-        Context: context.Background(),
-        HandlerRegistrar: func(mux *http.ServeMux) error {
-            // Register your HTTP handlers
-            mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
-                w.Write([]byte("Hello from gateway"))
-            })
-            return nil
-        },
-    })
-    if err != nil {
-        panic(err)
-    }
-
-    // Block until shutdown
-    gw.Wait()
-}
-```
-
-### Gateway with MCP
-
-```go
-gw, err := api.New(api.Options{
-    Address:    ":8080",
-    MCPEnabled: true,
-    MCPAddress: ":3000", // MCP on separate port
-    HandlerRegistrar: registerHandlers,
-})
-```
-
-### Gateway with Authentication
-
-```go
-gw, err := api.New(api.Options{
-    Address:     ":8080",
-    AuthEnabled: true, // Handler registrar should add auth middleware
-    HandlerRegistrar: func(mux *http.ServeMux) error {
-        // Register handlers with auth middleware
-        return registerAuthenticatedHandlers(mux)
-    },
-})
-```
-
-### Blocking Mode
-
-```go
-// Run blocks until shutdown
-err := api.Run(api.Options{
-    Address: ":8080",
-    HandlerRegistrar: registerHandlers,
-})
-```
-
-## Options
-
-```go
-type Options struct {
-    // Address to listen on (default: ":8080")
-    Address string
-
-    // AuthEnabled signals that authentication is required
-    // The HandlerRegistrar should implement auth checks
-    AuthEnabled bool
-
-    // Context for cancellation (default: context.Background())
-    Context context.Context
-
-    // Logger for gateway messages (default: log.Default())
-    Logger *log.Logger
-
-    // HandlerRegistrar registers HTTP handlers on the mux
-    HandlerRegistrar func(mux *http.ServeMux) error
-
-    // MCPEnabled enables the MCP gateway
-    MCPEnabled bool
-
-    // MCPAddress is the address for MCP gateway (e.g., ":3000")
-    MCPAddress string
-
-    // Registry for service discovery (default: registry.DefaultRegistry)
-    Registry registry.Registry
-}
-```
-
-## Architecture
-
-```
-┌─────────────────────────────────────────┐
-│         gateway/api Package              │
-│  ┌────────────────────────────────────┐ │
-│  │  Gateway                           │ │
-│  │  - Manages HTTP server             │ │
-│  │  - Calls HandlerRegistrar          │ │
-│  │  - Starts MCP if enabled           │ │
-│  └────────────────────────────────────┘ │
-└─────────────────────────────────────────┘
-               ↓ delegates to
-┌─────────────────────────────────────────┐
-│     HandlerRegistrar (user-provided)     │
-│  ┌────────────────────────────────────┐ │
-│  │  func(mux *http.ServeMux) error    │ │
-│  │  - Registers routes                │ │
-│  │  - Adds middleware (auth, etc.)    │ │
-│  │  - Sets up templates               │ │
-│  └────────────────────────────────────┘ │
-└─────────────────────────────────────────┘
-               ↓ uses
-┌─────────────────────────────────────────┐
-│         Microservices (via RPC)          │
-└─────────────────────────────────────────┘
-```
-
-## Integration
-
-### In `micro run` (Development)
-
-```go
-// cmd/micro/run/run.go
-import "go-micro.dev/v5/gateway/api"
-
-gw, err := api.New(api.Options{
-    Address:     ":8080",
-    AuthEnabled: false, // No auth in dev mode
-    HandlerRegistrar: func(mux *http.ServeMux) error {
-        // Register dev-mode handlers (no auth)
-        mux.HandleFunc("/", dashboardHandler)
-        mux.HandleFunc("/api/", apiHandler)
-        return nil
-    },
-})
-```
-
-### In `micro server` (Production)
-
-```go
-// cmd/micro/server/server.go
-import "go-micro.dev/v5/gateway/api"
-
-gw, err := api.New(api.Options{
-    Address:     ":8080",
-    AuthEnabled: true, // Auth required in production
-    HandlerRegistrar: func(mux *http.ServeMux) error {
-        // Register prod handlers with auth middleware
-        mux.HandleFunc("/", authMiddleware(dashboardHandler))
-        mux.HandleFunc("/api/", authMiddleware(apiHandler))
-        return nil
-    },
-})
-```
-
-### Custom Application
-
-```go
-// Your app
-import "go-micro.dev/v5/gateway/api"
-
-func main() {
-    gw, err := api.New(api.Options{
-        Address: ":8080",
-        HandlerRegistrar: func(mux *http.ServeMux) error {
-            // Your custom handlers
-            mux.HandleFunc("/health", healthHandler)
-            mux.HandleFunc("/metrics", metricsHandler)
-            mux.HandleFunc("/api/", proxyToServices)
-            return nil
-        },
-    })
-
-    if err != nil {
-        log.Fatal(err)
-    }
-
-    log.Println("Gateway running on :8080")
-    gw.Wait()
-}
-```
-
-## Comparison with Old Architecture
-
-### Before (Duplicated Code)
-
-```
-cmd/micro/run/gateway/
-  └── gateway.go (300+ lines)
-
-cmd/micro/server/
-  └── gateway.go (150+ lines)
-
-❌ Code duplication
-❌ Inconsistent behavior
-❌ Hard to reuse
-```
-
-### After (Unified)
-
-```
-gateway/api/
-  └── gateway.go (150 lines, reusable)
-
-cmd/micro/server/
-  └── gateway.go (70 lines, compatibility wrapper)
-
-cmd/micro/run/
-  └── Uses api.New() directly
-
-✅ Single source of truth
-✅ Consistent behavior
-✅ Easy to reuse in custom apps
-```
-
-## Benefits
-
-1. **Reusability** - Use in any Go application, not just micro CLI
-2. **Testability** - Easy to test with custom handler registrars
-3. **Flexibility** - Supports different configurations (dev, prod, custom)
-4. **Consistency** - Same gateway code for all use cases
-5. **Maintainability** - One place to fix bugs and add features
-
-## Migration Guide
-
-### From `cmd/micro/server/gateway.go`
-
-**Before:**
-```go
-import "go-micro.dev/v5/cmd/micro/server"
-
-gw, err := server.StartGateway(server.GatewayOptions{
-    Address: ":8080",
-    AuthEnabled: true,
-    Store: myStore,
-})
-```
-
-**After:**
-```go
-import "go-micro.dev/v5/gateway/api"
-
-gw, err := api.New(api.Options{
-    Address: ":8080",
-    AuthEnabled: true,
-    HandlerRegistrar: func(mux *http.ServeMux) error {
-        // Register your handlers
-        // Pass store as closure
-        return registerHandlers(mux, myStore)
-    },
-})
-```
-
-## Examples
-
-See:
- `cmd/micro/server/gateway.go` - Production gateway with auth
- `cmd/micro/run/run.go` - Development gateway without auth
- `examples/gateway/` - Custom gateway examples (coming soon)
-
-## License
-
-Apache 2.0
@@ -1,155 +0,0 @@
-// Package api provides HTTP API gateway functionality for go-micro services.
-//
-// The API gateway translates HTTP requests into RPC calls and serves a web dashboard
-// for browsing and calling services. It can be used in development (micro run) or
-// production (micro server) with optional authentication.
-package api
-
-import (
-	"context"
-	"fmt"
-	"log"
-	"net/http"
-	"time"
-
-	"go-micro.dev/v5/gateway/mcp"
-	"go-micro.dev/v5/registry"
-)
-
-// Options configures the HTTP API gateway
-type Options struct {
-	// Address to listen on (e.g., ":8080")
-	Address string
-
-	// AuthEnabled controls whether authentication is required
-	// If true, the HandlerRegistrar should include auth middleware
-	AuthEnabled bool
-
-	// Context for cancellation (if nil, uses background context)
-	Context context.Context
-
-	// Logger for gateway messages (if nil, uses log.Default())
-	Logger *log.Logger
-
-	// HandlerRegistrar is called to register HTTP handlers on the mux
-	// This allows different configurations (dev vs prod) to register different handlers
-	HandlerRegistrar func(mux *http.ServeMux) error
-
-	// MCPEnabled controls whether to start MCP gateway
-	MCPEnabled bool
-
-	// MCPAddress is the address for MCP gateway (e.g., ":3000")
-	MCPAddress string
-
-	// Registry for service discovery (if nil, uses registry.DefaultRegistry)
-	Registry registry.Registry
-}
-
-// Gateway represents a running HTTP API gateway server
-type Gateway struct {
-	opts   Options
-	server *http.Server
-	mux    *http.ServeMux
-}
-
-// New creates a new gateway with the given options and starts it.
-// Returns immediately after starting the server in a goroutine.
-// Use Wait() or Run() to block until the server stops.
-func New(opts Options) (*Gateway, error) {
-	// Set defaults
-	if opts.Address == "" {
-		opts.Address = ":8080"
-	}
-	if opts.Context == nil {
-		opts.Context = context.Background()
-	}
-	if opts.Logger == nil {
-		opts.Logger = log.Default()
-	}
-	if opts.Registry == nil {
-		opts.Registry = registry.DefaultRegistry
-	}
-
-	// Create a new mux for this gateway instance
-	mux := http.NewServeMux()
-
-	// Register handlers using the provided registrar
-	if opts.HandlerRegistrar != nil {
-		if err := opts.HandlerRegistrar(mux); err != nil {
-			return nil, fmt.Errorf("failed to register handlers: %w", err)
-		}
-	}
-
-	// Create HTTP server
-	server := &http.Server{
-		Addr:    opts.Address,
-		Handler: mux,
-	}
-
-	gw := &Gateway{
-		opts:   opts,
-		server: server,
-		mux:    mux,
-	}
-
-	// Start MCP gateway if enabled
-	if opts.MCPEnabled && opts.MCPAddress != "" {
-		go func() {
-			if err := mcp.ListenAndServe(opts.MCPAddress, mcp.Options{
-				Registry: opts.Registry,
-				Context:  opts.Context,
-				Logger:   opts.Logger,
-			}); err != nil {
-				opts.Logger.Printf("[mcp] MCP gateway error: %v", err)
-			}
-		}()
-		opts.Logger.Printf("[mcp] MCP gateway enabled on %s", opts.MCPAddress)
-	}
-
-	// Start server in background
-	go func() {
-		opts.Logger.Printf("[gateway] Listening on %s (auth: %v)", opts.Address, opts.AuthEnabled)
-		if err := server.ListenAndServe(); err != nil && err != http.ErrServerClosed {
-			opts.Logger.Printf("[gateway] Server error: %v", err)
-		}
-	}()
-
-	return gw, nil
-}
-
-// Run creates and starts a gateway, blocking until it stops.
-// This is a convenience function equivalent to New() + Wait().
-func Run(opts Options) error {
-	gw, err := New(opts)
-	if err != nil {
-		return err
-	}
-	return gw.Wait()
-}
-
-// Wait blocks until the server is shut down
-func (g *Gateway) Wait() error {
-	<-g.opts.Context.Done()
-	return g.Stop()
-}
-
-// Stop gracefully shuts down the gateway
-func (g *Gateway) Stop() error {
-	if g.server != nil {
-		ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
-		defer cancel()
-		return g.server.Shutdown(ctx)
-	}
-	return nil
-}
-
-// Addr returns the address the gateway is listening on
-func (g *Gateway) Addr() string {
-	return g.opts.Address
-}
-
-// Mux returns the underlying HTTP mux for this gateway
-// This can be used to register additional handlers after creation
-func (g *Gateway) Mux() *http.ServeMux {
-	return g.mux
-}
@@ -1,402 +0,0 @@
-# MCP Tool Documentation
-
-This document explains how to document your go-micro services so that AI agents can understand them better.
-
-## Overview
-
-The MCP gateway automatically exposes your microservices as tools that AI agents (like Claude) can call. By adding proper documentation to your service handlers, you help agents understand:
-
- **What the tool does** - The purpose and behavior
- **What parameters it needs** - Types, formats, constraints
- **What it returns** - Response structure and meaning
- **How to use it** - Example inputs and outputs
-
-## Documentation Methods
-
-go-micro **automatically extracts documentation** from your Go doc comments at registration time. You don't need to write any extra code!
-
-### 1. Go Doc Comments (Automatic - Recommended)
-
-Just write standard Go documentation comments on your handler methods:
-
-```go
-// GetUser retrieves a user by ID from the database. Returns full profile including email, name, and preferences.
-//
-// @example {"id": "user-1"}
-func (s *UserService) GetUser(ctx context.Context, req *GetUserRequest, rsp *GetUserResponse) error {
-    // implementation
-}
-```
-
-When you register the handler, go-micro automatically:
- Extracts the doc comment as the tool description
- Parses the `@example` tag for example inputs
- Registers everything in the service registry
- Makes it available to the MCP gateway
-
-**Supported Tags:**
- `@example <json>` - Example JSON input (highly recommended for AI agents)
-
-**That's it!** No extra registration code needed:
-
-```go
-// Documentation is extracted automatically from method comments
-handler := service.Server().NewHandler(new(UserService))
-service.Server().Handle(handler)
-```
-
-### 2. Manual Registration (Optional Override)
-
-For more control or to override auto-extracted docs, use `server.WithEndpointDocs()`:
-
-```go
-handler := service.Server().NewHandler(
-    new(UserService),
-    server.WithEndpointDocs(map[string]server.EndpointDoc{
-        "UserService.GetUser": {
-            Description: "Custom description that overrides the comment",
-            Example:     `{"id": "user-123"}`,
-        },
-    }),
-)
-```
-
-Manual metadata **takes precedence** over auto-extracted comments.
-
-### 3. Endpoint Scopes (Auth)
-
-Use `server.WithEndpointScopes()` to declare the auth scopes required for each
-endpoint. The MCP gateway reads these from the registry and enforces them when
-an `Auth` provider is configured.
-
-```go
-handler := service.Server().NewHandler(
-    new(BlogService),
-    server.WithEndpointScopes("Blog.Create", "blog:write"),
-    server.WithEndpointScopes("Blog.Delete", "blog:write", "blog:admin"),
-    server.WithEndpointScopes("Blog.Read", "blog:read"),
-)
-```
-
-Scopes are stored as comma-separated values in endpoint metadata (`"scopes"` key)
-and are propagated through the service registry just like descriptions and examples.
-
-#### Gateway-Level Scope Overrides
-
-An operator can also define or override scopes at the MCP gateway without
-modifying individual services. This is useful for centralized policy management:
-
-```go
-mcp.Serve(mcp.Options{
-    Registry: reg,
-    Auth:     authProvider,
-    Scopes: map[string][]string{
-        "blog.Blog.Create": {"blog:write"},
-        "blog.Blog.Delete": {"blog:admin"},
-    },
-})
-```
-
-Gateway-level scopes **take precedence** over service-level scopes.
-
-### 4. Struct Tags (For Field Descriptions)
-
-Add descriptions to struct fields using the `description` tag:
-
-```go
-type User struct {
-    ID    string `json:"id" description:"User's unique identifier (UUID format)"`
-    Name  string `json:"name" description:"User's full name"`
-    Email string `json:"email" description:"User's email address"`
-    Age   int    `json:"age,omitempty" description:"User's age (optional)"`
-}
-```
-
-The `description` tag is used to generate parameter descriptions in the JSON Schema.
-
-## How It Works
-
-### Automatic Extraction Pipeline
-
-```
-1. Handler Registration (Your Service)
-   ├─> You write Go doc comments on methods
-   ├─> Call service.Server().NewHandler(yourHandler)
-   └─> go-micro automatically parses source files using go/ast
-
-2. Documentation Extraction (Automatic)
-   ├─> Read Go doc comments from handler method source
-   ├─> Parse @example tags for sample inputs
-   ├─> Extract struct tag descriptions
-   └─> Merge with any manual metadata (manual wins)
-
-3. Service Registry
-   ├─> Store endpoint metadata in registry.Endpoint.Metadata
-   ├─> Metadata distributed with service information
-   └─> Available to all components (gateway, discovery, etc.)
-
-4. MCP Gateway Discovery
-   ├─> Query registry for services and endpoints
-   ├─> Read description and example from endpoint.Metadata
-   └─> Generate JSON Schema with documentation
-
-5. Tool Creation
-   └─> Create MCP tool with rich description for AI agents
-```
-
-### Example Output
-
-For a documented handler, the MCP gateway generates:
-
-```json
-{
-  "name": "users.UserService.GetUser",
-  "description": "GetUser retrieves a user by ID from the database. Returns full profile including email, name, and preferences.",
-  "inputSchema": {
-    "type": "object",
-    "description": "This endpoint fetches a user's complete profile...",
-    "properties": {
-      "id": {
-        "type": "string",
-        "description": "User ID in UUID format (e.g., \"123e4567-e89b-12d3-a456-426614174000\")"
-      }
-    },
-    "required": ["id"],
-    "examples": [
-      "{\"id\": \"user-1\"}"
-    ]
-  }
-}
-```
-
-## Best Practices
-
-### Write for AI, Not Just Humans
-
-AI agents parse your documentation literally. Be explicit:
-
-**✅ Good:**
-```go
-// GetUser retrieves a user by their unique ID from the database.
-// Returns the user's full profile including name, email, and preferences.
-// If the user doesn't exist, returns an error with status 404.
-//
-// @param id {string} User ID in UUID v4 format (e.g., "123e4567-e89b-12d3-a456-426614174000")
-// @return {User} User object with all profile fields populated
-```
-
-**❌ Bad:**
-```go
-// Gets a user
-func GetUser(...) // No details, no context
-```
-
-### Specify Formats and Constraints
-
-Tell agents exactly what format you expect:
-
-**✅ Good:**
-```go
-// @param email {string} Email address in RFC 5322 format (must contain @ and domain)
-// @param age {number} User's age (integer between 0-150)
-// @param phone {string} Phone number in E.164 format (e.g., "+14155552671")
-```
-
-**❌ Bad:**
-```go
-// @param email {string} The email
-// @param age {number} Age
-```
-
-### Provide Real Examples
-
-Show agents actual valid inputs:
-
-**✅ Good:**
-```go
-// @example
-//   {
-//     "name": "Alice Smith",
-//     "email": "alice@example.com",
-//     "age": 30,
-//     "phone": "+14155552671"
-//   }
-```
-
-**❌ Bad:**
-```go
-// @example
-//   {
-//     "name": "string",
-//     "email": "string"
-//   }
-```
-
-### Document Error Cases
-
-Tell agents what can go wrong:
-
-```go
-// GetUser retrieves a user by ID.
-//
-// Returns error if:
-// - User ID is not a valid UUID
-// - User does not exist (404)
-// - Database is unavailable (503)
-//
-// @param id {string} User ID in UUID format
-```
-
-### Use Descriptive Names
-
-Field names should be self-explanatory:
-
-**✅ Good:**
-```go
-type CreateUserRequest struct {
-    FullName      string `json:"full_name" description:"User's complete name"`
-    EmailAddress  string `json:"email_address" description:"Primary email for contact"`
-    DateOfBirth   string `json:"date_of_birth" description:"Birth date in YYYY-MM-DD format"`
-}
-```
-
-**❌ Bad:**
-```go
-type CreateUserRequest struct {
-    N string `json:"n"` // What is n?
-    E string `json:"e"` // What is e?
-    D string `json:"d"` // What is d?
-}
-```
-
-## Impact on Agent Performance
-
-### Without Documentation
-
-```
-Agent: "I need to call GetUser but I don't know what format the ID should be.
-        Is it a number? A string? A UUID? Let me try..."
-
-❌ Calls with: {"id": 123}
-❌ Calls with: {"id": "user123"}
-❌ Calls with: {"id": "abc"}
-✅ Calls with: {"id": "550e8400-e29b-41d4-a716-446655440000"} (after 4 attempts)
-```
-
-### With Documentation
-
-```
-Agent: "GetUser needs an ID in UUID format. The example shows the format.
-        I'll use a valid UUID."
-
-✅ Calls with: {"id": "550e8400-e29b-41d4-a716-446655440000"} (first attempt)
-```
-
-**Result:**
- **75% fewer failed calls**
- **Faster task completion**
- **Better user experience**
-
-## Parser Implementation
-
-The MCP gateway uses several parsers:
-
-### 1. Go Doc Parser (`parseServiceDocs`)
- Extracts godoc comments from handler methods
- Parses JSDoc-style tags
- Returns `ToolDescription` struct
-
-### 2. Struct Tag Parser (`ParseStructTags`)
- Reads `description` tags from struct fields
- Generates JSON Schema with field descriptions
- Marks required vs optional fields (omitempty)
-
-### 3. Comment Parser (`ParseGoDocComment`)
- Regex-based extraction of @param, @return, @example tags
- Splits summary from detailed description
- Builds structured documentation
-
-### 4. Type Mapper (`reflectTypeToJSONType`)
- Converts Go types to JSON Schema types
- Handles: string, int, float, bool, array, object
- Used for automatic schema generation
-
-## Examples
-
-See complete examples in:
- `examples/mcp/documented/` - Fully documented service
- `examples/auth/` - Auth service with documentation
- `examples/hello-world/` - Basic service
-
-## Testing Documentation
-
-### 1. List Tools
-
-```bash
-curl http://localhost:3000/mcp/tools | jq '.tools[0]'
-```
-
-Verify the description and schema are correct.
-
-### 2. Use with Claude Code
-
-Add to your Claude Code config and ask Claude to use your service. Claude will show you how it interprets your documentation.
-
-### 3. Check Examples Work
-
-Try the examples from your `@example` tags:
-
-```bash
-curl -X POST http://localhost:3000/mcp/call \
-  -H "Content-Type: application/json" \
-  -d '{
-    "tool": "users.UserService.GetUser",
-    "input": <your-example-json>
-  }'
-```
-
-## Future Enhancements
-
-Planned improvements:
-
- [ ] Auto-extract examples from test files
- [ ] Validate documentation completeness (lint)
- [ ] Generate documentation from OpenAPI specs
- [ ] Support custom validation rules in tags
- [ ] Interactive documentation editor
-
-## FAQ
-
-**Q: Do I need to document every field?**
-A: Document fields that are ambiguous or have constraints. Self-explanatory fields can rely on the field name.
-
-**Q: Will this slow down my service?**
-A: No. Documentation is parsed once at startup when the MCP gateway discovers services.
-
-**Q: Can I use OpenAPI/Swagger specs instead?**
-A: Not yet, but it's planned. For now, use Go comments and struct tags.
-
-**Q: What if I don't document my handlers?**
-A: The MCP gateway will still work, generating basic descriptions from method names and types. But agents will perform better with documentation.
-
-**Q: How do I know if my documentation is good?**
-A: Test it with Claude Code. If Claude understands your service and calls it correctly on the first try, your documentation is good!
-
-**Q: How do I add auth scopes to my endpoints?**
-A: Use `server.WithEndpointScopes()` when registering your handler:
-
-```go
-handler := service.Server().NewHandler(
-    new(MyService),
-    server.WithEndpointScopes("MyService.Create", "write"),
-)
-```
-
-Or define scopes at the gateway level using `Scopes` in `mcp.Options`.
-
-**Q: Can I set scopes at the gateway without changing services?**
-A: Yes. Use the `Scopes` option on `mcp.Options` to define or override scopes for any tool at the gateway layer. This is useful for centralized policy management.
-
-## License
-
-Apache 2.0
@@ -1,126 +0,0 @@
-package mcp
-
-import (
-	"context"
-	"fmt"
-	"log"
-	"net/http"
-
-	"go-micro.dev/v5"
-	"go-micro.dev/v5/auth/jwt"
-	"go-micro.dev/v5/registry"
-)
-
-// Example_inlineGateway shows how to add MCP gateway to an existing service
-func Example_inlineGateway() {
-	service := micro.NewService(micro.Name("myservice"))
-	service.Init()
-
-	// Add MCP gateway alongside your service
-	go func() {
-		if err := Serve(Options{
-			Registry: service.Options().Registry,
-			Address:  ":3000",
-		}); err != nil {
-			log.Fatal(err)
-		}
-	}()
-
-	// Run your service normally
-	service.Run()
-}
-
-// Example_standaloneGateway shows how to run MCP gateway as a separate service
-func Example_standaloneGateway() {
-	// Standalone MCP gateway
-	// Discovers all services via registry
-	if err := ListenAndServe(":3000", Options{
-		Registry: registry.NewMDNSRegistry(),
-	}); err != nil {
-		log.Fatal(err)
-	}
-}
-
-// Example_withAuthentication shows how to add authentication
-func Example_withAuthentication() {
-	service := micro.NewService(micro.Name("myservice"))
-	service.Init()
-
-	go func() {
-		if err := Serve(Options{
-			Registry: service.Options().Registry,
-			Address:  ":3000",
-			AuthFunc: func(r *http.Request) error {
-				token := r.Header.Get("Authorization")
-				if token == "" {
-					return fmt.Errorf("missing authorization header")
-				}
-				// Validate token here
-				return nil
-			},
-		}); err != nil {
-			log.Fatal(err)
-		}
-	}()
-
-	service.Run()
-}
-
-// Example_customContext shows how to use a custom context for graceful shutdown
-func Example_customContext() {
-	ctx, cancel := context.WithCancel(context.Background())
-	defer cancel()
-
-	service := micro.NewService(micro.Name("myservice"))
-	service.Init()
-
-	go func() {
-		if err := Serve(Options{
-			Registry: service.Options().Registry,
-			Address:  ":3000",
-			Context:  ctx,
-		}); err != nil {
-			log.Fatal(err)
-		}
-	}()
-
-	service.Run()
-	// cancel() will stop the MCP gateway
-}
-
-// Example_withScopesAndTracing shows how to add per-tool scopes, tracing, rate
-// limiting and audit logging to the MCP gateway. Services register scope
-// requirements via endpoint metadata ("scopes" key, comma-separated).
-func Example_withScopesAndTracing() {
-	service := micro.NewService(micro.Name("blog"))
-	service.Init()
-
-	// Use JWT auth provider
-	authProvider := jwt.NewAuth()
-
-	go func() {
-		if err := Serve(Options{
-			Registry: service.Options().Registry,
-			Address:  ":3000",
-
-			// Auth inspects Bearer tokens and enforces per-tool scopes
-			Auth: authProvider,
-
-			// Rate limit all tools to 10 req/s with burst of 20
-			RateLimit: &RateLimitConfig{
-				RequestsPerSecond: 10,
-				Burst:             20,
-			},
-
-			// Audit every tool call for compliance
-			AuditFunc: func(r AuditRecord) {
-				log.Printf("[audit] trace=%s tool=%s account=%s allowed=%v reason=%s",
-					r.TraceID, r.Tool, r.AccountID, r.Allowed, r.DeniedReason)
-			},
-		}); err != nil {
-			log.Fatal(err)
-		}
-	}()
-
-	service.Run()
-}
@@ -1,630 +0,0 @@
-// Package mcp provides Model Context Protocol (MCP) gateway functionality for go-micro services.
-// It automatically exposes your microservices as AI-accessible tools through MCP.
-//
-// Example usage:
-//
-//	service := micro.NewService(micro.Name("myservice"))
-//	service.Init()
-//
-//	// Add MCP gateway
-//	go mcp.Serve(mcp.Options{
-//		Registry: service.Options().Registry,
-//		Address:  ":3000",
-//	})
-//
-//	service.Run()
-package mcp
-
-import (
-	"context"
-	"encoding/json"
-	"fmt"
-	"log"
-	"net/http"
-	"strings"
-	"sync"
-	"time"
-
-	"go-micro.dev/v5/auth"
-	"go-micro.dev/v5/client"
-	"go-micro.dev/v5/codec/bytes"
-	"go-micro.dev/v5/metadata"
-	"go-micro.dev/v5/registry"
-
-	"github.com/google/uuid"
-)
-
-// Metadata keys for MCP tracing and auth propagated via context/metadata.
-const (
-	// TraceIDKey is the metadata key for the MCP trace ID.
-	TraceIDKey = "Mcp-Trace-Id"
-	// ToolNameKey is the metadata key for the tool being invoked.
-	ToolNameKey = "Mcp-Tool-Name"
-	// AccountIDKey is the metadata key for the authenticated account ID.
-	AccountIDKey = "Mcp-Account-Id"
-)
-
-// AuditRecord represents an immutable log entry for an MCP tool call.
-type AuditRecord struct {
-	// TraceID uniquely identifies this tool call chain.
-	TraceID string `json:"trace_id"`
-	// Timestamp of the tool call.
-	Timestamp time.Time `json:"timestamp"`
-	// Tool is the name of the tool that was called.
-	Tool string `json:"tool"`
-	// AccountID is the ID of the authenticated account (empty if unauthenticated).
-	AccountID string `json:"account_id,omitempty"`
-	// Scopes that were required for this tool.
-	ScopesRequired []string `json:"scopes_required,omitempty"`
-	// Allowed indicates whether the call was authorized.
-	Allowed bool `json:"allowed"`
-	// Denied reason, if the call was not allowed.
-	DeniedReason string `json:"denied_reason,omitempty"`
-	// Duration of the RPC call (zero if call was denied before execution).
-	Duration time.Duration `json:"duration,omitempty"`
-	// Error from the RPC call, if any.
-	Error string `json:"error,omitempty"`
-}
-
-// AuditFunc is called for every tool call with an audit record.
-// Implementations should treat the record as immutable and persist it
-// (e.g. to a log, database, or event stream).
-type AuditFunc func(record AuditRecord)
-
-// RateLimitConfig configures rate limiting for the MCP gateway.
-type RateLimitConfig struct {
-	// Requests per second allowed per tool (0 = unlimited).
-	RequestsPerSecond float64
-	// Burst size (maximum number of requests that can be made at once).
-	Burst int
-}
-
-// Options configures the MCP gateway
-type Options struct {
-	// Registry for service discovery (required)
-	Registry registry.Registry
-
-	// Address to listen on for SSE transport (e.g., ":3000")
-	// Leave empty for stdio transport
-	Address string
-
-	// Client for making RPC calls (defaults to client.DefaultClient)
-	Client client.Client
-
-	// Context for cancellation (defaults to background context)
-	Context context.Context
-
-	// Logger for debug output (defaults to log.Default())
-	Logger *log.Logger
-
-	// AuthFunc validates requests (optional, legacy)
-	// Return error to reject, nil to allow
-	AuthFunc func(r *http.Request) error
-
-	// Auth provider for token inspection (optional).
-	// When set, incoming requests must carry a Bearer token which is
-	// inspected to obtain an account. The account's scopes are then
-	// checked against the tool's required scopes.
-	Auth auth.Auth
-
-	// AuditFunc is called for every tool call with an immutable audit record.
-	// Use this to persist tool-call logs for compliance and debugging.
-	AuditFunc AuditFunc
-
-	// RateLimit configures per-tool rate limiting.
-	// When set, each tool is limited to the configured requests per second.
-	RateLimit *RateLimitConfig
-
-	// Scopes lets the gateway operator define or override per-tool
-	// scope requirements without changing the services themselves.
-	// Keys are tool names (e.g. "blog.Blog.Create") and values are the
-	// required scopes. When a tool appears in Scopes its scopes
-	// replace any scopes declared by the service via endpoint metadata.
-	//
-	// Example:
-	//
-	//   Scopes: map[string][]string{
-	//       "blog.Blog.Create": {"blog:write"},
-	//       "blog.Blog.Delete": {"blog:admin"},
-	//   }
-	Scopes map[string][]string
-}
-
-// Server represents a running MCP gateway
-type Server struct {
-	opts     Options
-	tools    map[string]*Tool
-	toolsMu  sync.RWMutex
-	server   *http.Server
-	watching bool
-
-	// limiters holds per-tool rate limiters (nil if rate limiting is disabled).
-	limiters   map[string]*rateLimiter
-	limitersMu sync.RWMutex
-}
-
-// Tool represents an MCP tool (exposed service endpoint)
-type Tool struct {
-	Name        string                 `json:"name"`
-	Description string                 `json:"description"`
-	InputSchema map[string]interface{} `json:"inputSchema"`
-	// Scopes lists the auth scopes required to call this tool.
-	// An empty list means no scope restriction (subject to Auth provider).
-	Scopes   []string `json:"scopes,omitempty"`
-	Service  string   `json:"-"`
-	Endpoint string   `json:"-"`
-}
-
-// Serve starts an MCP gateway with the given options.
-// For stdio transport, leave Address empty.
-// For SSE transport, set Address (e.g., ":3000").
-func Serve(opts Options) error {
-	// Set defaults
-	if opts.Client == nil {
-		opts.Client = client.DefaultClient
-	}
-	if opts.Context == nil {
-		opts.Context = context.Background()
-	}
-	if opts.Logger == nil {
-		opts.Logger = log.Default()
-	}
-	if opts.Registry == nil {
-		return fmt.Errorf("registry is required")
-	}
-
-	server := &Server{
-		opts:     opts,
-		tools:    make(map[string]*Tool),
-		limiters: make(map[string]*rateLimiter),
-	}
-
-	// Discover services and build tool list
-	if err := server.discoverServices(); err != nil {
-		return fmt.Errorf("failed to discover services: %w", err)
-	}
-
-	// Watch for service changes
-	go server.watchServices()
-
-	// Start server based on transport
-	if opts.Address != "" {
-		return server.serveHTTP()
-	}
-	return server.serveStdio()
-}
-
-// ListenAndServe is a convenience function that starts an MCP gateway on the given address.
-func ListenAndServe(address string, opts Options) error {
-	opts.Address = address
-	return Serve(opts)
-}
-
-// discoverServices queries the registry and builds the tool list
-func (s *Server) discoverServices() error {
-	services, err := s.opts.Registry.ListServices()
-	if err != nil {
-		return err
-	}
-
-	s.toolsMu.Lock()
-	defer s.toolsMu.Unlock()
-
-	for _, svc := range services {
-		// Get full service details
-		fullSvcs, err := s.opts.Registry.GetService(svc.Name)
-		if err != nil || len(fullSvcs) == 0 {
-			continue
-		}
-
-		// Convert endpoints to tools
-		for _, ep := range fullSvcs[0].Endpoints {
-			toolName := fmt.Sprintf("%s.%s", svc.Name, ep.Name)
-
-			// Build input schema from endpoint request type
-			inputSchema := s.buildInputSchema(ep.Request)
-
-			// Get description from endpoint metadata (set by service during registration)
-			description := fmt.Sprintf("Call %s on %s service", ep.Name, svc.Name)
-			if ep.Metadata != nil {
-				if desc, ok := ep.Metadata["description"]; ok && desc != "" {
-					description = desc
-				}
-			}
-
-			tool := &Tool{
-				Name:        toolName,
-				Description: description,
-				InputSchema: inputSchema,
-				Service:     svc.Name,
-				Endpoint:    ep.Name,
-			}
-
-			// Extract scopes from endpoint metadata
-			if ep.Metadata != nil {
-				if scopes, ok := ep.Metadata["scopes"]; ok && scopes != "" {
-					tool.Scopes = strings.Split(scopes, ",")
-				}
-			}
-
-			// Gateway-level Scopes override service-level scopes
-			if s.opts.Scopes != nil {
-				if scopes, ok := s.opts.Scopes[toolName]; ok {
-					tool.Scopes = scopes
-				}
-			}
-
-			// Add example from metadata if available
-			if ep.Metadata != nil {
-				if example, ok := ep.Metadata["example"]; ok && example != "" {
-					inputSchema["examples"] = []string{example}
-				}
-			}
-
-			s.tools[toolName] = tool
-
-			// Create rate limiter for this tool if rate limiting is configured
-			if s.opts.RateLimit != nil && s.opts.RateLimit.RequestsPerSecond > 0 {
-				s.limitersMu.Lock()
-				if _, exists := s.limiters[toolName]; !exists {
-					s.limiters[toolName] = newRateLimiter(
-						s.opts.RateLimit.RequestsPerSecond,
-						s.opts.RateLimit.Burst,
-					)
-				}
-				s.limitersMu.Unlock()
-			}
-		}
-	}
-
-	s.opts.Logger.Printf("[mcp] Discovered %d tools from %d services", len(s.tools), len(services))
-	return nil
-}
-
-// buildInputSchema converts registry value type information to JSON schema
-func (s *Server) buildInputSchema(value *registry.Value) map[string]interface{} {
-	schema := map[string]interface{}{
-		"type":       "object",
-		"properties": make(map[string]interface{}),
-	}
-
-	if value == nil || len(value.Values) == 0 {
-		return schema
-	}
-
-	properties := schema["properties"].(map[string]interface{})
-	for _, field := range value.Values {
-		properties[field.Name] = map[string]interface{}{
-			"type":        s.mapGoTypeToJSON(field.Type),
-			"description": fmt.Sprintf("%s field", field.Name),
-		}
-	}
-
-	return schema
-}
-
-// mapGoTypeToJSON maps Go types to JSON schema types
-func (s *Server) mapGoTypeToJSON(goType string) string {
-	switch goType {
-	case "string":
-		return "string"
-	case "int", "int32", "int64", "uint", "uint32", "uint64":
-		return "integer"
-	case "float32", "float64":
-		return "number"
-	case "bool":
-		return "boolean"
-	default:
-		return "object"
-	}
-}
-
-// watchServices watches for service registry changes
-func (s *Server) watchServices() {
-	if s.watching {
-		return
-	}
-	s.watching = true
-
-	watcher, err := s.opts.Registry.Watch()
-	if err != nil {
-		s.opts.Logger.Printf("[mcp] Failed to watch registry: %v", err)
-		return
-	}
-	defer watcher.Stop()
-
-	for {
-		select {
-		case <-s.opts.Context.Done():
-			return
-		default:
-			_, err := watcher.Next()
-			if err != nil {
-				time.Sleep(time.Second)
-				continue
-			}
-
-			// Rediscover services on any change
-			if err := s.discoverServices(); err != nil {
-				s.opts.Logger.Printf("[mcp] Failed to rediscover services: %v", err)
-			}
-		}
-	}
-}
-
-// serveHTTP starts an HTTP server with SSE transport
-func (s *Server) serveHTTP() error {
-	mux := http.NewServeMux()
-
-	// MCP endpoints
-	mux.HandleFunc("/mcp/tools", s.handleListTools)
-	mux.HandleFunc("/mcp/call", s.handleCallTool)
-	mux.HandleFunc("/health", s.handleHealth)
-
-	s.server = &http.Server{
-		Addr:    s.opts.Address,
-		Handler: mux,
-	}
-
-	s.opts.Logger.Printf("[mcp] MCP gateway listening on %s", s.opts.Address)
-	return s.server.ListenAndServe()
-}
-
-// serveStdio starts stdio-based MCP server (for Claude Code, etc.)
-func (s *Server) serveStdio() error {
-	transport := NewStdioTransport(s)
-	return transport.Serve()
-}
-
-// handleListTools returns the list of available tools
-func (s *Server) handleListTools(w http.ResponseWriter, r *http.Request) {
-	if s.opts.AuthFunc != nil {
-		if err := s.opts.AuthFunc(r); err != nil {
-			http.Error(w, "Unauthorized", http.StatusUnauthorized)
-			return
-		}
-	}
-
-	s.toolsMu.RLock()
-	tools := make([]*Tool, 0, len(s.tools))
-	for _, tool := range s.tools {
-		tools = append(tools, tool)
-	}
-	s.toolsMu.RUnlock()
-
-	w.Header().Set("Content-Type", "application/json")
-	json.NewEncoder(w).Encode(map[string]interface{}{
-		"tools": tools,
-	})
-}
-
-// handleCallTool executes a tool (makes an RPC call)
-func (s *Server) handleCallTool(w http.ResponseWriter, r *http.Request) {
-	if s.opts.AuthFunc != nil {
-		if err := s.opts.AuthFunc(r); err != nil {
-			http.Error(w, "Unauthorized", http.StatusUnauthorized)
-			return
-		}
-	}
-
-	// Parse request
-	var req struct {
-		Tool  string                 `json:"tool"`
-		Input map[string]interface{} `json:"input"`
-	}
-	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
-		http.Error(w, err.Error(), http.StatusBadRequest)
-		return
-	}
-
-	// Get tool info
-	s.toolsMu.RLock()
-	tool, exists := s.tools[req.Tool]
-	s.toolsMu.RUnlock()
-
-	if !exists {
-		http.Error(w, "Tool not found", http.StatusNotFound)
-		return
-	}
-
-	// Generate trace ID for this call
-	traceID := uuid.New().String()
-
-	// Authenticate and authorise
-	var account *auth.Account
-	if s.opts.Auth != nil {
-		token := r.Header.Get("Authorization")
-		if strings.HasPrefix(token, "Bearer ") {
-			token = strings.TrimPrefix(token, "Bearer ")
-		}
-		if token == "" {
-			s.audit(AuditRecord{TraceID: traceID, Timestamp: time.Now(), Tool: req.Tool, Allowed: false, DeniedReason: "missing token"})
-			http.Error(w, "Unauthorized", http.StatusUnauthorized)
-			return
-		}
-		acc, err := s.opts.Auth.Inspect(token)
-		if err != nil {
-			s.audit(AuditRecord{TraceID: traceID, Timestamp: time.Now(), Tool: req.Tool, Allowed: false, DeniedReason: "invalid token"})
-			http.Error(w, "Unauthorized", http.StatusUnauthorized)
-			return
-		}
-		account = acc
-
-		// Check per-tool scopes
-		if len(tool.Scopes) > 0 {
-			if !hasScope(account.Scopes, tool.Scopes) {
-				s.audit(AuditRecord{
-					TraceID: traceID, Timestamp: time.Now(), Tool: req.Tool,
-					AccountID: account.ID, ScopesRequired: tool.Scopes,
-					Allowed: false, DeniedReason: "insufficient scopes",
-				})
-				http.Error(w, "Forbidden: insufficient scopes", http.StatusForbidden)
-				return
-			}
-		}
-	}
-
-	// Rate limit check
-	if err := s.allowRate(req.Tool); err != nil {
-		accountID := ""
-		if account != nil {
-			accountID = account.ID
-		}
-		s.audit(AuditRecord{
-			TraceID: traceID, Timestamp: time.Now(), Tool: req.Tool,
-			AccountID: accountID, Allowed: false, DeniedReason: "rate limited",
-		})
-		http.Error(w, "Rate limit exceeded", http.StatusTooManyRequests)
-		return
-	}
-
-	// Build context with tracing metadata
-	ctx := r.Context()
-	md := metadata.Metadata{}
-	md.Set(TraceIDKey, traceID)
-	md.Set(ToolNameKey, req.Tool)
-	if account != nil {
-		md.Set(AccountIDKey, account.ID)
-	}
-	ctx = metadata.MergeContext(ctx, md, true)
-
-	// Convert input to JSON bytes for RPC call
-	inputBytes, err := json.Marshal(req.Input)
-	if err != nil {
-		http.Error(w, err.Error(), http.StatusInternalServerError)
-		return
-	}
-
-	// Make RPC call
-	start := time.Now()
-	rpcReq := s.opts.Client.NewRequest(tool.Service, tool.Endpoint, &bytes.Frame{Data: inputBytes})
-	var rsp bytes.Frame
-
-	if err := s.opts.Client.Call(ctx, rpcReq, &rsp); err != nil {
-		s.opts.Logger.Printf("[mcp] RPC call failed: %v", err)
-		accountID := ""
-		if account != nil {
-			accountID = account.ID
-		}
-		s.audit(AuditRecord{
-			TraceID: traceID, Timestamp: time.Now(), Tool: req.Tool,
-			AccountID: accountID, ScopesRequired: tool.Scopes,
-			Allowed: true, Duration: time.Since(start), Error: err.Error(),
-		})
-		http.Error(w, fmt.Sprintf("RPC call failed: %v", err), http.StatusInternalServerError)
-		return
-	}
-
-	// Audit successful call
-	accountID := ""
-	if account != nil {
-		accountID = account.ID
-	}
-	s.audit(AuditRecord{
-		TraceID: traceID, Timestamp: time.Now(), Tool: req.Tool,
-		AccountID: accountID, ScopesRequired: tool.Scopes,
-		Allowed: true, Duration: time.Since(start),
-	})
-
-	// Return response with trace ID
-	w.Header().Set("Content-Type", "application/json")
-	w.Header().Set(TraceIDKey, traceID)
-	json.NewEncoder(w).Encode(map[string]interface{}{
-		"result":   json.RawMessage(rsp.Data),
-		"trace_id": traceID,
-	})
-}
-
-// handleHealth returns gateway health status
-func (s *Server) handleHealth(w http.ResponseWriter, r *http.Request) {
-	s.toolsMu.RLock()
-	toolCount := len(s.tools)
-	s.toolsMu.RUnlock()
-
-	w.Header().Set("Content-Type", "application/json")
-	json.NewEncoder(w).Encode(map[string]interface{}{
-		"status": "ok",
-		"tools":  toolCount,
-	})
-}
-
-// Stop gracefully shuts down the MCP gateway
-func (s *Server) Stop() error {
-	if s.server != nil {
-		ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
-		defer cancel()
-		return s.server.Shutdown(ctx)
-	}
-	return nil
-}
-
-// GetTools returns the current list of available tools
-func (s *Server) GetTools() []*Tool {
-	s.toolsMu.RLock()
-	defer s.toolsMu.RUnlock()
-
-	tools := make([]*Tool, 0, len(s.tools))
-	for _, tool := range s.tools {
-		tools = append(tools, tool)
-	}
-	return tools
-}
-
-// audit emits an audit record if an AuditFunc is configured.
-func (s *Server) audit(record AuditRecord) {
-	if s.opts.AuditFunc != nil {
-		s.opts.AuditFunc(record)
-	}
-}
-
-// allowRate checks if the tool call is allowed under the configured rate limit.
-// Returns nil if allowed, non-nil error if rate-limited.
-func (s *Server) allowRate(toolName string) error {
-	if s.opts.RateLimit == nil {
-		return nil
-	}
-	s.limitersMu.RLock()
-	limiter, ok := s.limiters[toolName]
-	s.limitersMu.RUnlock()
-	if !ok {
-		return nil
-	}
-	if !limiter.Allow() {
-		return fmt.Errorf("rate limit exceeded for tool %s", toolName)
-	}
-	return nil
-}
-
-// hasScope checks if the account has at least one of the required scopes.
-func hasScope(accountScopes, requiredScopes []string) bool {
-	for _, req := range requiredScopes {
-		for _, have := range accountScopes {
-			if strings.EqualFold(have, req) {
-				return true
-			}
-		}
-	}
-	return false
-}
-
-// Example shows how to use the MCP gateway in your code
-func Example() {
-	// This function is never called - it's just documentation
-	_ = func() {
-		// In your service code:
-		// service := micro.NewService(micro.Name("myservice"))
-		// service.Init()
-
-		// Start MCP gateway
-		go func() {
-			if err := Serve(Options{
-				Registry: registry.DefaultRegistry,
-				Address:  ":3000",
-			}); err != nil {
-				log.Fatal(err)
-			}
-		}()
-
-		// service.Run()
-	}
-}
@@ -1,568 +0,0 @@
-package mcp
-
-import (
-	"bytes"
-	"context"
-	"encoding/json"
-	"log"
-	"net/http"
-	"net/http/httptest"
-	"sync"
-	"testing"
-	"time"
-
-	"go-micro.dev/v5/auth"
-	"go-micro.dev/v5/client"
-	"go-micro.dev/v5/registry"
-)
-
-// mockAuth implements auth.Auth for testing.
-type mockAuth struct {
-	accounts map[string]*auth.Account // token -> account
-}
-
-func (m *mockAuth) Init(...auth.Option)                         {}
-func (m *mockAuth) Options() auth.Options                       { return auth.Options{} }
-func (m *mockAuth) Generate(string, ...auth.GenerateOption) (*auth.Account, error) {
-	return nil, nil
-}
-func (m *mockAuth) Token(...auth.TokenOption) (*auth.Token, error) { return nil, nil }
-func (m *mockAuth) String() string                                 { return "mock" }
-
-func (m *mockAuth) Inspect(token string) (*auth.Account, error) {
-	acc, ok := m.accounts[token]
-	if !ok {
-		return nil, auth.ErrInvalidToken
-	}
-	return acc, nil
-}
-
-// newTestServer creates a Server with pre-populated tools for testing.
-func newTestServer(opts Options) *Server {
-	if opts.Logger == nil {
-		opts.Logger = testLogger()
-	}
-	if opts.Context == nil {
-		opts.Context = context.Background()
-	}
-	if opts.Client == nil {
-		opts.Client = client.DefaultClient
-	}
-	s := &Server{
-		opts:     opts,
-		tools:    make(map[string]*Tool),
-		limiters: make(map[string]*rateLimiter),
-	}
-	return s
-}
-
-// testLogger returns a silent logger for tests.
-func testLogger() *log.Logger {
-	return log.New(nopWriter{}, "", 0)
-}
-
-type nopWriter struct{}
-
-func (nopWriter) Write(p []byte) (int, error) { return len(p), nil }
-
-// --- Tests ---
-
-func TestHasScope(t *testing.T) {
-	tests := []struct {
-		name     string
-		account  []string
-		required []string
-		want     bool
-	}{
-		{"match single", []string{"blog:write"}, []string{"blog:write"}, true},
-		{"match one of many", []string{"blog:read", "blog:write"}, []string{"blog:write"}, true},
-		{"no match", []string{"blog:read"}, []string{"blog:write"}, false},
-		{"empty required", []string{"blog:read"}, nil, false},
-		{"empty account", nil, []string{"blog:write"}, false},
-		{"case insensitive", []string{"Blog:Write"}, []string{"blog:write"}, true},
-	}
-
-	for _, tt := range tests {
-		t.Run(tt.name, func(t *testing.T) {
-			got := hasScope(tt.account, tt.required)
-			if got != tt.want {
-				t.Errorf("hasScope(%v, %v) = %v, want %v", tt.account, tt.required, got, tt.want)
-			}
-		})
-	}
-}
-
-func TestToolScopesFromMetadata(t *testing.T) {
-	// Create a mock registry with endpoints that have scope metadata
-	reg := registry.NewMemoryRegistry()
-	svc := &registry.Service{
-		Name: "blog",
-		Nodes: []*registry.Node{{
-			Id:      "blog-1",
-			Address: "localhost:9090",
-		}},
-		Endpoints: []*registry.Endpoint{
-			{
-				Name: "Blog.Create",
-				Metadata: map[string]string{
-					"description": "Create a blog post",
-					"scopes":      "blog:write,blog:admin",
-				},
-			},
-			{
-				Name: "Blog.Read",
-				Metadata: map[string]string{
-					"description": "Read a blog post",
-				},
-			},
-		},
-	}
-	if err := reg.Register(svc); err != nil {
-		t.Fatal(err)
-	}
-
-	s := newTestServer(Options{Registry: reg})
-	if err := s.discoverServices(); err != nil {
-		t.Fatal(err)
-	}
-
-	// Check that scopes are populated
-	createTool := s.tools["blog.Blog.Create"]
-	if createTool == nil {
-		t.Fatal("expected tool blog.Blog.Create")
-	}
-	if len(createTool.Scopes) != 2 || createTool.Scopes[0] != "blog:write" || createTool.Scopes[1] != "blog:admin" {
-		t.Errorf("unexpected scopes: %v", createTool.Scopes)
-	}
-
-	readTool := s.tools["blog.Blog.Read"]
-	if readTool == nil {
-		t.Fatal("expected tool blog.Blog.Read")
-	}
-	if len(readTool.Scopes) != 0 {
-		t.Errorf("expected no scopes for read, got: %v", readTool.Scopes)
-	}
-}
-
-func TestHandleCallTool_AuthRequired(t *testing.T) {
-	ma := &mockAuth{
-		accounts: map[string]*auth.Account{
-			"valid-token": {ID: "user-1", Scopes: []string{"blog:write"}},
-			"readonly":    {ID: "user-2", Scopes: []string{"blog:read"}},
-		},
-	}
-
-	s := newTestServer(Options{Auth: ma})
-	s.tools["blog.Blog.Create"] = &Tool{
-		Name:     "blog.Blog.Create",
-		Service:  "blog",
-		Endpoint: "Blog.Create",
-		Scopes:   []string{"blog:write"},
-	}
-
-	tests := []struct {
-		name       string
-		token      string
-		wantStatus int
-	}{
-		{"no token", "", http.StatusUnauthorized},
-		{"invalid token", "bad-token", http.StatusUnauthorized},
-		{"valid token with scope", "valid-token", http.StatusInternalServerError}, // RPC will fail (no backend), but auth passes
-		{"valid token without scope", "readonly", http.StatusForbidden},
-	}
-
-	for _, tt := range tests {
-		t.Run(tt.name, func(t *testing.T) {
-			body, _ := json.Marshal(map[string]interface{}{
-				"tool":  "blog.Blog.Create",
-				"input": map[string]interface{}{"title": "hello"},
-			})
-			req := httptest.NewRequest("POST", "/mcp/call", bytes.NewReader(body))
-			if tt.token != "" {
-				req.Header.Set("Authorization", "Bearer "+tt.token)
-			}
-			rec := httptest.NewRecorder()
-			s.handleCallTool(rec, req)
-
-			if rec.Code != tt.wantStatus {
-				t.Errorf("status = %d, want %d, body: %s", rec.Code, tt.wantStatus, rec.Body.String())
-			}
-		})
-	}
-}
-
-func TestHandleCallTool_TraceID(t *testing.T) {
-	// Without Auth, tool calls should still generate trace IDs.
-	s := newTestServer(Options{})
-	s.tools["svc.Echo"] = &Tool{
-		Name:     "svc.Echo",
-		Service:  "svc",
-		Endpoint: "Echo",
-	}
-
-	body, _ := json.Marshal(map[string]interface{}{
-		"tool":  "svc.Echo",
-		"input": map[string]interface{}{},
-	})
-	req := httptest.NewRequest("POST", "/mcp/call", bytes.NewReader(body))
-	rec := httptest.NewRecorder()
-	s.handleCallTool(rec, req)
-
-	// Even though the RPC fails (no backend), the trace ID header should be absent
-	// only when the call didn't reach the RPC stage; but in this no-auth case it
-	// should reach the RPC call and fail. Check we get a response.
-	traceID := rec.Header().Get(TraceIDKey)
-	// The RPC call will fail but the error path doesn't set the header.
-	// For a successful call, the trace ID is set. Either way the audit should fire.
-	_ = traceID // trace ID may or may not be in error response header
-}
-
-func TestHandleCallTool_AuditFunc(t *testing.T) {
-	var mu sync.Mutex
-	var records []AuditRecord
-
-	auditFn := func(r AuditRecord) {
-		mu.Lock()
-		defer mu.Unlock()
-		records = append(records, r)
-	}
-
-	ma := &mockAuth{
-		accounts: map[string]*auth.Account{
-			"tok": {ID: "u1", Scopes: []string{"write"}},
-		},
-	}
-
-	s := newTestServer(Options{Auth: ma, AuditFunc: auditFn})
-	s.tools["svc.Do"] = &Tool{
-		Name:     "svc.Do",
-		Service:  "svc",
-		Endpoint: "Do",
-		Scopes:   []string{"write"},
-	}
-
-	body, _ := json.Marshal(map[string]interface{}{
-		"tool":  "svc.Do",
-		"input": map[string]interface{}{},
-	})
-	req := httptest.NewRequest("POST", "/mcp/call", bytes.NewReader(body))
-	req.Header.Set("Authorization", "Bearer tok")
-	rec := httptest.NewRecorder()
-	s.handleCallTool(rec, req)
-
-	mu.Lock()
-	defer mu.Unlock()
-
-	if len(records) == 0 {
-		t.Fatal("expected at least one audit record")
-	}
-	r := records[len(records)-1]
-	if r.AccountID != "u1" {
-		t.Errorf("audit AccountID = %q, want %q", r.AccountID, "u1")
-	}
-	if r.Tool != "svc.Do" {
-		t.Errorf("audit Tool = %q, want %q", r.Tool, "svc.Do")
-	}
-	if r.TraceID == "" {
-		t.Error("audit TraceID is empty")
-	}
-	if !r.Allowed {
-		t.Error("expected audit record Allowed = true")
-	}
-}
-
-func TestHandleCallTool_AuditDenied(t *testing.T) {
-	var mu sync.Mutex
-	var records []AuditRecord
-
-	auditFn := func(r AuditRecord) {
-		mu.Lock()
-		defer mu.Unlock()
-		records = append(records, r)
-	}
-
-	ma := &mockAuth{
-		accounts: map[string]*auth.Account{
-			"tok": {ID: "u1", Scopes: []string{"blog:read"}},
-		},
-	}
-
-	s := newTestServer(Options{Auth: ma, AuditFunc: auditFn})
-	s.tools["svc.Do"] = &Tool{
-		Name:     "svc.Do",
-		Service:  "svc",
-		Endpoint: "Do",
-		Scopes:   []string{"blog:write"},
-	}
-
-	body, _ := json.Marshal(map[string]interface{}{
-		"tool":  "svc.Do",
-		"input": map[string]interface{}{},
-	})
-	req := httptest.NewRequest("POST", "/mcp/call", bytes.NewReader(body))
-	req.Header.Set("Authorization", "Bearer tok")
-	rec := httptest.NewRecorder()
-	s.handleCallTool(rec, req)
-
-	if rec.Code != http.StatusForbidden {
-		t.Errorf("status = %d, want %d", rec.Code, http.StatusForbidden)
-	}
-
-	mu.Lock()
-	defer mu.Unlock()
-
-	if len(records) == 0 {
-		t.Fatal("expected audit record for denied call")
-	}
-	r := records[0]
-	if r.Allowed {
-		t.Error("expected Allowed = false")
-	}
-	if r.DeniedReason != "insufficient scopes" {
-		t.Errorf("DeniedReason = %q, want %q", r.DeniedReason, "insufficient scopes")
-	}
-}
-
-func TestRateLimiter(t *testing.T) {
-	rl := newRateLimiter(10, 2)
-
-	// First two should be allowed (burst)
-	if !rl.Allow() {
-		t.Error("first call should be allowed")
-	}
-	if !rl.Allow() {
-		t.Error("second call should be allowed (burst)")
-	}
-
-	// Third should be denied (burst exhausted, no time to refill)
-	if rl.Allow() {
-		t.Error("third call should be denied (burst exhausted)")
-	}
-
-	// Wait for refill
-	time.Sleep(150 * time.Millisecond)
-
-	// Should be allowed again
-	if !rl.Allow() {
-		t.Error("call after refill should be allowed")
-	}
-}
-
-func TestHandleCallTool_RateLimit(t *testing.T) {
-	var mu sync.Mutex
-	var records []AuditRecord
-
-	s := newTestServer(Options{
-		RateLimit: &RateLimitConfig{RequestsPerSecond: 1, Burst: 1},
-		AuditFunc: func(r AuditRecord) {
-			mu.Lock()
-			records = append(records, r)
-			mu.Unlock()
-		},
-	})
-	s.tools["svc.Do"] = &Tool{
-		Name:     "svc.Do",
-		Service:  "svc",
-		Endpoint: "Do",
-	}
-	s.limiters["svc.Do"] = newRateLimiter(1, 1)
-
-	makeReq := func() int {
-		body, _ := json.Marshal(map[string]interface{}{
-			"tool":  "svc.Do",
-			"input": map[string]interface{}{},
-		})
-		req := httptest.NewRequest("POST", "/mcp/call", bytes.NewReader(body))
-		rec := httptest.NewRecorder()
-		s.handleCallTool(rec, req)
-		return rec.Code
-	}
-
-	// First request should pass rate limit (but RPC may fail — that's ok)
-	code1 := makeReq()
-	if code1 == http.StatusTooManyRequests {
-		t.Error("first request should not be rate limited")
-	}
-
-	// Second request should be rate limited
-	code2 := makeReq()
-	if code2 != http.StatusTooManyRequests {
-		t.Errorf("second request status = %d, want %d", code2, http.StatusTooManyRequests)
-	}
-
-	// Check audit records include rate limit denial
-	mu.Lock()
-	defer mu.Unlock()
-	found := false
-	for _, r := range records {
-		if r.DeniedReason == "rate limited" {
-			found = true
-			break
-		}
-	}
-	if !found {
-		t.Error("expected audit record with DeniedReason = 'rate limited'")
-	}
-}
-
-func TestHandleCallTool_NoAuth_NoScope(t *testing.T) {
-	// Without Auth configured, tools without scopes should be accessible
-	s := newTestServer(Options{})
-	s.tools["svc.Echo"] = &Tool{
-		Name:     "svc.Echo",
-		Service:  "svc",
-		Endpoint: "Echo",
-	}
-
-	body, _ := json.Marshal(map[string]interface{}{
-		"tool":  "svc.Echo",
-		"input": map[string]interface{}{"msg": "hi"},
-	})
-	req := httptest.NewRequest("POST", "/mcp/call", bytes.NewReader(body))
-	rec := httptest.NewRecorder()
-	s.handleCallTool(rec, req)
-
-	// Should not be 401 or 403 (RPC failure is expected since no backend)
-	if rec.Code == http.StatusUnauthorized || rec.Code == http.StatusForbidden {
-		t.Errorf("unexpected auth error: %d", rec.Code)
-	}
-}
-
-func TestToolScopesInJSON(t *testing.T) {
-	tool := &Tool{
-		Name:        "blog.Blog.Create",
-		Description: "Create a blog post",
-		InputSchema: map[string]interface{}{"type": "object"},
-		Scopes:      []string{"blog:write", "blog:admin"},
-	}
-
-	data, err := json.Marshal(tool)
-	if err != nil {
-		t.Fatal(err)
-	}
-
-	var m map[string]interface{}
-	if err := json.Unmarshal(data, &m); err != nil {
-		t.Fatal(err)
-	}
-
-	scopes, ok := m["scopes"].([]interface{})
-	if !ok {
-		t.Fatal("expected scopes in JSON output")
-	}
-	if len(scopes) != 2 {
-		t.Errorf("expected 2 scopes, got %d", len(scopes))
-	}
-}
-
-func TestToolNoScopesOmittedInJSON(t *testing.T) {
-	tool := &Tool{
-		Name:        "blog.Blog.Read",
-		Description: "Read a blog post",
-		InputSchema: map[string]interface{}{"type": "object"},
-	}
-
-	data, err := json.Marshal(tool)
-	if err != nil {
-		t.Fatal(err)
-	}
-
-	var m map[string]interface{}
-	if err := json.Unmarshal(data, &m); err != nil {
-		t.Fatal(err)
-	}
-
-	if _, ok := m["scopes"]; ok {
-		t.Error("expected scopes to be omitted when empty")
-	}
-}
-
-func TestDiscoverServices_RateLimiters(t *testing.T) {
-	reg := registry.NewMemoryRegistry()
-	svc := &registry.Service{
-		Name: "blog",
-		Nodes: []*registry.Node{{
-			Id:      "blog-1",
-			Address: "localhost:9090",
-		}},
-		Endpoints: []*registry.Endpoint{
-			{Name: "Blog.Create"},
-			{Name: "Blog.Read"},
-		},
-	}
-	if err := reg.Register(svc); err != nil {
-		t.Fatal(err)
-	}
-
-	s := newTestServer(Options{
-		Registry:  reg,
-		RateLimit: &RateLimitConfig{RequestsPerSecond: 10, Burst: 5},
-	})
-	if err := s.discoverServices(); err != nil {
-		t.Fatal(err)
-	}
-
-	if len(s.limiters) != 2 {
-		t.Errorf("expected 2 limiters, got %d", len(s.limiters))
-	}
-	for name := range s.tools {
-		if _, ok := s.limiters[name]; !ok {
-			t.Errorf("missing limiter for tool %s", name)
-		}
-	}
-}
-
-func TestScopesFromGatewayOptions(t *testing.T) {
-	reg := registry.NewMemoryRegistry()
-	svc := &registry.Service{
-		Name: "blog",
-		Nodes: []*registry.Node{{
-			Id:      "blog-1",
-			Address: "localhost:9090",
-		}},
-		Endpoints: []*registry.Endpoint{
-			{
-				Name: "Blog.Create",
-				Metadata: map[string]string{
-					"scopes": "blog:write",
-				},
-			},
-			{
-				Name: "Blog.Delete",
-			},
-		},
-	}
-	if err := reg.Register(svc); err != nil {
-		t.Fatal(err)
-	}
-
-	// Gateway-level Scopes override service-level metadata scopes
-	s := newTestServer(Options{
-		Registry: reg,
-		Scopes: map[string][]string{
-			"blog.Blog.Create": {"blog:admin"},        // override service scope
-			"blog.Blog.Delete": {"blog:admin", "sudo"}, // add scope to tool without service scope
-		},
-	})
-	if err := s.discoverServices(); err != nil {
-		t.Fatal(err)
-	}
-
-	// Blog.Create should have gateway-level scope (overrides service "blog:write")
-	createTool := s.tools["blog.Blog.Create"]
-	if createTool == nil {
-		t.Fatal("expected tool blog.Blog.Create")
-	}
-	if len(createTool.Scopes) != 1 || createTool.Scopes[0] != "blog:admin" {
-		t.Errorf("expected gateway scopes [blog:admin], got: %v", createTool.Scopes)
-	}
-
-	// Blog.Delete should get gateway-level scopes
-	deleteTool := s.tools["blog.Blog.Delete"]
-	if deleteTool == nil {
-		t.Fatal("expected tool blog.Blog.Delete")
-	}
-	if len(deleteTool.Scopes) != 2 || deleteTool.Scopes[0] != "blog:admin" || deleteTool.Scopes[1] != "sudo" {
-		t.Errorf("expected gateway scopes [blog:admin sudo], got: %v", deleteTool.Scopes)
-	}
-}
@@ -1,339 +0,0 @@
-package mcp
-
-import (
-	"fmt"
-	"go/ast"
-	"go/doc"
-	"go/parser"
-	"go/token"
-	"path/filepath"
-	"reflect"
-	"regexp"
-	"strings"
-
-	"go-micro.dev/v5/registry"
-)
-
-// ToolDescription represents enhanced documentation for an MCP tool
-type ToolDescription struct {
-	Summary     string
-	Description string
-	Params      []ParamDoc
-	Returns     []ReturnDoc
-	Examples    []string
-}
-
-// ParamDoc describes a parameter
-type ParamDoc struct {
-	Name        string
-	Type        string
-	Description string
-	Required    bool
-}
-
-// ReturnDoc describes a return value
-type ReturnDoc struct {
-	Type        string
-	Description string
-}
-
-var (
-	// Regex patterns for JSDoc-style tags
-	paramPattern   = regexp.MustCompile(`@param\s+(\w+)\s+\{(\w+)\}\s+(.+)`)
-	returnPattern  = regexp.MustCompile(`@return\s+\{(\w+)\}\s+(.+)`)
-	examplePattern = regexp.MustCompile(`@example\s+([\s\S]+?)(?:@\w+|$)`)
-)
-
-// parseServiceDocs attempts to parse Go source files to extract documentation
-// for service methods. This enhances tool descriptions with godoc comments.
-func parseServiceDocs(serviceName string, endpoint *registry.Endpoint) *ToolDescription {
-	// For now, return basic description
-	// Full implementation would:
-	// 1. Use go/parser to find service source files
-	// 2. Extract godoc comments for methods
-	// 3. Parse JSDoc-style tags (@param, @return, @example)
-	// 4. Return rich ToolDescription
-
-	desc := &ToolDescription{
-		Summary:     fmt.Sprintf("Call %s on %s service", endpoint.Name, serviceName),
-		Description: "",
-		Params:      parseEndpointParams(endpoint.Request),
-		Returns:     parseEndpointReturns(endpoint.Response),
-		Examples:    []string{},
-	}
-
-	return desc
-}
-
-// parseEndpointParams extracts parameter documentation from registry Value
-func parseEndpointParams(value *registry.Value) []ParamDoc {
-	if value == nil || len(value.Values) == 0 {
-		return nil
-	}
-
-	params := make([]ParamDoc, 0, len(value.Values))
-	for _, field := range value.Values {
-		params = append(params, ParamDoc{
-			Name:        field.Name,
-			Type:        field.Type,
-			Description: formatFieldDescription(field.Name, field.Type),
-			Required:    true, // Conservative default
-		})
-	}
-
-	return params
-}
-
-// parseEndpointReturns extracts return value documentation
-func parseEndpointReturns(value *registry.Value) []ReturnDoc {
-	if value == nil {
-		return nil
-	}
-
-	return []ReturnDoc{{
-		Type:        value.Name,
-		Description: fmt.Sprintf("Returns %s", value.Name),
-	}}
-}
-
-// formatFieldDescription creates a basic description for a field
-func formatFieldDescription(name, typeName string) string {
-	// Convert camelCase/PascalCase to readable format
-	readable := toReadable(name)
-	return fmt.Sprintf("%s (%s)", readable, typeName)
-}
-
-// toReadable converts camelCase or PascalCase to readable format
-func toReadable(s string) string {
-	// Insert spaces before uppercase letters
-	var result strings.Builder
-	for i, r := range s {
-		if i > 0 && r >= 'A' && r <= 'Z' {
-			result.WriteRune(' ')
-		}
-		result.WriteRune(r)
-	}
-	return result.String()
-}
-
-// ParseGoDocComment parses a Go doc comment for JSDoc-style tags
-func ParseGoDocComment(comment string) *ToolDescription {
-	desc := &ToolDescription{
-		Params:   []ParamDoc{},
-		Returns:  []ReturnDoc{},
-		Examples: []string{},
-	}
-
-	// Extract summary (first line)
-	lines := strings.Split(comment, "\n")
-	if len(lines) > 0 {
-		desc.Summary = strings.TrimSpace(lines[0])
-	}
-
-	// Extract full description (before first tag)
-	tagStart := strings.Index(comment, "@")
-	if tagStart > 0 {
-		desc.Description = strings.TrimSpace(comment[:tagStart])
-	} else {
-		desc.Description = strings.TrimSpace(comment)
-	}
-
-	// Parse @param tags
-	paramMatches := paramPattern.FindAllStringSubmatch(comment, -1)
-	for _, match := range paramMatches {
-		if len(match) == 4 {
-			desc.Params = append(desc.Params, ParamDoc{
-				Name:        match[1],
-				Type:        match[2],
-				Description: strings.TrimSpace(match[3]),
-				Required:    true,
-			})
-		}
-	}
-
-	// Parse @return tags
-	returnMatches := returnPattern.FindAllStringSubmatch(comment, -1)
-	for _, match := range returnMatches {
-		if len(match) == 3 {
-			desc.Returns = append(desc.Returns, ReturnDoc{
-				Type:        match[1],
-				Description: strings.TrimSpace(match[2]),
-			})
-		}
-	}
-
-	// Parse @example tags
-	exampleMatches := examplePattern.FindAllStringSubmatch(comment, -1)
-	for _, match := range exampleMatches {
-		if len(match) == 2 {
-			example := strings.TrimSpace(match[1])
-			desc.Examples = append(desc.Examples, example)
-		}
-	}
-
-	return desc
-}
-
-// enhanceToolDescription attempts to enhance a tool with parsed documentation
-func enhanceToolDescription(tool *Tool, serviceName string, endpoint *registry.Endpoint) {
-	// Try to parse service documentation
-	toolDesc := parseServiceDocs(serviceName, endpoint)
-
-	// Update tool description with parsed info
-	if toolDesc.Summary != "" {
-		tool.Description = toolDesc.Summary
-	}
-
-	// Add detailed description to input schema
-	if toolDesc.Description != "" {
-		if tool.InputSchema == nil {
-			tool.InputSchema = make(map[string]interface{})
-		}
-		tool.InputSchema["description"] = toolDesc.Description
-	}
-
-	// Enhance parameter descriptions
-	if len(toolDesc.Params) > 0 {
-		properties, ok := tool.InputSchema["properties"].(map[string]interface{})
-		if ok {
-			for _, param := range toolDesc.Params {
-				if propSchema, exists := properties[param.Name]; exists {
-					if propMap, ok := propSchema.(map[string]interface{}); ok {
-						propMap["description"] = param.Description
-						if param.Required {
-							// Add to required array
-							required, _ := tool.InputSchema["required"].([]string)
-							required = append(required, param.Name)
-							tool.InputSchema["required"] = required
-						}
-					}
-				}
-			}
-		}
-	}
-
-	// Add examples if available
-	if len(toolDesc.Examples) > 0 {
-		tool.InputSchema["examples"] = toolDesc.Examples
-	}
-}
-
-// ParseStructTags extracts JSON schema information from struct tags
-// This can be used to enhance parameter descriptions
-func ParseStructTags(t reflect.Type) map[string]interface{} {
-	schema := map[string]interface{}{
-		"type":       "object",
-		"properties": make(map[string]interface{}),
-	}
-
-	properties := schema["properties"].(map[string]interface{})
-	required := []string{}
-
-	for i := 0; i < t.NumField(); i++ {
-		field := t.Field(i)
-
-		// Get JSON tag
-		jsonTag := field.Tag.Get("json")
-		if jsonTag == "" || jsonTag == "-" {
-			continue
-		}
-
-		// Parse JSON tag
-		jsonName := strings.Split(jsonTag, ",")[0]
-		omitempty := strings.Contains(jsonTag, "omitempty")
-
-		// Get description from validate tag or description tag
-		description := field.Tag.Get("description")
-		if description == "" {
-			description = formatFieldDescription(field.Name, field.Type.String())
-		}
-
-		// Build property schema
-		propSchema := map[string]interface{}{
-			"description": description,
-		}
-
-		// Add type information
-		propSchema["type"] = reflectTypeToJSONType(field.Type)
-
-		properties[jsonName] = propSchema
-
-		// Track required fields
-		if !omitempty {
-			required = append(required, jsonName)
-		}
-	}
-
-	if len(required) > 0 {
-		schema["required"] = required
-	}
-
-	return schema
-}
-
-// reflectTypeToJSONType converts Go reflect.Type to JSON schema type
-func reflectTypeToJSONType(t reflect.Type) string {
-	switch t.Kind() {
-	case reflect.String:
-		return "string"
-	case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64,
-		reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64:
-		return "integer"
-	case reflect.Float32, reflect.Float64:
-		return "number"
-	case reflect.Bool:
-		return "boolean"
-	case reflect.Slice, reflect.Array:
-		return "array"
-	case reflect.Map, reflect.Struct:
-		return "object"
-	default:
-		return "string"
-	}
-}
-
-// findServiceSource attempts to locate Go source files for a service
-// This is used to extract godoc comments
-func findServiceSource(serviceName string) ([]string, error) {
-	// This would search GOPATH/module cache for service sources
-	// For now, return empty - implementation would use:
-	// - go/packages to find module
-	// - Search for service struct definitions
-	// - Return list of source files
-	return nil, fmt.Errorf("source discovery not yet implemented")
-}
-
-// parseGoFile parses a Go source file and extracts method documentation
-func parseGoFile(filename string, serviceName string) (map[string]*ToolDescription, error) {
-	fset := token.NewFileSet()
-	f, err := parser.ParseFile(fset, filename, nil, parser.ParseComments)
-	if err != nil {
-		return nil, err
-	}
-
-	docs := make(map[string]*ToolDescription)
-
-	// Use go/doc to extract documentation
-	pkg := &ast.Package{
-		Name:  f.Name.Name,
-		Files: map[string]*ast.File{filename: f},
-	}
-
-	docPkg := doc.New(pkg, filepath.Dir(filename), doc.AllDecls)
-
-	// Extract method documentation
-	for _, typ := range docPkg.Types {
-		if !strings.Contains(typ.Name, serviceName) {
-			continue
-		}
-
-		for _, method := range typ.Methods {
-			toolDesc := ParseGoDocComment(method.Doc)
-			toolDesc.Summary = fmt.Sprintf("%s - %s", method.Name, toolDesc.Summary)
-
-			docs[method.Name] = toolDesc
-		}
-	}
-
-	return docs, nil
-}
@@ -1,51 +0,0 @@
-package mcp
-
-import (
-	"sync"
-	"time"
-)
-
-// rateLimiter implements a simple token-bucket rate limiter.
-type rateLimiter struct {
-	mu       sync.Mutex
-	rate     float64   // tokens per second
-	burst    int       // max tokens
-	tokens   float64   // current token count
-	lastTime time.Time // last refill time
-}
-
-// newRateLimiter creates a rate limiter that allows rate requests/sec with
-// the given burst size. If burst is less than 1 it defaults to 1.
-func newRateLimiter(rate float64, burst int) *rateLimiter {
-	if burst < 1 {
-		burst = 1
-	}
-	return &rateLimiter{
-		rate:     rate,
-		burst:    burst,
-		tokens:   float64(burst),
-		lastTime: time.Now(),
-	}
-}
-
-// Allow reports whether a single event may happen now.
-func (r *rateLimiter) Allow() bool {
-	r.mu.Lock()
-	defer r.mu.Unlock()
-
-	now := time.Now()
-	elapsed := now.Sub(r.lastTime).Seconds()
-	r.lastTime = now
-
-	// Refill tokens based on elapsed time
-	r.tokens += elapsed * r.rate
-	if r.tokens > float64(r.burst) {
-		r.tokens = float64(r.burst)
-	}
-
-	if r.tokens < 1 {
-		return false
-	}
-	r.tokens--
-	return true
-}
@@ -1,369 +0,0 @@
-package mcp
-
-import (
-	"bufio"
-	"context"
-	"encoding/json"
-	"fmt"
-	"io"
-	"log"
-	"os"
-	"strings"
-	"sync"
-	"time"
-
-	"go-micro.dev/v5/auth"
-	"go-micro.dev/v5/metadata"
-
-	"github.com/google/uuid"
-)
-
-// StdioTransport implements MCP JSON-RPC 2.0 over stdio
-// This is used by Claude Code and other local AI tools
-type StdioTransport struct {
-	server   *Server
-	reader   *bufio.Reader
-	writer   *bufio.Writer
-	writerMu sync.Mutex
-	ctx      context.Context
-	cancel   context.CancelFunc
-}
-
-// JSONRPCRequest represents a JSON-RPC 2.0 request
-type JSONRPCRequest struct {
-	JSONRPC string          `json:"jsonrpc"`
-	ID      interface{}     `json:"id,omitempty"`
-	Method  string          `json:"method"`
-	Params  json.RawMessage `json:"params,omitempty"`
-}
-
-// JSONRPCResponse represents a JSON-RPC 2.0 response
-type JSONRPCResponse struct {
-	JSONRPC string      `json:"jsonrpc"`
-	ID      interface{} `json:"id,omitempty"`
-	Result  interface{} `json:"result,omitempty"`
-	Error   *RPCError   `json:"error,omitempty"`
-}
-
-// RPCError represents a JSON-RPC error
-type RPCError struct {
-	Code    int         `json:"code"`
-	Message string      `json:"message"`
-	Data    interface{} `json:"data,omitempty"`
-}
-
-// Standard JSON-RPC error codes
-const (
-	ParseError     = -32700
-	InvalidRequest = -32600
-	MethodNotFound = -32601
-	InvalidParams  = -32602
-	InternalError  = -32603
-)
-
-// NewStdioTransport creates a new stdio transport for the MCP server
-func NewStdioTransport(server *Server) *StdioTransport {
-	ctx, cancel := context.WithCancel(context.Background())
-	return &StdioTransport{
-		server: server,
-		reader: bufio.NewReader(os.Stdin),
-		writer: bufio.NewWriter(os.Stdout),
-		ctx:    ctx,
-		cancel: cancel,
-	}
-}
-
-// Serve starts the stdio transport and processes JSON-RPC requests
-func (t *StdioTransport) Serve() error {
-	t.server.opts.Logger.Printf("[mcp] MCP server started (stdio transport)")
-
-	// Read and process requests from stdin
-	for {
-		select {
-		case <-t.ctx.Done():
-			return nil
-		default:
-		}
-
-		// Read one line (JSON-RPC request)
-		line, err := t.reader.ReadBytes('\n')
-		if err != nil {
-			if err == io.EOF {
-				return nil
-			}
-			return fmt.Errorf("failed to read request: %w", err)
-		}
-
-		// Parse JSON-RPC request
-		var req JSONRPCRequest
-		if err := json.Unmarshal(line, &req); err != nil {
-			t.sendError(nil, ParseError, "Parse error", err.Error())
-			continue
-		}
-
-		// Validate JSON-RPC version
-		if req.JSONRPC != "2.0" {
-			t.sendError(req.ID, InvalidRequest, "Invalid request", "jsonrpc must be '2.0'")
-			continue
-		}
-
-		// Handle request
-		go t.handleRequest(&req)
-	}
-}
-
-// handleRequest processes a single JSON-RPC request
-func (t *StdioTransport) handleRequest(req *JSONRPCRequest) {
-	switch req.Method {
-	case "initialize":
-		t.handleInitialize(req)
-	case "tools/list":
-		t.handleToolsList(req)
-	case "tools/call":
-		t.handleToolsCall(req)
-	default:
-		t.sendError(req.ID, MethodNotFound, "Method not found", req.Method)
-	}
-}
-
-// handleInitialize handles the initialize request
-func (t *StdioTransport) handleInitialize(req *JSONRPCRequest) {
-	result := map[string]interface{}{
-		"protocolVersion": "2024-11-05",
-		"capabilities": map[string]interface{}{
-			"tools": map[string]interface{}{},
-		},
-		"serverInfo": map[string]interface{}{
-			"name":    "go-micro-mcp",
-			"version": "1.0.0",
-		},
-	}
-
-	t.sendResponse(req.ID, result)
-}
-
-// handleToolsList handles the tools/list request
-func (t *StdioTransport) handleToolsList(req *JSONRPCRequest) {
-	t.server.toolsMu.RLock()
-	tools := make([]interface{}, 0, len(t.server.tools))
-	for _, tool := range t.server.tools {
-		tools = append(tools, map[string]interface{}{
-			"name":        tool.Name,
-			"description": tool.Description,
-			"inputSchema": tool.InputSchema,
-		})
-	}
-	t.server.toolsMu.RUnlock()
-
-	result := map[string]interface{}{
-		"tools": tools,
-	}
-
-	t.sendResponse(req.ID, result)
-}
-
-// handleToolsCall handles the tools/call request
-func (t *StdioTransport) handleToolsCall(req *JSONRPCRequest) {
-	// Parse params
-	var params struct {
-		Name      string                 `json:"name"`
-		Arguments map[string]interface{} `json:"arguments"`
-		// Token allows callers to pass a bearer token for auth via the
-		// JSON-RPC params (since stdio has no HTTP headers).
-		Token string `json:"_token,omitempty"`
-	}
-	if err := json.Unmarshal(req.Params, &params); err != nil {
-		t.sendError(req.ID, InvalidParams, "Invalid params", err.Error())
-		return
-	}
-
-	// Get tool info
-	t.server.toolsMu.RLock()
-	tool, exists := t.server.tools[params.Name]
-	t.server.toolsMu.RUnlock()
-
-	if !exists {
-		t.sendError(req.ID, InvalidParams, "Tool not found", params.Name)
-		return
-	}
-
-	// Generate trace ID
-	traceID := uuid.New().String()
-
-	// Authenticate and authorise (if Auth is configured)
-	var account *auth.Account
-	if t.server.opts.Auth != nil {
-		token := params.Token
-		if token == "" {
-			t.server.audit(AuditRecord{TraceID: traceID, Timestamp: time.Now(), Tool: params.Name, Allowed: false, DeniedReason: "missing token"})
-			t.sendError(req.ID, InvalidParams, "Unauthorized", "missing _token in params")
-			return
-		}
-		if strings.HasPrefix(token, "Bearer ") {
-			token = strings.TrimPrefix(token, "Bearer ")
-		}
-		acc, err := t.server.opts.Auth.Inspect(token)
-		if err != nil {
-			t.server.audit(AuditRecord{TraceID: traceID, Timestamp: time.Now(), Tool: params.Name, Allowed: false, DeniedReason: "invalid token"})
-			t.sendError(req.ID, InvalidParams, "Unauthorized", "invalid token")
-			return
-		}
-		account = acc
-
-		// Check per-tool scopes
-		if len(tool.Scopes) > 0 {
-			if !hasScope(account.Scopes, tool.Scopes) {
-				t.server.audit(AuditRecord{
-					TraceID: traceID, Timestamp: time.Now(), Tool: params.Name,
-					AccountID: account.ID, ScopesRequired: tool.Scopes,
-					Allowed: false, DeniedReason: "insufficient scopes",
-				})
-				t.sendError(req.ID, InvalidParams, "Forbidden", "insufficient scopes")
-				return
-			}
-		}
-	}
-
-	// Rate limit check
-	if err := t.server.allowRate(params.Name); err != nil {
-		accountID := ""
-		if account != nil {
-			accountID = account.ID
-		}
-		t.server.audit(AuditRecord{
-			TraceID: traceID, Timestamp: time.Now(), Tool: params.Name,
-			AccountID: accountID, Allowed: false, DeniedReason: "rate limited",
-		})
-		t.sendError(req.ID, InternalError, "Rate limit exceeded", params.Name)
-		return
-	}
-
-	// Convert arguments to JSON bytes for RPC call
-	inputBytes, err := json.Marshal(params.Arguments)
-	if err != nil {
-		t.sendError(req.ID, InternalError, "Failed to marshal arguments", err.Error())
-		return
-	}
-
-	// Build context with tracing metadata
-	ctx := t.ctx
-	md := metadata.Metadata{}
-	md.Set(TraceIDKey, traceID)
-	md.Set(ToolNameKey, params.Name)
-	if account != nil {
-		md.Set(AccountIDKey, account.ID)
-	}
-	ctx = metadata.MergeContext(ctx, md, true)
-
-	// Make RPC call
-	start := time.Now()
-	rpcReq := t.server.opts.Client.NewRequest(tool.Service, tool.Endpoint, &struct {
-		Data []byte
-	}{Data: inputBytes})
-
-	var rsp struct {
-		Data []byte
-	}
-
-	if err := t.server.opts.Client.Call(ctx, rpcReq, &rsp); err != nil {
-		accountID := ""
-		if account != nil {
-			accountID = account.ID
-		}
-		t.server.audit(AuditRecord{
-			TraceID: traceID, Timestamp: time.Now(), Tool: params.Name,
-			AccountID: accountID, ScopesRequired: tool.Scopes,
-			Allowed: true, Duration: time.Since(start), Error: err.Error(),
-		})
-		t.sendError(req.ID, InternalError, "RPC call failed", err.Error())
-		return
-	}
-
-	// Audit successful call
-	accountID := ""
-	if account != nil {
-		accountID = account.ID
-	}
-	t.server.audit(AuditRecord{
-		TraceID: traceID, Timestamp: time.Now(), Tool: params.Name,
-		AccountID: accountID, ScopesRequired: tool.Scopes,
-		Allowed: true, Duration: time.Since(start),
-	})
-
-	// Parse response
-	var result interface{}
-	if err := json.Unmarshal(rsp.Data, &result); err != nil {
-		// If unmarshal fails, return raw data
-		result = map[string]interface{}{
-			"data": string(rsp.Data),
-		}
-	}
-
-	t.sendResponse(req.ID, map[string]interface{}{
-		"content": []interface{}{
-			map[string]interface{}{
-				"type": "text",
-				"text": fmt.Sprintf("%v", result),
-			},
-		},
-		"trace_id": traceID,
-	})
-}
-
-// sendResponse sends a JSON-RPC response
-func (t *StdioTransport) sendResponse(id interface{}, result interface{}) {
-	resp := JSONRPCResponse{
-		JSONRPC: "2.0",
-		ID:      id,
-		Result:  result,
-	}
-
-	t.writeJSON(resp)
-}
-
-// sendError sends a JSON-RPC error response
-func (t *StdioTransport) sendError(id interface{}, code int, message string, data interface{}) {
-	resp := JSONRPCResponse{
-		JSONRPC: "2.0",
-		ID:      id,
-		Error: &RPCError{
-			Code:    code,
-			Message: message,
-			Data:    data,
-		},
-	}
-
-	t.writeJSON(resp)
-}
-
-// writeJSON writes a JSON-RPC message to stdout
-func (t *StdioTransport) writeJSON(v interface{}) {
-	t.writerMu.Lock()
-	defer t.writerMu.Unlock()
-
-	data, err := json.Marshal(v)
-	if err != nil {
-		log.Printf("[mcp] Failed to marshal response: %v", err)
-		return
-	}
-
-	if _, err := t.writer.Write(data); err != nil {
-		log.Printf("[mcp] Failed to write response: %v", err)
-		return
-	}
-
-	if _, err := t.writer.Write([]byte("\n")); err != nil {
-		log.Printf("[mcp] Failed to write newline: %v", err)
-		return
-	}
-
-	if err := t.writer.Flush(); err != nil {
-		log.Printf("[mcp] Failed to flush writer: %v", err)
-	}
-}
-
-// Stop gracefully stops the stdio transport
-func (t *StdioTransport) Stop() error {
-	t.cancel()
-	return nil
-}
@@ -0,0 +1,16 @@
+package genai
+
+import (
+	"sync"
+)
+
+var (
+	DefaultGenAI GenAI = &noopGenAI{}
+	defaultOnce  sync.Once
+)
+
+func SetDefault(g GenAI) {
+	defaultOnce.Do(func() {
+		DefaultGenAI = g
+	})
+}
@@ -0,0 +1,165 @@
+package gemini
+
+import (
+	"bytes"
+	"context"
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"os"
+
+	"go-micro.dev/v5/genai"
+)
+
+// gemini implements the GenAI interface using Google Gemini 2.5 API.
+type gemini struct {
+	options genai.Options
+}
+
+func New(opts ...genai.Option) genai.GenAI {
+	var options genai.Options
+	for _, o := range opts {
+		o(&options)
+	}
+	if options.APIKey == "" {
+		options.APIKey = os.Getenv("GEMINI_API_KEY")
+	}
+	return &gemini{options: options}
+}
+
+func (g *gemini) Generate(prompt string, opts ...genai.Option) (*genai.Result, error) {
+	options := g.options
+	for _, o := range opts {
+		o(&options)
+	}
+	ctx := context.Background()
+
+	res := &genai.Result{Prompt: prompt, Type: options.Type}
+
+	endpoint := options.Endpoint
+	if endpoint == "" {
+		endpoint = "https://generativelanguage.googleapis.com/v1beta/models/"
+	}
+
+	var url string
+	var body map[string]interface{}
+
+	// Determine model to use
+	var model string
+	switch options.Type {
+	case "image":
+		if options.Model != "" {
+			model = options.Model
+		} else {
+			model = "gemini-2.5-pro-vision"
+		}
+		url = endpoint + model + ":generateContent?key=" + options.APIKey
+		body = map[string]interface{}{
+			"contents": []map[string]interface{}{
+				{"parts": []map[string]string{{"text": prompt}}},
+			},
+		}
+	case "audio":
+		if options.Model != "" {
+			model = options.Model
+		} else {
+			model = "gemini-2.5-pro"
+		}
+		url = endpoint + model + ":generateContent?key=" + options.APIKey
+		body = map[string]interface{}{
+			"contents": []map[string]interface{}{
+				{"parts": []map[string]string{{"text": prompt}}},
+			},
+			"response_mime_type": "audio/wav",
+		}
+	case "text":
+		fallthrough
+	default:
+		if options.Model != "" {
+			model = options.Model
+		} else {
+			model = "gemini-2.5-pro"
+		}
+		url = endpoint + model + ":generateContent?key=" + options.APIKey
+		body = map[string]interface{}{
+			"contents": []map[string]interface{}{
+				{"parts": []map[string]string{{"text": prompt}}},
+			},
+		}
+	}
+
+	b, _ := json.Marshal(body)
+	req, err := http.NewRequestWithContext(ctx, "POST", url, bytes.NewReader(b))
+	if err != nil {
+		return nil, err
+	}
+	req.Header.Set("Content-Type", "application/json")
+
+	resp, err := http.DefaultClient.Do(req)
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+
+	if options.Type == "audio" {
+		var result struct {
+			Candidates []struct {
+				Content struct {
+					Parts []struct {
+						InlineData struct {
+							Data []byte `json:"data"`
+						} `json:"inline_data"`
+					} `json:"parts"`
+				} `json:"content"`
+			} `json:"candidates"`
+		}
+		if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
+			return nil, err
+		}
+		if len(result.Candidates) == 0 || len(result.Candidates[0].Content.Parts) == 0 {
+			return nil, fmt.Errorf("no audio returned")
+		}
+		res.Data = result.Candidates[0].Content.Parts[0].InlineData.Data
+		return res, nil
+	}
+
+	var result struct {
+		Candidates []struct {
+			Content struct {
+				Parts []struct {
+					Text string `json:"text"`
+				} `json:"parts"`
+			} `json:"content"`
+		} `json:"candidates"`
+	}
+	if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
+		return nil, err
+	}
+	if len(result.Candidates) == 0 || len(result.Candidates[0].Content.Parts) == 0 {
+		return nil, fmt.Errorf("no candidates returned")
+	}
+	res.Text = result.Candidates[0].Content.Parts[0].Text
+	return res, nil
+}
+
+func (g *gemini) Stream(prompt string, opts ...genai.Option) (*genai.Stream, error) {
+	results := make(chan *genai.Result)
+	go func() {
+		defer close(results)
+		res, err := g.Generate(prompt, opts...)
+		if err != nil {
+			// Send error via Stream.Err, not channel
+			return
+		}
+		results <- res
+	}()
+	return &genai.Stream{Results: results}, nil
+}
+
+func (g *gemini) String() string {
+	return "gemini"
+}
+
+func init() {
+	genai.Register("gemini", New())
+}
@@ -0,0 +1,54 @@
+// Package genai provides a generic interface for generative AI providers.
+package genai
+
+// Result is the unified response from GenAI providers.
+type Result struct {
+	Prompt string
+	Type   string
+	Data   []byte // for audio/image binary data
+	Text   string // for text or image URL
+}
+
+// Stream represents a streaming response from a GenAI provider.
+type Stream struct {
+	Results <-chan *Result
+	Err     error
+	// You can add fields for cancellation, errors, etc. if needed
+}
+
+// GenAI is the generic interface for generative AI providers.
+type GenAI interface {
+	Generate(prompt string, opts ...Option) (*Result, error)
+	Stream(prompt string, opts ...Option) (*Stream, error)
+	String() string
+}
+
+// Option is a functional option for configuring providers.
+type Option func(*Options)
+
+// Options holds configuration for providers.
+type Options struct {
+	APIKey   string
+	Endpoint string
+	Type     string // "text", "image", "audio", etc.
+	Model    string // model name, e.g. "gemini-2.5-pro"
+	// Add more fields as needed
+}
+
+// Option functions for generation type
+func Text(o *Options)  { o.Type = "text" }
+func Image(o *Options) { o.Type = "image" }
+func Audio(o *Options) { o.Type = "audio" }
+
+// Provider registry
+var providers = make(map[string]GenAI)
+
+// Register a GenAI provider by name.
+func Register(name string, provider GenAI) {
+	providers[name] = provider
+}
+
+// Get a GenAI provider by name.
+func Get(name string) GenAI {
+	return providers[name]
+}
@@ -0,0 +1,20 @@
+package genai
+
+type noopGenAI struct{}
+
+func (n *noopGenAI) Generate(prompt string, opts ...Option) (*Result, error) {
+	return &Result{Prompt: prompt, Type: "noop", Text: "noop response"}, nil
+}
+
+func (n *noopGenAI) Stream(prompt string, opts ...Option) (*Stream, error) {
+	results := make(chan *Result, 1)
+	results <- &Result{Prompt: prompt, Type: "noop", Text: "noop response"}
+	close(results)
+	return &Stream{Results: results}, nil
+}
+
+func (n *noopGenAI) String() string {
+	return "noop"
+}
+
+var Default = &noopGenAI{}
@@ -0,0 +1,155 @@
+package openai
+
+import (
+	"bytes"
+	"encoding/json"
+	"fmt"
+	"io"
+	"net/http"
+	"os"
+
+	"go-micro.dev/v5/genai"
+)
+
+type openAI struct {
+	options genai.Options
+}
+
+func New(opts ...genai.Option) genai.GenAI {
+	var options genai.Options
+	for _, o := range opts {
+		o(&options)
+	}
+	if options.APIKey == "" {
+		options.APIKey = os.Getenv("OPENAI_API_KEY")
+	}
+	return &openAI{options: options}
+}
+
+func (o *openAI) Generate(prompt string, opts ...genai.Option) (*genai.Result, error) {
+	options := o.options
+	for _, opt := range opts {
+		opt(&options)
+	}
+
+	res := &genai.Result{Prompt: prompt, Type: options.Type}
+
+	var url string
+	var body map[string]interface{}
+
+	switch options.Type {
+	case "image":
+		model := options.Model
+		if model == "" {
+			model = "dall-e-3"
+		}
+		url = "https://api.openai.com/v1/images/generations"
+		body = map[string]interface{}{
+			"prompt": prompt,
+			"n":      1,
+			"size":   "1024x1024",
+			"model":  model,
+		}
+	case "audio":
+		model := options.Model
+		if model == "" {
+			model = "tts-1"
+		}
+		url = "https://api.openai.com/v1/audio/speech"
+		body = map[string]interface{}{
+			"model": model,
+			"input": prompt,
+			"voice": "alloy", // or another supported voice
+		}
+	case "text":
+		fallthrough
+	default:
+		model := options.Model
+		if model == "" {
+			model = "gpt-3.5-turbo"
+		}
+		url = "https://api.openai.com/v1/chat/completions"
+		body = map[string]interface{}{
+			"model":    model,
+			"messages": []map[string]string{{"role": "user", "content": prompt}},
+		}
+	}
+
+	b, _ := json.Marshal(body)
+	req, err := http.NewRequest("POST", url, bytes.NewReader(b))
+	if err != nil {
+		return nil, err
+	}
+	req.Header.Set("Authorization", "Bearer "+options.APIKey)
+	req.Header.Set("Content-Type", "application/json")
+
+	resp, err := http.DefaultClient.Do(req)
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+
+	switch options.Type {
+	case "image":
+		var result struct {
+			Data []struct {
+				URL string `json:"url"`
+			} `json:"data"`
+		}
+		if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
+			return nil, err
+		}
+		if len(result.Data) == 0 {
+			return nil, fmt.Errorf("no image returned")
+		}
+		res.Text = result.Data[0].URL
+		return res, nil
+	case "audio":
+		data, err := io.ReadAll(resp.Body)
+		if err != nil {
+			return nil, err
+		}
+		res.Data = data
+		return res, nil
+	case "text":
+		fallthrough
+	default:
+		var result struct {
+			Choices []struct {
+				Message struct {
+					Content string `json:"content"`
+				} `json:"message"`
+			} `json:"choices"`
+		}
+		if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
+			return nil, err
+		}
+		if len(result.Choices) == 0 {
+			return nil, fmt.Errorf("no choices returned")
+		}
+		res.Text = result.Choices[0].Message.Content
+		return res, nil
+	}
+}
+
+func (o *openAI) Stream(prompt string, opts ...genai.Option) (*genai.Stream, error) {
+	results := make(chan *genai.Result)
+	go func() {
+		defer close(results)
+		res, err := o.Generate(prompt, opts...)
+		if err != nil {
+			// Send error via Stream.Err, not channel
+			return
+		}
+		results <- res
+	}()
+	return &genai.Stream{Results: results}, nil
+}
+
+func (o *openAI) String() string {
+	return "openai"
+}
+
+func init() {
+	genai.Register("openai", New())
+}
--- a/Show More
+++ b/Show More