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

go get forge.lthn.ai/core/go

Package Map

Package	Purpose
`pkg/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

import core "forge.lthn.ai/core/go/pkg/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