@mattstack/rt-client 0.15.0 → 0.16.0

package/dist/client.d.ts

@@ -105,10 +105,7 @@ export declare function chatWho(a: {
 }, o?: RtClientOptions): Promise<RtResponse<{
     members: ChatMember[];
 }>>;
-export declare function chatMark(a: {
-    handle: string;
-    room?: string;
-}, o?: RtClientOptions): Promise<RtResponse<Record<string, never>>>;
+export declare function chatMark(a: Commands["chat:mark"]["payload"], o?: RtClientOptions): Promise<RtResponse<Commands["chat:mark"]["data"]>>;
 export declare function chatMessages(a: {
     room: string;
     before?: number;

package/dist/commands.d.ts

@@ -102,12 +102,25 @@ export interface EventsBusEvent {
     value gates-store.ts's release tracking (CAS winner or loser) reacts to. */
 export declare const GATE_BY_PANE = "pane";
 export type GateStatus = "open" | "answered" | "parked" | "closed";
+export type GateOption = string | {
+    value: string;
+    label: string;
+};
+export interface GateOrigin {
+    paneId?: string;
+    tabId?: string;
+    runId?: string;
+    worktree?: string;
+    presentation?: "form" | "wait";
+}
 export interface GateQuestion {
     id: string;
     label: string;
     multi: boolean;
-    options: string[];
+    options: GateOption[];
 }
+export declare function gateOptionValue(o: GateOption): string;
+export declare function gateOptionLabel(o: GateOption): string;
 export interface GateAnswer {
     answers: Record<string, string | string[] | {
         value: string | string[];
@@ -122,6 +135,8 @@ export interface GateRow {
     kind: string;
     questions: GateQuestion[];
     meta: Record<string, unknown> | null;
+    context?: string | null;
+    origin?: GateOrigin | null;
     status: GateStatus;
     answer: GateAnswer | null;
     openedAt: number;
@@ -869,6 +884,7 @@ export interface Commands {
         payload: {
             handle: string;
             room?: string;
+            upto?: number;
         };
         data: Record<string, never>;
     };
@@ -1275,6 +1291,8 @@ export interface Commands {
             nudge?: {
                 session: string;
             };
+            context?: string;
+            origin?: GateOrigin;
         };
         data: {
             id: string;

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, chatAck, chatClaim, chatRelease, chatPost, chatRead, chatRooms, chatWho, chatMark, chatMessages, chatSignIn, chatSignOut, chatAway, chatBack, chatBuddies, chatDm, chatArchive, chatDmOpen, eventsHead, eventsEmit, eventsWait, eventsList, agentStart, agentResume, agentGet, agentList, paneList, panePeek, paneSpawn, paneAccounts, paneDirectories, chatInvite, paneSend, paneFocus, gateOpen, gateAnswer, gateWait, gateList, gatePark, gateClose, gateSubscribe, gateUnsubscribe, gateSubscriptions, } from "./client.ts";
-export { COMMAND_NAMES, GATE_BY_PANE } 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, GateStatus, GateQuestion, GateAnswer, GateRow, GateSubscription, } from "./commands.ts";
+export { COMMAND_NAMES, GATE_BY_PANE, gateOptionValue, gateOptionLabel } 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, GateStatus, GateOption, GateOrigin, GateQuestion, GateAnswer, GateRow, GateSubscription, } 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

@@ -118,6 +118,8 @@ function chatMark(a, o = {}) {
   const payload = { handle: a.handle };
   if (a.room !== undefined)
     payload.room = a.room;
+  if (a.upto !== undefined)
+    payload.upto = a.upto;
   return rtCommand("chat:mark", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
 }
 function chatMessages(a, o = {}) {
@@ -270,7 +272,7 @@ function paneFocus(a, o = {}) {
 }
 function gateOpen(a, o = {}) {
   const payload = { subject: a.subject, kind: a.kind, questions: a.questions };
-  for (const k of ["meta", "agent", "pane", "nudge"])
+  for (const k of ["meta", "agent", "pane", "nudge", "context", "origin"])
     if (a[k] !== undefined)
       payload[k] = a[k];
   return rtCommand("gate:open", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 1e4 });
@@ -312,6 +314,12 @@ function gateSubscriptions(a, o = {}) {
 }
 // src/commands.ts
 var GATE_BY_PANE = "pane";
+function gateOptionValue(o) {
+  return typeof o === "string" ? o : o.value;
+}
+function gateOptionLabel(o) {
+  return typeof o === "string" ? o : o.label || o.value;
+}
 var COMMAND_NAMES = [
   "project-mrs:read",
   "discussions:read",
@@ -1051,6 +1059,14 @@ var REGISTRY = [
     merge: "deep",
     description: "This developer's triage user-intent flags (which triage sweeps run automatically); a sibling flat key of board.triage.doctorSkill, not its container — the board reader assembles the two independently."
   },
+  {
+    key: "board.reReview",
+    type: "object",
+    scopes: ["user", "team"],
+    merge: "deep",
+    default: { enabled: true },
+    description: "Gate for the board's automatic re-review sweep ({enabled}); rt's cron.triage step installs the board-triage trigger only while this is on. A fresh key, not an ownership-latch port, so a default is fine here."
+  },
   {
     key: "board.agent.account",
     type: "string",
@@ -2097,6 +2113,8 @@ export {
   gateSubscriptions,
   gateSubscribe,
   gatePark,
+  gateOptionValue,
+  gateOptionLabel,
   gateOpen,
   gateList,
   gateClose,

package/package.json

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

package/src/client.ts

@@ -223,12 +223,13 @@ export function chatWho(
 }
 
 export function chatMark(
-  a: { handle: string; room?: string },
+  a: Commands["chat:mark"]["payload"],
   o: RtClientOptions = {},
-): Promise<RtResponse<Record<string, never>>> {
+): Promise<RtResponse<Commands["chat:mark"]["data"]>> {
   const payload: Record<string, unknown> = { handle: a.handle };
   if (a.room !== undefined) payload.room = a.room;
-  return rtCommand<Record<string, never>>("chat:mark", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
+  if (a.upto !== undefined) payload.upto = a.upto;
+  return rtCommand<Commands["chat:mark"]["data"]>("chat:mark", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
 }
 
 export function chatMessages(
@@ -450,7 +451,7 @@ export function gateOpen(
   o: RtClientOptions = {},
 ): Promise<RtResponse<Commands["gate:open"]["data"]>> {
   const payload: Record<string, unknown> = { subject: a.subject, kind: a.kind, questions: a.questions };
-  for (const k of ["meta", "agent", "pane", "nudge"] as const) if (a[k] !== undefined) payload[k] = a[k];
+  for (const k of ["meta", "agent", "pane", "nudge", "context", "origin"] as const) if (a[k] !== undefined) payload[k] = a[k];
   return rtCommand<Commands["gate:open"]["data"]>("gate:open", payload, { sockPath: o.sockPath, timeoutMs: o.timeoutMs ?? 10_000 });
 }
 

package/src/commands.ts

@@ -95,11 +95,27 @@ export interface EventsBusEvent { id: number; topic: string; payload: unknown; e
 export const GATE_BY_PANE = "pane";
 
 export type GateStatus = "open" | "answered" | "parked" | "closed";
-export interface GateQuestion { id: string; label: string; multi: boolean; options: string[] }
+export type GateOption = string | { value: string; label: string };
+export interface GateOrigin {
+  paneId?: string;
+  tabId?: string;
+  runId?: string;
+  worktree?: string;
+  presentation?: "form" | "wait";
+}
+export interface GateQuestion { id: string; label: string; multi: boolean; options: GateOption[] }
+export function gateOptionValue(o: GateOption): string {
+  return typeof o === "string" ? o : o.value;
+}
+export function gateOptionLabel(o: GateOption): string {
+  return typeof o === "string" ? o : (o.label || o.value);
+}
 export interface GateAnswer { answers: Record<string, string | string[] | { value: string | string[]; note?: string }>; by: string; answeredAt: number }
 export interface GateRow {
   id: string; subject: string; kind: string;
   questions: GateQuestion[]; meta: Record<string, unknown> | null;
+  context?: string | null;
+  origin?: GateOrigin | null;
   status: GateStatus; answer: GateAnswer | null;
   openedAt: number; parkedAt: number | null; closedAt: number | null;
   closedReason: "abandoned" | "superseded" | "pruned" | null;
@@ -472,7 +488,7 @@ export interface Commands {
   "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[] } };
-  "chat:mark": { payload: { handle: string; room?: string }; data: Record<string, never> };
+  "chat:mark": { payload: { handle: string; room?: string; upto?: number }; data: Record<string, never> };
   "chat:messages": { payload: { room: string; before?: number; limit?: number }; data: { messages: ChatMessage[] } };
 
   // A session id keys these to one signed-in handle, not a room-membership
@@ -574,7 +590,7 @@ export interface Commands {
   "freshness:reconcile": { payload: Record<string, never>; data: unknown };
 
   // ─── Gate facility (BOARD-20/21) ─────────────────────────────────────────
-  "gate:open": { payload: { subject: string; kind: string; questions: GateQuestion[]; meta?: Record<string, unknown>; agent?: string; pane?: string; nudge?: { session: string } }; data: { id: string; supersededId: string | null } };
+  "gate:open": { payload: { subject: string; kind: string; questions: GateQuestion[]; meta?: Record<string, unknown>; agent?: string; pane?: string; nudge?: { session: string }; context?: string; origin?: GateOrigin }; data: { id: string; supersededId: string | null } };
   /**
    * A CAS loss is a DEFINED OUTCOME, not an error: `ok:true` with
    * `conflict:true` and the WINNING row, so every consumer gets the winner

package/src/index.ts

@@ -56,7 +56,7 @@ export {
   gateSubscriptions,
 } from "./client.ts";
 
-export { COMMAND_NAMES, GATE_BY_PANE } from "./commands.ts";
+export { COMMAND_NAMES, GATE_BY_PANE, gateOptionValue, gateOptionLabel } from "./commands.ts";
 export type {
   Discussion,
   DemandDecl,
@@ -94,6 +94,8 @@ export type {
   PaneSendResult,
   PaneFocusResult,
   GateStatus,
+  GateOption,
+  GateOrigin,
   GateQuestion,
   GateAnswer,
   GateRow,

package/src/settings/registry-defs.ts

@@ -473,6 +473,14 @@ export const REGISTRY: readonly SettingDef[] = [
     merge: "deep",
     description: "This developer's triage user-intent flags (which triage sweeps run automatically); a sibling flat key of board.triage.doctorSkill, not its container — the board reader assembles the two independently.",
   },
+  {
+    key: "board.reReview",
+    type: "object",
+    scopes: ["user", "team"],
+    merge: "deep",
+    default: { enabled: true },
+    description: "Gate for the board's automatic re-review sweep ({enabled}); rt's cron.triage step installs the board-triage trigger only while this is on. A fresh key, not an ownership-latch port, so a default is fine here.",
+  },
 
   // --- board (machine) ---------------------------------------------------
   {