core/go

generated from lthn/LEM

Snider 1f0c618b7a fix: rewrite 4 stale docs — messaging, primitives, index, getting-started, testing

All PERFORM/RegisterTask/type Task any references replaced with
named Action patterns. Every code example now uses the v0.8.0 API.

- docs/messaging.md: full rewrite — ACTION/QUERY + named Actions + Task
- docs/primitives.md: full rewrite — added Action, Task, Registry, Entitlement
- docs/index.md: full rewrite — updated surface table, quick example, doc links
- docs/getting-started.md: 2 RegisterTask+PERFORM blocks → Action pattern
- docs/testing.md: 1 RegisterTask+PERFORM block → Action pattern

An agent reading any doc file now gets compilable code.

Co-Authored-By: Virgil <virgil@lethean.io>

2026-03-25 17:13:27 +00:00

2.1 KiB

Raw Blame History

title	description
CoreGO	AX-first documentation for the CoreGO framework.

CoreGO

CoreGO is the foundation layer for the Core ecosystem. Module: dappco.re/go/core.

What CoreGO Provides

Primitive	Purpose
`Core`	Central container — everything registers here
`Service`	Lifecycle-managed component (Startable/Stoppable return Result)
`Action`	Named callable with panic recovery + entitlement
`Task`	Composed sequence of Actions
`Registry[T]`	Thread-safe named collection (universal brick)
`Command`	Path-based CLI command tree
`Process`	Managed execution (Action sugar over go-process)
`API`	Remote streams (protocol handlers + Drive)
`Entitlement`	Permission gate (default permissive, consumer replaces)
`ACTION`, `QUERY`	Anonymous broadcast + request/response
`Data`, `Drive`, `Fs`, `Config`, `I18n`	Built-in subsystems

Quick Example

package main

import "dappco.re/go/core"

func main() {
    c := core.New(
        core.WithOption("name", "agent-workbench"),
        core.WithService(cache.Register),
        core.WithServiceLock(),
    )
    c.Run()
}

API Specification

The full contract is docs/RFC.md (21 sections, 1476 lines). An agent should be able to write a service from RFC.md alone.

Documentation

Path	Covers
RFC.md	Authoritative API contract (21 sections)
primitives.md	Option, Result, Action, Task, Registry, Entitlement
services.md	Service registry, ServiceRuntime, service locks
commands.md	Path-based commands, Managed field
messaging.md	ACTION, QUERY, named Actions, PerformAsync
lifecycle.md	RunE, ServiceStartup, ServiceShutdown
subsystems.md	App, Data, Drive, Fs, Config, I18n
errors.md	core.E(), structured errors, panic recovery
testing.md	AX-7 TestFile_Function_{Good,Bad,Ugly}
configuration.md	WithOption, WithService, WithServiceLock

2.1 KiB Raw Blame History