test(bench): AX-11 harnesses for data/options/contract/embed/entitlement/i18n/lock/sql/utils/info/config

Wave D — the last 11 benchable primitives. This closes the AX-11 sweep
on core/go: every benchable file now has a perf contract gate alongside
its tests and examples.

* data.go       — Data.New + ReadFile/ReadString hit/miss + List +
                  ListNames + Mounts (over fstest.MapFS fixture)
* options.go    — NewOptions empty/2/5 + Set insert/update + Get hit/miss
                  + Has + typed String/Int/Bool/Float64/Duration accessors
                  + Duration string-parse + Len + Items + Result.New
* contract.go   — New + WithOption/WithOptions/WithServiceLock CoreOptions
                  + ActionServiceStartup/Shutdown + ActionTaskStarted/
                  Progress/Completed contract structs
* embed.go      — Mount root/sub + Embed.ReadFile/ReadString/Open/ReadDir
                  + Sub/FS/BaseDirectory + AddAsset/GetAsset/GetAssetBytes
* entitlement.go — Entitled default/quantity/custom + denied (Security log
                  silenced via quietDefault) + NearLimit below/above/
                  unlimited + UsagePercent + SetEntitlementChecker +
                  SetUsageRecorder + RecordUsage nil/with-recorder
* i18n.go       — Translate default/with-translator/with-args + Language
                  + SetLanguage no-translator/with-translator +
                  AvailableLanguages + AddLocales + Locales +
                  SetTranslator + Translator hit
* lock.go       — c.Lock lookup (warm) + LookupOrCreate (cold) +
                  Lock/Unlock + RLock/RUnlock + TryLock + LockEnable +
                  LockApply + Startables/Stoppables 0/5 registered
* sql.go        — SQLOpen no-driver + SQLDrivers + SQLIsNoRows hit/miss/
                  wrapped (no driver imported in core/go itself; type
                  aliases dominate the file)
* utils.go      — ID + ValidateName hit/empty/traversal + SanitisePath
                  safe/traversal + JoinPath + IsFlag + Arg/ArgString/
                  ArgInt/ArgBool + FilterArgs + ParseFlag (all four shapes)
* info.go       — Env CoreKey/OSKey/Fallthrough/Missing + EnvKeys +
                  OS/Arch/GoVersion/NumCPU + StackBuf
* config.go     — New + Set fresh/update + Get hit/miss + String/Int/Bool
                  hit + ConfigGet[float64] + Enable/Disable/Enabled +
                  EnabledFeatures + NewConfigVar + ConfigVar Get/Set/
                  IsSet/Unset

Bench coverage now spans 60 source files in core/go — every benchable
primitive. Unbenchable files (assert/cli_assert/test/exit/signal/os/
process/command/cli/lsp) are excluded by category, not by oversight.

Author: Snider

config_bench_test.go

@@ -0,0 +1,200 @@
+// SPDX-License-Identifier: EUPL-1.2
+
+// Benchmarks for the Config primitives in config.go.
+// Per AX-11 — c.Config() backs every settings read across the
+// framework: host names, ports, paths, feature gates. String/Int/Bool
+// fire per-call from CLI command handlers, Service.OnStart wiring,
+// and Wails-RPC bindings. Feature flag Enabled() runs on every gated
+// code path. ConfigVar[T] is the per-package field used by services
+// to declare typed config slots.
+//
+// Run:    go test -bench='BenchmarkConfig' -benchmem -run='^$' .
+
+package core_test
+
+import (
+	. "dappco.re/go"
+)
+
+// Sinks defeat compiler DCE.
+var (
+	configSinkConfig  *Config
+	configSinkString  string
+	configSinkInt     int
+	configSinkBool    bool
+	configSinkResult  Result
+	configSinkStrings []string
+)
+
+// configFixture returns a Config pre-populated with typical settings.
+func configFixture() *Config {
+	c := (&Config{}).New()
+	c.Set("database.host", "homelab.lthn.sh")
+	c.Set("database.port", 5432)
+	c.Set("api.timeout", "30s")
+	c.Set("debug", true)
+	c.Set("weight", 0.42)
+	c.Enable("dark-mode")
+	c.Enable("experimental-fleet")
+	return c
+}
+
+// --- Construction ---
+
+func BenchmarkConfig_New(b *B) {
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		configSinkConfig = (&Config{}).New()
+	}
+}
+
+// --- Settings (Set / Get) ---
+
+func BenchmarkConfig_Set_Fresh(b *B) {
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		cfg := (&Config{}).New()
+		cfg.Set("key", "value")
+	}
+}
+
+func BenchmarkConfig_Set_Update(b *B) {
+	cfg := configFixture()
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		cfg.Set("database.host", "homelab.lthn.sh")
+	}
+}
+
+func BenchmarkConfig_Get_Hit(b *B) {
+	cfg := configFixture()
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		configSinkResult = cfg.Get("database.host")
+	}
+}
+
+func BenchmarkConfig_Get_Miss(b *B) {
+	cfg := configFixture()
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		configSinkResult = cfg.Get("noexist")
+	}
+}
+
+// --- Typed accessors ---
+
+func BenchmarkConfig_String_Hit(b *B) {
+	cfg := configFixture()
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		configSinkString = cfg.String("database.host")
+	}
+}
+
+func BenchmarkConfig_Int_Hit(b *B) {
+	cfg := configFixture()
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		configSinkInt = cfg.Int("database.port")
+	}
+}
+
+func BenchmarkConfig_Bool_Hit(b *B) {
+	cfg := configFixture()
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		configSinkBool = cfg.Bool("debug")
+	}
+}
+
+func BenchmarkConfig_ConfigGet_Float64(b *B) {
+	cfg := configFixture()
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		_ = ConfigGet[float64](cfg, "weight")
+	}
+}
+
+// --- Feature flags ---
+
+func BenchmarkConfig_Enable(b *B) {
+	cfg := configFixture()
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		cfg.Enable("dark-mode")
+	}
+}
+
+func BenchmarkConfig_Disable(b *B) {
+	cfg := configFixture()
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		cfg.Disable("dark-mode")
+	}
+}
+
+func BenchmarkConfig_Enabled_Hit(b *B) {
+	cfg := configFixture()
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		configSinkBool = cfg.Enabled("dark-mode")
+	}
+}
+
+func BenchmarkConfig_Enabled_Miss(b *B) {
+	cfg := configFixture()
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		configSinkBool = cfg.Enabled("noexist")
+	}
+}
+
+func BenchmarkConfig_EnabledFeatures(b *B) {
+	cfg := configFixture()
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		configSinkStrings = cfg.EnabledFeatures()
+	}
+}
+
+// --- ConfigVar[T] (per-package typed slot) ---
+
+func BenchmarkConfig_NewConfigVar(b *B) {
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		_ = NewConfigVar[int](42)
+	}
+}
+
+func BenchmarkConfig_ConfigVar_Get(b *B) {
+	v := NewConfigVar[int](42)
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		configSinkInt = v.Get()
+	}
+}
+
+func BenchmarkConfig_ConfigVar_Set(b *B) {
+	v := NewConfigVar[int](42)
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		v.Set(43)
+	}
+}
+
+func BenchmarkConfig_ConfigVar_IsSet(b *B) {
+	v := NewConfigVar[int](42)
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		configSinkBool = v.IsSet()
+	}
+}
+
+func BenchmarkConfig_ConfigVar_Unset(b *B) {
+	v := NewConfigVar[int](42)
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		v.Unset()
+	}
+}

