Enhance protocol and simulation features with activity tracking and behavior definitions

- Updated protocol documentation to include new `activity` and `activityLabel` fields in the person card response, reflecting real-time activity status.
- Introduced `BehaviorDef` to define behavior rules, including need thresholds and lesson skill gains, enhancing AI decision-making.
- Revised the `DefCatalog` to incorporate behavior definitions and updated validation logic to ensure proper behavior handling.
- Enhanced the simulation to manage presence and activity states, allowing for more dynamic interactions within the school environment.
- Updated tests to validate the new activity tracking and behavior functionalities, ensuring robust performance and reliability.
- Improved localization strings to support new activity and behavior features, enhancing user experience.

src/HSchool.Server/Game/PersonCardReader.cs

@@ -14,6 +14,9 @@ internal static class PersonCardReader
     private static readonly QueryDescription IdentityAndNeeds =
         new QueryDescription().WithAll<PersonIdentity, PersonNeeds>();
 
+    private static readonly QueryDescription IdentityAndActivity =
+        new QueryDescription().WithAll<PersonIdentity, PersonActivity>();
+
     public static PersonCardResponse? Read(School school, string personId, string locale)
     {
         var roster = school.Roster;
@@ -42,6 +45,17 @@ internal static class PersonCardReader
         }
 
         var needs = LiveNeeds(school.World, personId) ?? person.Needs;
+        var activityId = LiveActivity(school.World, personId);
+        string? activityLabel = null;
+        if (activityId is not null && catalog is not null && catalog.Actions.TryGetValue(activityId, out var action))
+        {
+            activityLabel = catalog.Label(locale, action);
+        }
+        else if (activityId is not null)
+        {
+            activityLabel = activityId;
+        }
+
         return new PersonCardResponse(
             person.Id,
             person.Name.Full,
@@ -61,6 +75,8 @@ internal static class PersonCardReader
             Skills(person, catalog, locale),
             Traits(person, catalog, locale),
             Needs(needs, catalog, locale),
+            activityId,
+            activityLabel,
             Family(roster, person));
     }
 
@@ -77,6 +93,20 @@ internal static class PersonCardReader
         return found;
     }
 
+    private static string? LiveActivity(World world, string personId)
+    {
+        string? found = null;
+        var query = IdentityAndActivity;
+        world.Query(in query, (ref PersonIdentity identity, ref PersonActivity activity) =>
+        {
+            if (identity.Id.Equals(personId, StringComparison.Ordinal) && activity.IsActive)
+            {
+                found = activity.ActionId;
+            }
+        });
+        return found;
+    }
+
     private static IReadOnlyList<LabeledStatResponse> Body(Person person, DefCatalog? catalog, string locale)
     {
         var rows = new List<LabeledStatResponse>();