Add "Home"

Home.md

@@ -0,0 +1,62 @@
+# go (Core Framework)
+
+**Dependency Injection Framework for Go with Wails v3 Integration**
+
+`core/go` is the foundation of the Lethean Go ecosystem. It provides a dependency injection container with named service registry, lifecycle management, an event-driven message bus (ACTION/QUERY/TASK), and Wails v3 desktop integration.
+
+## Installation
+
+```bash
+go get forge.lthn.ai/core/go
+```
+
+## Package Map
+
+| Package | Purpose |
+|---------|---------|
+| `pkg/framework/core` | DI container, service lifecycle, message bus |
+| `pkg/ws` | WebSocket hub for real-time streaming |
+| `pkg/webview` | Chrome DevTools Protocol client |
+| `pkg/process` | Process execution with streaming output |
+| `pkg/log` | Structured logging service |
+| `pkg/config` | Configuration management |
+| `pkg/io` | Abstract storage (local, S3, SFTP, WebDAV) |
+| `pkg/plugin` | Plugin installation, loading, versioning |
+| `pkg/cli` | CLI framework, command routing |
+| `pkg/coredeno` | Deno runtime sidecar integration |
+| `pkg/lab` | ML inference runtime (MLX-C bindings) |
+| `pkg/cache` | Caching utilities |
+| `pkg/marketplace` | Plugin/service marketplace |
+| `pkg/manifest` | Package manifest signing and verification |
+| `pkg/session` | Session management |
+| `pkg/store` | Key-value storage |
+| `pkg/help` | Help/documentation search |
+| `pkg/ratelimit` | Rate limiting |
+| `pkg/repos` | Git repository registry |
+| `pkg/workspace` | Encrypted workspace storage |
+
+## Applications
+
+| App | Path | Purpose |
+|-----|------|---------|
+| core-app | `cmd/core-app/` | FrankenPHP + Laravel 12 desktop app |
+| core-ide | `cmd/core-ide/` | IDE application (Wails v3 GUI) |
+| bugseti | `cmd/bugseti/` | System tray app for distributed bug fixing |
+
+## Quick Start
+
+```go
+import core "forge.lthn.ai/core/go/pkg/framework/core"
+
+c, err := core.New(
+    core.WithService(NewMyService),
+    core.WithAssets(assets),
+    core.WithServiceLock(),
+)
+```
+
+See [[Service-Lifecycle]] for registration and lifecycle details, [[Message-Bus]] for ACTION/QUERY/TASK patterns, [[Service-Runtime]] for the generic helper, and [[Interfaces]] for all core interfaces.
+
+## Licence
+
+EUPL-1.2