feat: core/go v0.8.0 — full AX migration

[Snider]

Summary

• All 21 RFC sections implemented (483 tests, 84.7% coverage)
• AX quality gates clean: zero disallowed imports in production + test code
• AX-7 test naming: 100% conforming (Good/Bad/Ugly)
• 1:1 example test coverage for all source files
• Process primitive, API streams, Entitlement, Task composition, PerformAsync
• String primitives (Concat, Split, Join, Replace, etc.)
• JSON primitives (JSONMarshal, JSONUnmarshal, JSONMarshalString)
• Path primitives (Path, JoinPath, PathBase, PathDir, PathExt, PathGlob)
• Error primitives (E, Wrap, WrapCode, Is, As, Root, StackTrace)

Test plan

• go test ./... — all pass
• AX verification: all 4 checks clean
• core/agent builds and tests against these primitives
• core/mcp builds against these primitives

🤖 Generated with Claude Code
Co-Authored-By: Virgil virgil@lethean.io

Summary by CodeRabbit

• New Features

  • Action system: register and invoke named commands with optional schemas
  • Task composition: chain actions sequentially with conditional piping
  • Entitlement system: permission-based access control with usage tracking
  • Remote API support: stream-based communication with protocol handlers
  • Enhanced filesystem operations: atomic writes and sandbox control
  • JSON serialization helpers

• Refactor

  • Constructor now uses functional options pattern
  • Service lifecycle methods return unified Result type
  • Command management simplified via Managed field

• Documentation

  • New authoritative RFC specification document added

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

This pull request comprehensively restructures the CoreGO framework API: introducing named action and task composition, remote API/streaming support, entitlement-based permissions, process primitives, and a unified generic registry infrastructure. Documentation, lifecycle contracts, and service semantics were overhauled to reflect these changes.

Changes

