README
¶
symaira-corekit
Shared Go library for the Symaira public-core tools (symvault, symmemory, symseek, symfetch).
Bundles domain-free infrastructure that is otherwise duplicated across tools: MCP server scaffold, TOML config loading, exit codes, logging, path safety, SQLite setup, and update checking.
Packages
| Package | Purpose |
|---|---|
exitcodes |
Typed exit codes (ExitOK, ExitError, ExitUsage, ExitAuth) and CLIError type |
logkit |
Structured logging (log/slog) to stderr, configurable via SYM<APP>_LOG_LEVEL |
envutil |
Safe environment variable access with alias support |
fsutil |
Atomic file writes, path traversal validation, temp-file safety |
configkit |
TOML config loader with XDG paths, project overrides, and env vars |
mcpserver |
Generic JSON-RPC 2.0 stdio server for MCP tool registration |
sqlitekit |
modernc.org/sqlite wrapper with WAL mode and embedded migrations |
updatecheck |
GitHub release checker (opt-in, max 1×/24h) |
Usage
import "github.com/danieljustus/symaira-corekit/logkit"
logger := logkit.Setup("myapp")
logger.Info("started", "version", "1.0.0")
Versioning
Strict SemVer. Each tool pins its corekit version in go.mod.
License
MIT — Daniel Justus
Directories
¶
| Path | Synopsis |
|---|---|
|
Package configkit provides generic TOML configuration loading with env var overrides.
|
Package configkit provides generic TOML configuration loading with env var overrides. |
|
Package envutil provides environment variable helpers with fallback support.
|
Package envutil provides environment variable helpers with fallback support. |
|
Package exitcodes provides standardized CLI exit codes and structured error types for the Symaira ecosystem.
|
Package exitcodes provides standardized CLI exit codes and structured error types for the Symaira ecosystem. |
|
Package fsutil provides safe filesystem operations including atomic writes and path validation.
|
Package fsutil provides safe filesystem operations including atomic writes and path validation. |
|
Package logkit provides structured logging helpers for CLI applications.
|
Package logkit provides structured logging helpers for CLI applications. |
|
Package mcpserver provides a JSON-RPC 2.0 server framework for the Model Context Protocol (MCP).
|
Package mcpserver provides a JSON-RPC 2.0 server framework for the Model Context Protocol (MCP). |
|
Package sqlitekit provides SQLite connection management and migration support using pure-Go SQLite.
|
Package sqlitekit provides SQLite connection management and migration support using pure-Go SQLite. |
|
Package updatecheck provides GitHub release checking for CLI application updates.
|
Package updatecheck provides GitHub release checking for CLI application updates. |
Click to show internal directories.
Click to hide internal directories.