go implementation

go/README.md

@@ -0,0 +1,149 @@
+# Konduktor (Go)
+
+High-performance HTTP web server with extensible routing and process orchestration. (Previously known as PyServe in Python)
+
+## Project Structure
+
+```
+go/
+├── cmd/
+│   ├── konduktor/        # Main server binary
+│   └── konduktorctl/     # CLI management tool
+├── internal/
+│   ├── config/           # Configuration management
+│   ├── logging/          # Structured logging
+│   ├── middleware/       # HTTP middleware
+│   ├── routing/          # HTTP routing
+│   ├── extensions/       # Extension system (TODO)
+│   └── process/          # Process management (TODO)
+├── pkg/                  # Public packages (TODO)
+├── go.mod
+├── go.sum
+└── Makefile
+```
+
+## Building
+
+```bash
+cd go
+
+# Download dependencies
+make deps
+
+# Build all binaries
+make build
+
+# Or build individually
+make build-konduktor
+make build-konduktorctl
+```
+
+## Running
+
+```bash
+# Run with default config
+./bin/konduktor
+
+# Run with custom config
+./bin/konduktor -c ../config.yaml
+
+# Run with flags
+./bin/konduktor --host 127.0.0.1 --port 3000 --debug
+```
+
+## CLI Commands (konduktorctl)
+
+```bash
+# Start services
+konduktorctl up
+
+# Stop services
+konduktorctl down
+
+# View status
+konduktorctl status
+
+# View logs
+konduktorctl logs -f
+
+# Health check
+konduktorctl health
+
+# Scale services
+konduktorctl scale api=3
+
+# Configuration management
+konduktorctl config show
+konduktorctl config validate
+
+# Initialize new project
+konduktorctl init
+```
+
+## Configuration
+
+Uses the same YAML configuration format as the Python version:
+
+```yaml
+server:
+  host: 0.0.0.0
+  port: 8080
+  
+http:
+  static_dir: ./static
+  templates_dir: ./templates
+
+ssl:
+  enabled: false
+  cert_file: ./ssl/cert.pem
+  key_file: ./ssl/key.pem
+
+logging:
+  level: INFO
+  console_output: true
+
+extensions:
+  - type: routing
+    config:
+      regex_locations:
+        "=/health":
+          return: "200 OK"
+```
+
+## Development
+
+```bash
+# Format code
+make fmt
+
+# Run linter
+make lint
+
+# Run tests
+make test
+
+# Run with coverage
+make test-coverage
+```
+
+## Migration from Python
+
+This is a gradual rewrite of PyServe to Go. The project is now called **Konduktor**.
+
+### Completed
+- [x] Basic project structure
+- [x] Configuration loading
+- [x] HTTP server with graceful shutdown
+- [x] Basic routing
+- [x] Middleware (access log, recovery, server header)
+- [x] CLI structure (konduktor, konduktorctl)
+
+### TODO
+- [ ] Extension system
+- [x] Regex routing
+- [x] Reverse proxy
+- [ ] Process orchestration
+- [ ] ASGI/WSGI adapter support
+- [ ] WebSocket support
+- [ ] Hot reload
+- [ ] Metrics and monitoring