@mattstack/rt-client 0.11.0 → 0.12.0

package/README.md

@@ -111,6 +111,10 @@ socket. The verbs and their payloads are specified in repo-tools
 `docs/superpowers/specs/2026-08-28-rt-chat-delivery-v2-design.md`; the
 agent-facing rules are `skills/rt-chat/SKILL.md`.
 
+## Runs
+
+`RunStageRow.status` is one of `running | done | failed | redirected`; `rt runs stage-redirect` writes the fourth when the work engine leaves a stage for another one, so a reader that maps statuses to icons or filters must handle all four.
+
 ## License
 
 MIT

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import type { RtResponse, RtClientOptions } from "./transport.ts";
-import type { DemandDecl, ProjectMRsData, DiscussionsData, MrByBranchData, BranchEnrichment, ForgeSlug, ForgeTokenData, RunSummary, RunDetail, WakeMode, ChatMember, ChatMessage, RoomSummary, BuddyStatus, PresenceRow, AgentRecord, Commands } from "./commands.ts";
+import type { DemandDecl, ProjectMRsData, DiscussionsData, MrByBranchData, BranchEnrichment, ForgeSlug, ForgeTokenData, RunSummary, RunDetail, WakeMode, ChatMember, ChatMessage, ChatClaimOutcome, RoomSummary, BuddyStatus, PresenceRow, AgentRecord, Commands } from "./commands.ts";
 /**
  * One repo's project open-MR store. A cold repo forces a full paginated sync
  * on the daemon side when maxAgeMs demands it, which can run tens of seconds
@@ -59,9 +59,29 @@ export declare function chatPost(a: {
     handle: string;
     body: string;
     mentions?: string[];
+    quiet?: boolean;
 }, o?: RtClientOptions): Promise<RtResponse<{
     id: number;
     recipients: string[];
+    others: number;
+}>>;
+export declare function chatAck(a: {
+    id: number;
+    handle: string;
+}, o?: RtClientOptions): Promise<RtResponse<{
+    author: string;
+    room: string;
+    already: boolean;
+}>>;
+export declare function chatClaim(a: {
+    id: number;
+    handle: string;
+}, o?: RtClientOptions): Promise<RtResponse<ChatClaimOutcome>>;
+export declare function chatRelease(a: {
+    id: number;
+    handle: string;
+}, o?: RtClientOptions): Promise<RtResponse<{
+    holder: string;
 }>>;
 export declare function chatRead(a: {
     handle: string;

package/dist/commands.d.ts

@@ -22,6 +22,10 @@ export interface ProjectMRsScope {
     sections?: string[];
     /** Demanded sections not yet swept for this client. */
     uncoveredSections?: string[];