Cohort / File(s)	Summary
Framework Documentation & Guidance CLAUDE.md, README.md, llm.txt, docs/RFC.md, docs/index.md, docs/primitives.md, docs/messaging.md, docs/testing.md, docs/getting-started.md	Updated API guidance to reflect core architectural changes: functional options pattern (core.New(...) with WithOption/WithService/WithServiceLock), new action/task/entitlement primitives, lifecycle via RunE(), and registry-backed subsystems. Repositioned docs/RFC.md as the authoritative API contract.
Core Architecture & Lifecycle core.go, contract.go, runtime.go	Added RunE() with deferred ServiceShutdown, new entitlement/API fields, and RegistryOf accessor. Updated Startable/Stoppable interfaces to return Result instead of error. Refactored ACTION dispatch to use broadcast with panic recovery per handler.
Named Actions & Composition System action.go, action_test.go, action_example_test.go	Introduced Action type with named handlers, panic recovery, and entitlement gating. Added task composition via Task/Step with sequential execution, async steps, and input piping ("previous"). Implemented Core.Action(name, handler), Core.Task(name, def), and listing methods.
Remote API & Streaming api.go, api_test.go, api_example_test.go	Added API type for remote communication: protocol registration via RegisterProtocol(scheme, factory), stream handling via Stream(name), RPC-style calls via Call(endpoint, action, opts). Integrated RemoteAction dispatch (local fallback when name lacks colon).
Entitlement & Permission System entitlement.go, entitlement_test.go, entitlement_example_test.go	Introduced Entitlement struct with Allowed, Unlimited, Limit, Used, Remaining, and Reason fields. Added EntitlementChecker and UsageRecorder hooks, plus Core.Entitled, SetEntitlementChecker, and RecordUsage methods. Enforced in Action.Run with audit logging.
Process Primitives process.go, process_test.go	Added Process type delegating execution to named actions (process.run, process.start, process.kill). Implemented Run, RunIn, RunWithEnv for synchronous execution and Start/Kill for detached/termination operations. Capability gating via action registration.
Generic Registry Infrastructure registry.go, registry_test.go, registry_example_test.go	Implemented generic thread-safe Registry[T] with insertion-order tracking, pattern-based listing, disable/enable soft-state, and write-mode controls (Lock, Seal, Open). Replaced internal map-based registries (Service, Command, Drive, Data) with embedded registries.
Service Management Refactoring service.go, service_test.go, service_example_test.go	Replaced internal service map with ServiceRegistry embedding *Registry[*Service]. Updated lifecycle hooks to return Result. Changed Core.Service and Core.RegisterService to use registry API (Get, Set, Has). Updated Core.Services() to return insertion-ordered names.
Command & CLI System Updates command.go, command_test.go, command_example_test.go, cli.go	Replaced CommandLifecycle interface with simple Managed string field and IsManaged() method. Introduced CommandRegistry embedding *Registry[*Command]. Updated CLI command resolution and help generation to use registry operations. Removed command lifecycle delegation methods.
Task & Background Work Refactoring task.go, task_test.go, task_example_test.go	Replaced task-type-based dispatch with action-name-based PerformAsync(action string, opts Options). Updated IPC payloads (ActionTaskStarted, ActionTaskCompleted, ActionTaskProgress) to use action names and Result wrapping instead of concrete task types. Adjusted panic recovery and progress emission.
IPC & Messaging System ipc.go, ipc_test.go	Added actions and tasks named registries to Ipc. Introduced broadcast method for fire-and-forget ACTION dispatch with per-handler panic recovery. Added RegisterAction and RegisterActions public methods. Removed prior task handler fields.
Configuration Management config.go, config_test.go, config_example_test.go	Added NewConfigVar[T](val T) constructor. Enhanced documentation for ConfigVar getters and feature-flag operations (Enable, Disable, Enabled, EnabledFeatures). No functional logic changes to existing methods.
Data & Embedded Assets data.go, data_test.go	Replaced internal mounts map with *Registry[*Embed] embedding. Updated Data.New to use Set(name, emb) and Mounts() to delegate to Names() (insertion-ordered).
Drive & Transport Handles drive.go, drive_test.go, drive_example_test.go	Refactored Drive from map-based to *Registry[*DriveHandle] embedding. Removed explicit Get, Has, Names methods; registry API provides these. Updated transport extraction to inline opts.String("transport").
Filesystem & Atomic Operations fs.go, fs_test.go, fs_example_test.go	Added NewUnrestricted(), Root(), TempDir(prefix), WriteAtomic(p, content). Added DirFS(dir) for fs.FS exposure. Introduced ReadAll, WriteAll, CloseStream package-level helpers for stream handling. Updated internal path operations to use Path utility and sandbox validation.
Lock System Refactoring lock.go, lock_test.go, lock_example_test.go	Replaced per-name mutex map with *Registry[*sync.RWMutex] embedding in Lock. Updated LockEnable and LockApply to toggle lockEnabled flag and call registry's Lock() directly. Updated Startables/Stoppables to iterate via services.Each(...) and removed "srv" read-lock acquisition.
Error Handling & Logging error_test.go, error_example_test.go, log_test.go, log_example_test.go	Updated test error construction from errors.New to NewError. Renamed test functions with TestError_ and TestLog_ prefixes. Added example functions for error helpers (E, Wrap, Root) and logging (Info, Warn, Security).
JSON Utilities json.go, json_test.go	Added JSONMarshal, JSONMarshalString, JSONUnmarshal, JSONUnmarshalString functions wrapping encoding/json with Result-based error handling.
String & Path Utilities string_test.go, string_example_test.go, path_test.go, path_example_test.go, utils.go, utils_test.go	Renamed test functions with TestString_ and TestPath_ prefixes. Added ID() for unique identifier generation, ValidateName() for name validation, SanitisePath() for path normalisation, and Println() stdout helper. Updated filesystem and path handling in tests to use core utilities.
Array, Info, Options, & App Utilities array_example_test.go, info_test.go, info_example_test.go, options.go, options_test.go, app.go	Added array example tests. Updated info environment tests to use flexible validation over hardcoded OS values. Added Result.New and Result.Get documentation comments. Replaced os/exec.LookPath in App.Find with manual isExecutable validation via os.Stat.
Comprehensive Integration Examples example_test.go	Added extensive documentation examples covering core construction, services with lifecycle, actions, tasks, registries, entitlements, process primitives, JSON/utilities, CLI commands, and configuration. Examples demonstrate the updated functional-option pattern and result-oriented design.
Embed System Tests embed_test.go	Renamed test functions with TestEmbed_ prefix. Updated I/O operations to use Fs wrapper and Path utility instead of direct os operations. Switched Extract to use DirFS helper.

---

No sequence diagrams are generated, as the changes span multiple independent subsystems (documentation updates, refactoring of existing patterns, test reorganisation, and new utility functions) rather than introducing a cohesive new feature with complex multi-component interactions.