Merge branch 'develop'

Author: tig

CLAUDE.md

@@ -16,6 +16,7 @@ dotnet build --no-restore
 
 # Tests use xunit.v3 via dotnet run (not dotnet test)
 dotnet run --project tests/Clet.UnitTests --no-build
+dotnet run --project tests/Clet.ConfigTests --no-build
 dotnet run --project tests/Clet.IntegrationTests --no-build
 dotnet run --project tests/Clet.SmokeTests --no-build
 ```
@@ -61,6 +62,7 @@ Projects in this repo:
 
 - **`src/Clet/`** — The CLI executable (net10.0). Depends on `Terminal.Gui` v2 (preview NuGet, currently `2.0.2-develop.24` — pin tracked in `src/Clet/Clet.csproj`, must be replaced with a release tag before v0.5 schema-lock per spec §8 risks). All abstractions are `internal` (not published until v2 plugin system). `BuiltInClets.RegisterAll` registers the shipped clets by hand; auto-discovery via a source generator was explored and dropped.
 - **`tests/Clet.UnitTests/`** — Registry, JSON schema, host pipeline (CommandLineRoot, OutputFormatter, ExitCodes, BuiltInClets) tests.
+- **`tests/Clet.ConfigTests/`** — Non-parallel assembly for all `ConfigurationManager`-touching tests (EditorSettings, FileAccessSettings CM round-trips). `xunit.runner.json` disables both assembly and collection parallelization. **Never enable CM in the other parallel test projects.**
 - **`tests/Clet.IntegrationTests/`** — In-process tests that init Terminal.Gui (`Application.Create()`, `app.Init("ansi")`).
 - **`tests/Clet.SmokeTests/`** — Process-level smoke tests (`Process.Start` against the built `Clet.dll`). The keystroke-driven cases land at v0.3 with TUIcast — see `specs/decisions.md` D-007.
 

CONTRIBUTING.md

@@ -70,6 +70,7 @@ Or, without `make`:
 dotnet restore
 dotnet build
 dotnet run --project tests/Clet.UnitTests
+dotnet run --project tests/Clet.ConfigTests
 dotnet run --project tests/Clet.IntegrationTests
 dotnet run --project tests/Clet.SmokeTests
 ```
@@ -82,7 +83,8 @@ All green? Ship it.
 2. **Branch from `develop`**, not `main`. PRs target `develop`. Merging to `main` is a release.
 3. **Keep PRs small.** One thing per PR. If your PR touches the spec, the decisions log, *and* the code — good, that's the doc-update gate doing its job.
 4. **Tests are not optional.** New clet? Unit + integration tests. New CLI flag? CommandLineRoot tests. Bug fix? Regression test.
-5. **Read `CLAUDE.md`** before your first PR. It has the build commands, the doc-update gate checklist, and pointers to the spec and decisions log.
+5. **ConfigurationManager tests live only in `Clet.ConfigTests`.** Never call `ConfigurationManager.Enable/Load/Apply/Disable` or set `ConfigurationManager.AppName`/`RuntimeConfig` in the parallel test projects (`Clet.UnitTests`, `Clet.IntegrationTests`, `Clet.SmokeTests`, `Clet.UITests`). CM is process-global; `Clet.ConfigTests` disables all parallelization at the assembly level to guarantee deterministic discovery order.
+6. **Read `CLAUDE.md`** before your first PR. It has the build commands, the doc-update gate checklist, and pointers to the spec and decisions log.
 
 ## What we're looking for
 

Clet.slnx

@@ -1,5 +1,6 @@
 <Solution>
   <Project Path="src/Clet/Clet.csproj" />
+  <Project Path="tests/Clet.ConfigTests/Clet.ConfigTests.csproj" />
   <Project Path="tests/Clet.UnitTests/Clet.UnitTests.csproj" />
   <Project Path="tests/Clet.IntegrationTests/Clet.IntegrationTests.csproj" />
   <Project Path="tests/Clet.SmokeTests/Clet.SmokeTests.csproj" />

Directory.Build.props

@@ -13,9 +13,9 @@
     <Copyright>Copyright (c) gui-cs and contributors</Copyright>
 
     <!-- Pinned Terminal.Gui version. CI / release workflows can override via -p:TerminalGuiVersion=<x>. -->
-    <TerminalGuiVersion Condition="'$(TerminalGuiVersion)' == ''">2.1.1-develop.98</TerminalGuiVersion>
+    <TerminalGuiVersion Condition="'$(TerminalGuiVersion)' == ''">2.2.1</TerminalGuiVersion>
     <!-- Pinned Terminal.Gui.Editor version. CI / release workflows can override via -p:TerminalGuiEditorVersion=<x>. -->
-    <TerminalGuiEditorVersion Condition="'$(TerminalGuiEditorVersion)' == ''">2.1.1-develop.*</TerminalGuiEditorVersion>
+    <TerminalGuiEditorVersion Condition="'$(TerminalGuiEditorVersion)' == ''">2.2.1</TerminalGuiEditorVersion>
   </PropertyGroup>
 
 </Project>

Makefile

@@ -66,6 +66,7 @@ build-release: restore
 
 test:
 	dotnet run --project tests/Clet.UnitTests --no-build
+	dotnet run --project tests/Clet.ConfigTests --no-build
 	dotnet run --project tests/Clet.IntegrationTests --no-build
 	dotnet run --project tests/Clet.SmokeTests --no-build
 

src/Clet/Clets/Viewer/ConfigClet.cs

@@ -307,6 +307,12 @@ void TryQuit ()
     /// <summary>Returns the path to <c>~/.tui/clet.config.json</c>.</summary>
     internal static string GetConfigPath ()
     {
+        if (!OperatingSystem.IsWindows ()
+            && Environment.GetEnvironmentVariable ("HOME") is { Length: > 0 } homeOverride)
+        {
+            return Path.Combine (homeOverride, ".tui", ConfigFileName);
+        }
+
         string home = Environment.GetFolderPath (Environment.SpecialFolder.UserProfile);
 
         return Path.Combine (home, ".tui", ConfigFileName);