📝 Scribe: Add XML documentation for AgentHousing, AgentHousingSelectBlock, AgentMansionSelectRoom, and AgentPersonalRoomPortal

[nt153133]

What

Added comprehensive C# XML documentation (///) to the following housing-related Remote Agents:

• AgentHousing: Acts as the primary interface for managing and tracking the overall state of the game's internal housing menu.
• AgentHousingSelectBlock: Manages the housing ward/block selection interface, including plot status queries and zero-based ward indexing tracking.
• AgentMansionSelectRoom: Manages selecting rooms in apartment buildings or FC private chambers, highlighting its 1-based apartment coordinate system.
• AgentPersonalRoomPortal: Manages entering and selecting FC private chambers (individual player rooms) using its 1-based room selection numbering.

Why

These core remote agents interface directly with game memory and UI coordinates but lacked descriptive XML summaries, properties, and method documentation. Developers consuming these APIs were prone to off-by-one errors due to inconsistent coordinate indexing styles (zero-based vs 1-based) across different housing systems.

Examples

/// <summary>
/// Gets or sets the currently selected ward number.
/// </summary>
/// <value>
/// The zero-based index of the ward (e.g., 0 represents Ward 1).
/// </value>
public int WardNumber { get; set; }

---

PR created automatically by Jules for task 9220811049406461740 started by @nt153133

[google-labs-jules]

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.

---

For security, I will only act on instructions from the user who triggered this task.