jamesshenry · jamesshenry · Apr 30, 2026 · May 1, 2026 · May 3, 2026 · May 5, 2026
diff --git a/.build/instructions.md b/.build/instructions.md
@@ -0,0 +1,61 @@
+# Loom Build Instructions
+
+## Prerequisites
+
+- .NET SDK from `global.json`
+- Tool manifest in `dotnet-tools.json`
+
+Install/restore tools:
+
+```bash
+dotnet tool restore
+```
+
+Required tools and dependent Loom modules:
+
+| Tool Command | Tool Package | Dependent Module(s) |
+| --- | --- | --- |
+| `loom` | `loom.build` | CLI entry point used to run all targets/modules |
+| `minver` | `minver-cli` | `MinVerModule` |
+| `vpk` | `vpk` | `VelopackReleaseModule` |
+| `reportgenerator` | `dotnet-reportgenerator-globaltool` | `ReportGeneratorModule` |
+
+## Setup
+
+Initialize Loom files:
+
+```bash
+dotnet loom init
+```
+
+Run tests:
+
+```bash
+dotnet loom test
+```
+
+Run release pipeline:
+
+```bash
+dotnet loom release
+```
+
+## Enable NuGet and GitHub Releases
+
+To allow upload/publishing modules to run, enable the following flags in `.build/loom.json`:
+
+```json
+{
+    "workspace": {
+        "enableNugetUpload": true,
+        "enableGithubRelease": true
+    }
+}
+```
+
+Also configure required GitHub secrets:
+
+- `GITHUB_TOKEN` is the built-in GitHub Actions token (`secrets.GITHUB_TOKEN`).
+- Create a repository secret named `NUGET_API_KEY`.
+
+See release workflow setup in [.github/workflows/release.yml](../.github/workflows/release.yml).
diff --git a/.build/loom.json b/.build/loom.json
@@ -6,6 +6,7 @@
     "cleanDirectories": [],
     "enableNugetUpload": false,
     "enableGithubRelease": true,
+    "defaultPreReleaseIdentifiers": "preview.0",
     "enableVelopackRelease": true
   },
   "artifacts": {

diff --git a/.build/loom.schema.json b/.build/loom.schema.json
@@ -69,6 +69,10 @@
           "type": "boolean",
           "description": "Whether to create a GitHub release during a release."
         },