contract_bench_test.go

@@ -0,0 +1,132 @@
+// SPDX-License-Identifier: EUPL-1.2
+
+// Benchmarks for the framework-contract primitives in contract.go.
+// Per AX-11 — the With* CoreOption functions are applied once per
+// core.New() call. The Action* contract structs (ActionServiceStartup,
+// ActionTaskStarted/Progress/Completed) flow across the IPC bus on
+// every lifecycle event. The bench gates the option-application path
+// and the contract-construction cost.
+//
+// Run:    go test -bench='BenchmarkContract' -benchmem -run='^$' .
+
+package core_test
+
+import (
+	. "dappco.re/go"
+)
+
+// Sinks defeat compiler DCE.
+var (
+	contractSinkCore    *Core
+	contractSinkOption  CoreOption
+	contractSinkMessage Message
+)
+
+// --- New + WithOption flow ---
+
+func BenchmarkContract_New_WithOptions(b *B) {
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		contractSinkCore = New(
+			WithOption("name", "bench"),
+			WithOption("port", 9000),
+		)
+	}
+}
+
+func BenchmarkContract_New_WithFullOptions(b *B) {
+	opts := NewOptions(
+		Option{Key: "name", Value: "bench"},
+		Option{Key: "port", Value: 9000},
+		Option{Key: "debug", Value: true},
+	)
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		contractSinkCore = New(WithOptions(opts))
+	}
+}
+
+func BenchmarkContract_New_WithServiceLock(b *B) {
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		contractSinkCore = New(WithServiceLock())
+	}
+}
+
+// --- CoreOption constructors (closure allocation) ---
+
+func BenchmarkContract_WithOption(b *B) {
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		contractSinkOption = WithOption("name", "bench")
+	}
+}
+
+func BenchmarkContract_WithOptions(b *B) {
+	opts := NewOptions(Option{Key: "name", Value: "bench"})
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		contractSinkOption = WithOptions(opts)
+	}
+}
+
+func BenchmarkContract_WithName(b *B) {
+	factory := func(c *Core) Result {
+		return Result{Value: &struct{ id int }{id: 1}, OK: true}
+	}
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		contractSinkOption = WithName("bench", factory)
+	}
+}
+
+// --- Lifecycle action contracts ---
+
+func BenchmarkContract_ActionServiceStartup(b *B) {
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		contractSinkMessage = ActionServiceStartup{}
+	}
+}
+
+func BenchmarkContract_ActionServiceShutdown(b *B) {
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		contractSinkMessage = ActionServiceShutdown{}
+	}
+}
+
+// --- Task lifecycle contracts (carry payload) ---
+
+func BenchmarkContract_ActionTaskStarted(b *B) {
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		contractSinkMessage = ActionTaskStarted{
+			TaskIdentifier: "task-42",
+			Action:         "agentic.dispatch",
+		}
+	}
+}
+
+func BenchmarkContract_ActionTaskProgress(b *B) {
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		contractSinkMessage = ActionTaskProgress{
+			TaskIdentifier: "task-42",
+			Action:         "agentic.dispatch",
+			Progress:       0.5,
+			Message:        "halfway",
+		}
+	}
+}
+
+func BenchmarkContract_ActionTaskCompleted(b *B) {
+	b.ReportAllocs()
+	for i := 0; i < b.N; i++ {
+		contractSinkMessage = ActionTaskCompleted{
+			TaskIdentifier: "task-42",
+			Action:         "agentic.dispatch",
+			Result:         Result{OK: true},
+		}
+	}
+}