+    /** Section headers in the default-branch CODEOWNERS at the last deep or
+        backfill. `[]` when the project has none. Absent from a pre-knownSections
+        daemon or before the first sweep that demanded a section. */
+    knownSections?: string[];
 }
 export interface ProjectMRsData {
     mrs: Record<string, {
@@ -113,6 +117,22 @@ export interface ChatMessage {
     replyTo?: number;
     postedAt: number;
 }
+/** `claimed` is the only outcome that woke anyone; `previousHolder` marks a takeover of an expired claim. */
+export type ChatClaimOutcome = {
+    outcome: "claimed";
+    author: string;
+    room: string;
+    previousHolder?: string;
+} | {
+    outcome: "held";
+    author: string;
+    room: string;
+} | {
+    outcome: "lost";
+    holder: string;
+    claimedAt: number;
+    expiresAt: number;
+};
 export interface RoomSummary {
     room: string;
     memberCount: number;
@@ -347,6 +367,15 @@ export interface StatusData {
         dormant: false;
     };
 }
+/** Duplicated shape on purpose: mirrors lib/worktree/ready-held.ts's ReadyHeldRepo. */
+export interface ReadyHeldRepo {
+    /** Serialized repo identity. A key, never displayed. */
+    repo: string;
+    /** Decoded display name. Never sent back as a key. */
+    label: string;
+    hash: string;
+    approveCommand: string;
+}
 export interface TrayStatusData {
     pid: number;
     uptime: number;
@@ -364,6 +393,8 @@ export interface TrayStatusData {
     };
     metrics: HealthMetrics;
     eventLoop: HealthEventLoop;
+    /** Optional because a daemon older than RT-98 does not send it. */
+    worktreeReadyHeld?: ReadyHeldRepo[];
 }
 /** Duplicated shape on purpose: mirrors lib/port-scanner.ts's PortEntry. */
 export interface PortEntry {
@@ -700,16 +731,46 @@ export interface Commands {
         };
         data: Record<string, never>;
     };
+    /** `others` counts the room's members besides the author, so a caller can tell "woke nobody of 7" from "nobody else is here". */
     "chat:post": {
         payload: {
             room: string;
             handle: string;
             body: string;
             mentions?: string[];
+            quiet?: boolean;
         };
         data: {
             id: number;
             recipients: string[];
+            others: number;
+        };
+    };
+    "chat:ack": {
+        payload: {
+            id: number;
+            handle: string;
+        };
+        data: {
+            author: string;
+            room: string;
+            already: boolean;
+        };
+    };
+    "chat:claim": {
+        payload: {
+            id: number;
+            handle: string;
+        };
+        data: ChatClaimOutcome;
+    };
+    "chat:release": {
+        payload: {
+            id: number;
+            handle: string;
+        };
+        data: {
+            holder: string;
         };
     };
     "chat:read": {

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 export { rtCommand, DEFAULT_SOCK } from "./transport.ts";
 export type { RtResponse, RtClientOptions } from "./transport.ts";
-export { readProjectMRs, readDiscussions, readMrsByBranch, readBranchCache, resolveForgeToken, listRuns, getRun, abandonRun, chatJoin, chatLeave, chatPost, chatRead, chatRooms, chatWho, chatMark, chatMessages, chatSignIn, chatSignOut, chatAway, chatBack, chatBuddies, chatDm, chatArchive, chatDmOpen, eventsHead, agentStart, agentResume, agentGet, agentList, paneList, panePeek, paneSpawn, paneAccounts, paneDirectories, chatInvite, paneSend, paneFocus, } from "./client.ts";
+export { readProjectMRs, readDiscussions, readMrsByBranch, readBranchCache, resolveForgeToken, listRuns, getRun, abandonRun, chatJoin, chatLeave, chatAck, chatClaim, chatRelease, chatPost, chatRead, chatRooms, chatWho, chatMark, chatMessages, chatSignIn, chatSignOut, chatAway, chatBack, chatBuddies, chatDm, chatArchive, chatDmOpen, eventsHead, agentStart, agentResume, agentGet, agentList, paneList, panePeek, paneSpawn, paneAccounts, paneDirectories, chatInvite, paneSend, paneFocus, } from "./client.ts";
 export { COMMAND_NAMES } from "./commands.ts";
-export type { Discussion, DemandDecl, ProjectMRsScope, ProjectMRsData, DiscussionsData, MrByBranchEntry, MrByBranchData, BranchEnrichment, Commands, CommandName, ForgeSlug, ForgeTokenData, Attention, RunSummary, RunStageRow, RunFieldRow, RunDecisionRow, RunDetail, WakeMode, ChatMember, ChatMessage, RoomSummary, BuddyStatus, PresenceRow, AgentRecord, AgentSurface, AgentStatus, ChatPane, PaneAccount, PaneDirectory, InviteResult, PaneDelivery, PaneSendResult, PaneFocusResult, } from "./commands.ts";
+export type { Discussion, DemandDecl, ProjectMRsScope, ProjectMRsData, DiscussionsData, MrByBranchEntry, MrByBranchData, BranchEnrichment, Commands, CommandName, ForgeSlug, ForgeTokenData, Attention, RunSummary, RunStageRow, RunFieldRow, RunDecisionRow, RunDetail, WakeMode, ChatMember, ChatMessage, ChatClaimOutcome, RoomSummary, BuddyStatus, PresenceRow, AgentRecord, AgentSurface, AgentStatus, ChatPane, PaneAccount, PaneDirectory, InviteResult, PaneDelivery, PaneSendResult, PaneFocusResult, } from "./commands.ts";
 export { subscribe, createRelay, DEFAULT_WS_URL } from "./relay.ts";
 export type { RelayEventType } from "./relay.ts";
 export { daemonHealth } from "./health.ts";

package/dist/index.js

@@ -82,8 +82,19 @@ function chatPost(a, o = {}) {
   const payload = { room: a.room, handle: a.handle, body: a.body };
   if (a.mentions !== undefined)
     payload.mentions = a.mentions;
+  if (a.quiet)
+    payload.quiet = true;
   return rtCommand("chat:post", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
 }
+function chatAck(a, o = {}) {
+  return rtCommand("chat:ack", { id: a.id, handle: a.handle }, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
+}
+function chatClaim(a, o = {}) {
+  return rtCommand("chat:claim", { id: a.id, handle: a.handle }, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
+}
+function chatRelease(a, o = {}) {
+  return rtCommand("chat:release", { id: a.id, handle: a.handle }, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
+}
 function chatRead(a, o = {}) {
   const payload = { handle: a.handle };
   if (a.room !== undefined)
@@ -259,6 +270,9 @@ var COMMAND_NAMES = [
   "runs:list",
   "runs:get",
   "runs:abandon",
+  "chat:ack",
+  "chat:claim",
+  "chat:release",
   "chat:join",
   "chat:leave",
   "chat:post",
@@ -802,6 +816,13 @@ var REGISTRY = [
     migrated: true,
     description: "User-confirmed integration hosts (forgeHost, switchboardUrl), written only by an explicit `rt setup <id> connect --host` after that host validates a real credential. The one trusted source a credential is ever sent to — mattstack.integrations' team-declared host is shown to the user but never auto-used for a fetch."
   },
+  {
+    key: "mattstack.roster",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description: "The suite-wide team roster: [{username, name?}] GitLab usernames with optional display names. Any suite app that lists people reads this; hiding someone is the app's own overlay (e.g. boxscore.hiddenMembers)."
+  },
   {
     key: "claude.marketplaces",
     type: "array",
@@ -856,7 +877,7 @@ var REGISTRY = [
     type: "array",
     scopes: ["team"],
     merge: "replace",
-    description: "The authors tab's roster: whose MRs the classic board lists, including hidden-by-default entries. Codeowners tabs list MRs from anyone."
+    description: "The authors tab's roster: whose MRs the classic board lists, including hidden-by-default entries. Codeowners tabs list MRs from anyone. The cross-app roster successor is mattstack.roster; this key remains the board's own list until the board adopts it."
   },
   {
     key: "board.title",
@@ -956,13 +977,6 @@ var REGISTRY = [
     merge: "deep",
     description: "Local working directories the board's review/respond/doctor panes launch from."
   },
-  {
-    key: "board.rtRepos",
-    type: "array",
-    scopes: ["machine"],
-    merge: "replace",
-    description: "rt-registered repo names the board resolves MRs against on this machine."
-  },
   {
     key: "board.triageMaxConcurrent",
     type: "number",
@@ -977,6 +991,62 @@ var REGISTRY = [
     merge: "replace",
     description: "Local switchboard URL the board's POST /peer/join writer targets."
   },
+  {
+    key: "boxscore.projects",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description: 'GitLab projects boxscore scores, as full paths ("group/project").'
+  },
+  {
+    key: "boxscore.linearDoneStates",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description: "Linear workflow state names that count as done. Empty means the completed and canceled state types."
+  },
+  {
+    key: "boxscore.sizeBand",
+    type: "object",
+    scopes: ["team"],
+    merge: "deep",
+    description: "MR size health band in changed lines: {tooSmall, tooLarge}. At or below tooSmall, or above tooLarge, is outside the healthy band."
+  },
+  {
+    key: "boxscore.excludeFilePatterns",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description: 'Glob patterns for files excluded from addition/deletion counts (e.g. "**/*.json").'
+  },
+  {
+    key: "boxscore.ignoredMrs",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description: 'MRs excluded from all metrics: "!123" or "group/project!123".'
+  },
+  {
+    key: "boxscore.botPatterns",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description: "Extra regex sources treated as bot accounts, beyond boxscore's built-in detection."
+  },
+  {
+    key: "boxscore.hiddenMembers",
+    type: "array",
+    scopes: ["user"],
+    merge: "replace",
+    description: "Usernames from mattstack.roster hidden from this developer's leaderboard."
+  },
+  {
+    key: "boxscore.defaultRange",
+    type: "string",
+    scopes: ["user"],
+    merge: "replace",
+    description: 'Default comparison window for the API and CLI when none is given: "7d", "30d", or "90d".'
+  },
   {
     key: "gitq.workSlots",
     type: "object",
@@ -1018,7 +1088,8 @@ var REGISTRY = [
     type: "string",
     scopes: ["user"],
     merge: "replace",
-    description: "Base URL of the chat viewer, no trailing slash. When set, rt chat post and the tail's wake lines end with a link to the room or message."
+    default: "https://chat.mattstack",
+    description: "Base URL of the chat viewer, no trailing slash; rt chat post and the tail's wake lines end with a link to the room or message. Defaults to the viewer deck serves on the mattstack TLD."
   },
   {
     key: "chat.herdrWorkspace",
@@ -1931,6 +2002,7 @@ export {
   chatSignOut,
   chatSignIn,
   chatRooms,
+  chatRelease,
   chatRead,
   chatPost,
   chatMessages,
@@ -1940,10 +2012,12 @@ export {
   chatInvite,
   chatDmOpen,
   chatDm,
+  chatClaim,
   chatBuddies,
   chatBack,
   chatAway,
   chatArchive,
+  chatAck,
   allDefs,
   agentStart,
   agentResume,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mattstack/rt-client",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "type": "module",
   "exports": {
     ".": {

package/src/client.ts

@@ -18,6 +18,7 @@ import type {
   WakeMode,
   ChatMember,
   ChatMessage,
+  ChatClaimOutcome,
   RoomSummary,
   BuddyStatus,
   PresenceRow,
@@ -166,12 +167,32 @@ export function chatLeave(
 }
 
 export function chatPost(
-  a: { room: string; handle: string; body: string; mentions?: string[] },
+  a: { room: string; handle: string; body: string; mentions?: string[]; quiet?: boolean },
   o: RtClientOptions = {},
-): Promise<RtResponse<{ id: number; recipients: string[] }>> {
+): Promise<RtResponse<{ id: number; recipients: string[]; others: number }>> {
   const payload: Record<string, unknown> = { room: a.room, handle: a.handle, body: a.body };
   if (a.mentions !== undefined) payload.mentions = a.mentions;
-  return rtCommand<{ id: number; recipients: string[] }>("chat:post", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
+  if (a.quiet) payload.quiet = true;
+  return rtCommand<{ id: number; recipients: string[]; others: number }>("chat:post", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
+}
+
+export function chatAck(
+  a: { id: number; handle: string },
+  o: RtClientOptions = {},
+): Promise<RtResponse<{ author: string; room: string; already: boolean }>> {
+  return rtCommand<{ author: string; room: string; already: boolean }>(
+    "chat:ack",
+    { id: a.id, handle: a.handle },
+    { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 },
+  );
+}
+
+export function chatClaim(a: { id: number; handle: string }, o: RtClientOptions = {}): Promise<RtResponse<ChatClaimOutcome>> {
+  return rtCommand<ChatClaimOutcome>("chat:claim", { id: a.id, handle: a.handle }, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
+}
+
+export function chatRelease(a: { id: number; handle: string }, o: RtClientOptions = {}): Promise<RtResponse<{ holder: string }>> {
+  return rtCommand<{ holder: string }>("chat:release", { id: a.id, handle: a.handle }, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
 }
 
 export function chatRead(

package/src/commands.ts

@@ -25,6 +25,10 @@ export interface ProjectMRsScope {
   sections?: string[];
   /** Demanded sections not yet swept for this client. */
   uncoveredSections?: string[];
+  /** Section headers in the default-branch CODEOWNERS at the last deep or
+      backfill. `[]` when the project has none. Absent from a pre-knownSections
+      daemon or before the first sweep that demanded a section. */
+  knownSections?: string[];
 }
 
 export interface ProjectMRsData {
@@ -108,6 +112,12 @@ export interface ChatMessage {
   postedAt: number;
 }
 
+/** `claimed` is the only outcome that woke anyone; `previousHolder` marks a takeover of an expired claim. */
+export type ChatClaimOutcome =
+  | { outcome: "claimed"; author: string; room: string; previousHolder?: string }
+  | { outcome: "held"; author: string; room: string }
+  | { outcome: "lost"; holder: string; claimedAt: number; expiresAt: number };
+
 export interface RoomSummary {
   room: string;
   memberCount: number;
@@ -254,11 +264,23 @@ export interface StatusData {
   worktreePool: { dormant: true; repos: string[]; message: string } | { dormant: false };
 }
 
+/** Duplicated shape on purpose: mirrors lib/worktree/ready-held.ts's ReadyHeldRepo. */
+export interface ReadyHeldRepo {
+  /** Serialized repo identity. A key, never displayed. */
+  repo: string;
+  /** Decoded display name. Never sent back as a key. */
+  label: string;
+  hash: string;
+  approveCommand: string;
+}
+
 export interface TrayStatusData {
   pid: number; uptime: number; memoryUsage: number; watchedRepos: number; cacheEntries: number;
   portsCached: number; portCacheAge: number | null; lastRefresh: number | null;
   portsByRepo: Record<string, number>; pendingNotifications: number;
   health: { level: HealthLevel; reasons: string[] }; metrics: HealthMetrics; eventLoop: HealthEventLoop;
+  /** Optional because a daemon older than RT-98 does not send it. */
+  worktreeReadyHeld?: ReadyHeldRepo[];
 }
 
 /** Duplicated shape on purpose: mirrors lib/port-scanner.ts's PortEntry. */
@@ -405,7 +427,11 @@ export interface Commands {
   "runs:abandon": { payload: { runId: string; repo?: string; reason?: string }; data: { ok: boolean } };
   "chat:join": { payload: { room: string; handle: string; wakeOn?: WakeMode; cwd?: string; pane?: string }; data: { handle: string; memberCount: number; unread: number } };
   "chat:leave": { payload: { room: string; handle: string }; data: Record<string, never> };
-  "chat:post": { payload: { room: string; handle: string; body: string; mentions?: string[] }; data: { id: number; recipients: string[] } };
+  /** `others` counts the room's members besides the author, so a caller can tell "woke nobody of 7" from "nobody else is here". */
+  "chat:post": { payload: { room: string; handle: string; body: string; mentions?: string[]; quiet?: boolean }; data: { id: number; recipients: string[]; others: number } };
+  "chat:ack": { payload: { id: number; handle: string }; data: { author: string; room: string; already: boolean } };
+  "chat:claim": { payload: { id: number; handle: string }; data: ChatClaimOutcome };
+  "chat:release": { payload: { id: number; handle: string }; data: { holder: string } };
   "chat:read": { payload: { handle: string; room?: string; limit?: number; sinceMs?: number }; data: { rooms: { room: string; messages: ChatMessage[] }[] } };
   "chat:rooms": { payload: { handle: string; includeArchived?: boolean }; data: { rooms: RoomSummary[] } };
   "chat:who": { payload: { room: string }; data: { members: ChatMember[] } };
@@ -547,6 +573,9 @@ export const COMMAND_NAMES: readonly CommandName[] = [
   "runs:list",
   "runs:get",
   "runs:abandon",
+  "chat:ack",
+  "chat:claim",
+  "chat:release",
   "chat:join",
   "chat:leave",
   "chat:post",

package/src/index.ts

@@ -12,6 +12,9 @@ export {
   abandonRun,
   chatJoin,
   chatLeave,
+  chatAck,
+  chatClaim,
+  chatRelease,
   chatPost,
   chatRead,
   chatRooms,
@@ -64,6 +67,7 @@ export type {
   WakeMode,
   ChatMember,
   ChatMessage,
+  ChatClaimOutcome,
   RoomSummary,
   BuddyStatus,
   PresenceRow,

package/src/settings/registry-defs.ts

@@ -288,6 +288,16 @@ export const REGISTRY: readonly SettingDef[] = [
       "User-confirmed integration hosts (forgeHost, switchboardUrl), written only by an explicit `rt setup <id> connect --host` after that host validates a real credential. The one trusted source a credential is ever sent to — mattstack.integrations' team-declared host is shown to the user but never auto-used for a fetch.",
   },
 
+  // --- mattstack (shared team truth) ---------------------------------------
+  {
+    key: "mattstack.roster",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description:
+      "The suite-wide team roster: [{username, name?}] GitLab usernames with optional display names. Any suite app that lists people reads this; hiding someone is the app's own overlay (e.g. boxscore.hiddenMembers).",
+  },
+
   // --- claude (installer-lane) --------------------------------------------
   {
     key: "claude.marketplaces",
@@ -351,7 +361,7 @@ export const REGISTRY: readonly SettingDef[] = [
     type: "array",
     scopes: ["team"],
     merge: "replace",
-    description: "The authors tab's roster: whose MRs the classic board lists, including hidden-by-default entries. Codeowners tabs list MRs from anyone.",
+    description: "The authors tab's roster: whose MRs the classic board lists, including hidden-by-default entries. Codeowners tabs list MRs from anyone. The cross-app roster successor is mattstack.roster; this key remains the board's own list until the board adopts it.",
   },
   {
     key: "board.title",
@@ -455,13 +465,6 @@ export const REGISTRY: readonly SettingDef[] = [
     merge: "deep",
     description: "Local working directories the board's review/respond/doctor panes launch from.",
   },
-  {
-    key: "board.rtRepos",
-    type: "array",
-    scopes: ["machine"],
-    merge: "replace",
-    description: "rt-registered repo names the board resolves MRs against on this machine.",
-  },
   {
     key: "board.triageMaxConcurrent",
     type: "number",
@@ -477,6 +480,66 @@ export const REGISTRY: readonly SettingDef[] = [
     description: "Local switchboard URL the board's POST /peer/join writer targets.",
   },
 
+  // --- boxscore -------------------------------------------------------------
+  // No `default` on any boxscore row: fallbacks live in boxscore's app-side
+  // read (server/config), so an unset key resolves as absent here.
+  {
+    key: "boxscore.projects",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description: "GitLab projects boxscore scores, as full paths (\"group/project\").",
+  },
+  {
+    key: "boxscore.linearDoneStates",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description: "Linear workflow state names that count as done. Empty means the completed and canceled state types.",
+  },
+  {
+    key: "boxscore.sizeBand",
+    type: "object",
+    scopes: ["team"],
+    merge: "deep",
+    description: "MR size health band in changed lines: {tooSmall, tooLarge}. At or below tooSmall, or above tooLarge, is outside the healthy band.",
+  },
+  {
+    key: "boxscore.excludeFilePatterns",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description: "Glob patterns for files excluded from addition/deletion counts (e.g. \"**/*.json\").",
+  },
+  {
+    key: "boxscore.ignoredMrs",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description: "MRs excluded from all metrics: \"!123\" or \"group/project!123\".",
+  },
+  {
+    key: "boxscore.botPatterns",
+    type: "array",
+    scopes: ["team"],
+    merge: "replace",
+    description: "Extra regex sources treated as bot accounts, beyond boxscore's built-in detection.",
+  },
+  {
+    key: "boxscore.hiddenMembers",
+    type: "array",
+    scopes: ["user"],
+    merge: "replace",
+    description: "Usernames from mattstack.roster hidden from this developer's leaderboard.",
+  },
+  {
+    key: "boxscore.defaultRange",
+    type: "string",
+    scopes: ["user"],
+    merge: "replace",
+    description: "Default comparison window for the API and CLI when none is given: \"7d\", \"30d\", or \"90d\".",
+  },
+
   // --- gitq ------------------------------------------------------------------
   {
     key: "gitq.workSlots",
@@ -521,7 +584,8 @@ export const REGISTRY: readonly SettingDef[] = [
     type: "string",
     scopes: ["user"],
     merge: "replace",
-    description: "Base URL of the chat viewer, no trailing slash. When set, rt chat post and the tail's wake lines end with a link to the room or message.",
+    default: "https://chat.mattstack",
+    description: "Base URL of the chat viewer, no trailing slash; rt chat post and the tail's wake lines end with a link to the room or message. Defaults to the viewer deck serves on the mattstack TLD.",
   },
   {
     key: "chat.herdrWorkspace",