+        "defaultPreReleaseIdentifiers": {
+          "type": "string",
+          "description": "Maps to MinVer.DefaultPreReleaseIdentifiers"
+        },
         "enableVelopackRelease": {
           "type": "boolean",
           "description": "Whether to create velopack packages during a release."

diff --git a/.config/dotnet-tools.json b/.config/dotnet-tools.json
@@ -17,7 +17,7 @@
       "rollForward": false
     },
     "loom.build": {
-      "version": "0.5.0",
+      "version": "0.6.0",
       "commands": [
         "loom"
       ],

diff --git a/.editorconfig b/.editorconfig
@@ -490,7 +490,7 @@ dotnet_diagnostic.RCS1042.severity = suggestion
 dotnet_diagnostic.RCS1043.severity = suggestion
 dotnet_diagnostic.RCS1045.severity = warning
 dotnet_diagnostic.RCS1050.severity = silent # Simplify object creation
-dotnet_diagnostic.RCS1051.severity = suggestion
+dotnet_diagnostic.RCS1051.severity = none
 dotnet_diagnostic.RCS1060.severity = suggestion
 dotnet_diagnostic.RCS1061.severity = suggestion
 dotnet_diagnostic.RCS1062.severity = suggestion

diff --git a/.foam/templates/adr-template.md b/.foam/templates/adr-template.md
@@ -0,0 +1,19 @@
+---
+status: proposed
+---
+
+# ADR 2: MVVM Binding Logic and Lifecycle Management
+
+## Context
+
+ENTER HERE
+
+## Decision
+
+ENTER HERE
+
+## Conesquences
+
+### Pros
+
+### Cons
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
@@ -7,10 +7,18 @@ updates:
       interval: weekly
       day: monday
     open-pull-requests-limit: 5
+    groups:
+      nuget-dependencies:
+        patterns:
+          - "*"
 
   - package-ecosystem: github-actions
     directory: "/"
     schedule:
       interval: weekly
       day: monday
     open-pull-requests-limit: 5
+    groups:
+      github-actions-dependencies:
+        patterns:
+          - "*"
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -36,7 +36,7 @@ jobs:
         run: dotnet tool restore
 
       - name: Run Loom Test Pipeline
-        run: dotnet loom Test
+        run: dotnet loom test
 
       - name: Upload test results
         if: always()

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -35,7 +35,7 @@ jobs:
         run: dotnet tool restore
 
       - name: Run tests
-        run: dotnet loom Test
+        run: dotnet loom test
 
   release:
     name: Release Artifacts for ${{ matrix.rid }}
@@ -73,4 +73,4 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           Nuget__ApiKey: ${{ secrets.NUGET_API_KEY }}
-        run: dotnet loom Release
+        run: dotnet loom release
diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -0,0 +1,5 @@
+{
+    "[csharp]": {
+        "editor.defaultFormatter": "ms-dotnettools.csharp"
+    }
+}
diff --git a/Directory.Build.props b/Directory.Build.props
diff --git a/README.md b/README.md
@@ -1,4 +1,4 @@
 ## TODO
 
-- add separate stats view and viewmodel that can receive messages during game.
+- add separate stats view and viewmodel that can receive messages during test.
 - finishing wireframes
diff --git a/Typical.slnx b/Typical.slnx
@@ -1,6 +1,15 @@
 <Solution>
   <Folder Name="/Solution Items/">
     <File Path=".editorconfig" />
+    <File Path=".gitignore" />
+    <File Path="src/Directory.Build.props" />
+    <File Path="src/Directory.Packages.props" />
+    <File Path="global.json" />
+    <File Path="LICENSE.md" />
+    <File Path="nuget.config" />
+    <File Path="README.md" />
+    <File Path="run.ps1" />
+    <File Path="todo.md" />
   </Folder>
   <Folder Name="/src/">
     <Project Path="src/Typical.Core/Typical.Core.csproj" />

diff --git a/global.json b/global.json
@@ -1,6 +1,6 @@
 {
   "sdk": {
-    "version": "11.0.100-preview.3.26207.106",
+    "version": "11.0.100-preview.4.26230.115",
     "allowPrerelease": true
   },
   "test": {

diff --git a/nuget.config b/nuget.config
@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?>
+<?xml version="1.0" encoding="utf-8"?>
 <configuration>
   <packageSources>
     <!--To inherit the global NuGet package sources remove the <clear/> line below -->

diff --git a/src/Directory.Build.props b/src/Directory.Build.props
@@ -7,6 +7,8 @@
     <Nullable>enable</Nullable>
     <DebugType>embedded</DebugType>
     <ArtifactsPath>$(MSBuildThisFileDirectory)..\.artifacts</ArtifactsPath>
+    <EmitCompilerGeneratedFiles>true</EmitCompilerGeneratedFiles>
+    <Features>runtime-async=on</Features>
   </PropertyGroup>
   <ItemGroup>
     <PackageReference Include="Roslynator.Analyzers">

diff --git a/Directory.Packages.props → src/Directory.Packages.props b/Directory.Packages.props → src/Directory.Packages.props
@@ -7,28 +7,30 @@
     <PackageVersion Include="Bogus" Version="35.6.5" />
     <PackageVersion Include="CommunityToolkit.Mvvm" Version="8.4.2" />
     <PackageVersion Include="CommunityToolkit.Diagnostics" Version="8.4.2" />
+    <PackageVersion Include="Dapper" Version="2.1.79" />
+    <PackageVersion Include="Dapper.AOT" Version="1.0.52" />
     <PackageVersion Include="dbup" Version="5.0.41" />
     <PackageVersion Include="dbup-sqlite" Version="6.0.4" />
     <PackageVersion Include="DbUp.SourceGen" Version="0.0.1" />
     <PackageVersion Include="DotNetPathUtils" Version="0.3.1" />
     <PackageVersion Include="Kuddle.Net" Version="0.8.0" />
     <PackageVersion Include="Kuddle.Net.Extensions.Configuration" Version="0.8.0" />
     <PackageVersion Include="LiteDB" Version="5.0.21" />
-    <PackageVersion Include="Microsoft.Data.Sqlite" Version="10.0.6" />
-    <PackageVersion Include="Microsoft.Extensions.Configuration" Version="10.0.6" />
-    <PackageVersion Include="Microsoft.Extensions.Configuration.Binder" Version="10.0.6" />
-    <PackageVersion Include="Microsoft.Extensions.DependencyInjection" Version="10.0.6" />
+    <PackageVersion Include="Microsoft.Data.Sqlite" Version="10.0.7" />
+    <PackageVersion Include="Microsoft.Extensions.Configuration" Version="10.0.7" />
+    <PackageVersion Include="Microsoft.Extensions.Configuration.Binder" Version="10.0.7" />
+    <PackageVersion Include="Microsoft.Extensions.DependencyInjection" Version="10.0.7" />
     <PackageVersion
       Include="Microsoft.Extensions.DependencyInjection.Abstractions"
-      Version="10.0.6"
+      Version="10.0.7"
     />
     <PackageVersion
       Include="Microsoft.Extensions.Options.ConfigurationExtensions"
-      Version="10.0.6"
+      Version="10.0.7"
     />
-    <PackageVersion Include="Microsoft.Extensions.Hosting" Version="10.0.6" />
-    <PackageVersion Include="Microsoft.Extensions.Hosting.Abstractions" Version="10.0.6" />
-    <PackageVersion Include="Microsoft.Extensions.Logging.Abstractions" Version="10.0.6" />
+    <PackageVersion Include="Microsoft.Extensions.Hosting" Version="10.0.7" />
+    <PackageVersion Include="Microsoft.Extensions.Hosting.Abstractions" Version="10.0.7" />
+    <PackageVersion Include="Microsoft.Extensions.Logging.Abstractions" Version="10.0.7" />
     <PackageVersion Include="Microsoft.Extensions.TimeProvider.Testing" Version="10.5.0" />
     <PackageVersion Include="Microsoft.IdentityModel.JsonWebTokens" Version="8.17.0" />
     <PackageVersion Include="Microsoft.Testing.Extensions.CodeCoverage" Version="18.6.2" />
@@ -45,12 +47,13 @@
     <PackageVersion Include="Serilog.Sinks.Console" Version="6.1.1" />
     <PackageVersion Include="Serilog.Sinks.File" Version="7.0.0" />
     <PackageVersion Include="Spectre.Console" Version="0.55.2" />
+    <PackageVersion Include="Stanza.TerminalGui" Version="0.1.0-preview.6" />
     <PackageVersion Include="System.IdentityModel.Tokens.Jwt" Version="8.17.0" />
-    <PackageVersion Include="Terminal.Gui" Version="2.0.0-rc.4" />
+    <PackageVersion Include="Terminal.Gui" Version="2.4.3" />
     <PackageVersion Include="Velopack" Version="0.0.1298" />
     <PackageVersion Include="Vogen" Version="8.0.5" />
     <PackageVersion Include="Xdg.Directories" Version="0.1.2" />
     <PackageVersion Include="Imposter" Version="0.1.9" />
-    <PackageVersion Include="TUnit" Version="1.37.0" />
+    <PackageVersion Include="TUnit" Version="1.41.0" />
   </ItemGroup>
 </Project>
diff --git a/src/Typical.Core/Data/IStatsRepository.cs b/src/Typical.Core/Data/IStatsRepository.cs
@@ -0,0 +1,8 @@
+using Typical.Core.Statistics;
+
+namespace Typical.Core.Data;
+
+public interface IStatsRepository
+{
+    Task SaveTestResultAsync(TestResult result);
+}
diff --git a/src/Typical.Core/Data/ITextRepository.cs b/src/Typical.Core/Data/ITextRepository.cs
@@ -0,0 +1,8 @@
+namespace Typical.Core.Data;
+
+public interface ITextRepository
+{
+    Task<Quote> GetRandomQuoteAsync();
+    Task<Quote> GetQuoteAsync(int currentId);
+    Task<bool> HasAnyAsync();
+}
diff --git a/src/Typical.Core/Data/Quote.cs b/src/Typical.Core/Data/Quote.cs
@@ -1,19 +1,14 @@
+using System.ComponentModel;
+using System.ComponentModel.DataAnnotations.Schema;
+
 namespace Typical.Core.Data;
 
 public class Quote
 {
     public int Id { get; set; }
     public required string Text { get; set; }
     public required string Author { get; set; }
-    public IEnumerable<string> Tags { get; set; } = [];
+    public List<string> Tags { get; set; } = [];
     public int WordCount { get; set; }
     public int CharCount { get; set; }
 }
-
-public interface ITextRepository
-{
-    Task<Quote> GetRandomQuoteAsync();
-    Task<Quote> GetQuoteAsync(int currentId);
-    Task AddQuotesAsync(IEnumerable<Quote> quotes);
-    Task<bool> HasAnyAsync();
-}
diff --git a/src/Typical.Core/Events/BackspacePressedEvent.cs b/src/Typical.Core/Events/BackspacePressedEvent.cs
diff --git a/src/Typical.Core/Events/GameEndedEvent.cs b/src/Typical.Core/Events/GameEndedEvent.cs
diff --git a/src/Typical.Core/Events/GameQuitEvent.cs b/src/Typical.Core/Events/GameQuitEvent.cs
diff --git a/src/Typical.Core/Events/KeyPressedEvent.cs b/src/Typical.Core/Events/KeyPressedEvent.cs
diff --git a/...ical.Core/Events/GameStateUpdatedEvent.cs → ...l.Core/Events/StatisticsUpdatedMessage.cs b/...ical.Core/Events/GameStateUpdatedEvent.cs → ...l.Core/Events/StatisticsUpdatedMessage.cs
@@ -2,12 +2,10 @@
 
 namespace Typical.Core.Events;
 
-public record GameStateUpdatedMessage(
-    GameSnapshot State
+public record TestSessionUpdatedMessage(
+    TestSnapshot Snapshot
 );
 
-public record GameResetMessage(ModeSettings Settings);
-
 public record WordsMode(int Count, bool Punctuation, bool Numbers);
 public record TimeMode(TimeSpan Duration, bool Punctuation, bool Numbers);
 public record QuoteMode(QuoteLength Length);

diff --git a/src/Typical.Core/Events/TestCompletedMessage.cs b/src/Typical.Core/Events/TestCompletedMessage.cs
@@ -0,0 +1,5 @@
+using Typical.Core.Statistics;
+
+namespace Typical.Core.Events;
+
+public record TestCompletedMessage(TestResult Result);
diff --git a/src/Typical.Core/Events/TestResetMessage.cs b/src/Typical.Core/Events/TestResetMessage.cs
@@ -0,0 +1,3 @@
+namespace Typical.Core.Events;
+
+public record TestResetMessage(ModeSettings Settings);
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		namespace Typical.Core.Events;

		public record TestResetMessage(ModeSettings Settings);