@mattstack/rt-client 0.28.0 → 0.29.0

package/dist/commands.d.ts

@@ -27,6 +27,17 @@ export interface ProjectMRsScope {
         daemon or before the first sweep that demanded a section. */
     knownSections?: string[];
 }
+/** Classified cause of a repo's failing project sync (lib/daemon/project-sync-health.ts). */
+export type ProjectSyncErrorKind = "rate-limited" | "auth" | "server-error" | "timeout" | "other";
+/** A repo's current unbroken run of failed project syncs. */
+export interface ProjectSyncError {
+    /** First failure of the run; later failures leave it alone. */
+    since: number;
+    lastAt: number;
+    kind: ProjectSyncErrorKind;
+    /** Raw error text, capped at 200 chars. */
+    message: string;
+}
 export interface ProjectMRsData {
     mrs: Record<string, {
         pr: PullRequest;
@@ -37,6 +48,8 @@ export interface ProjectMRsData {
     source: "poll" | "events" | "mutation";
     syncedAt: number;
     scope?: ProjectMRsScope;
+    /** Present while this repo's most recent project sync failed. */
+    syncError?: ProjectSyncError;
 }
 export interface DiscussionsData {
     discussions: Discussion[];
@@ -691,10 +704,14 @@ export interface WorktreeProvisionData {
     branchState: "new" | "tracking-remote" | "existing-clean" | "diverged" | "behind";
     readyFailed?: true;
     failedStep?: string;
+    /** Set only when the tree was built by hydrating from the repo's golden donor, not the on-deck pool or a cold create. */
+    hydratedFrom?: string;
 }
 export interface WorktreeCreateData {
     tree: string;
     path: string;
+    /** Set only for `--on-deck`, and only when that tree hydrated from the golden rather than cold-creating. */
+    hydratedFrom?: string;
 }
 export interface WorktreeDisposeData {
     disposed: string[];
@@ -787,6 +804,28 @@ export interface DiscussionsDiffsData {
     truncated: boolean;
 }
 export type MRActionName = "merge" | "rebase" | "approve" | "unapprove" | "setAutoMerge" | "cancelAutoMerge" | "retryJob" | "retryPipeline" | "toggleDraft" | "requestReReview";
+/** One worktree's git badge as the daemon sweep computed it. All timestamps ISO 8601. */
+export interface GitWorktreeBadge {
+    worktree: string;
+    branch: string | null;
+    detached: boolean;
+    staged: number;
+    unstaged: number;
+    untracked: number;
+    conflicted: number;
+    clean: boolean;
+    ahead: number | null;
+    behind: number | null;
+    upstream: string | null;
+    lastFetchedAt: string | null;
+    updatedAt: string;
+}
+/** repo is the serialized identity (the repo-index key). error is set when the last sweep could not read the repo; stale worktrees may accompany it. */
+export interface RepoStatusRow {
+    repo: string;
+    worktrees: GitWorktreeBadge[];
+    error: string | null;
+}
 export interface Commands {
     "project-mrs:read": {
         payload: {
@@ -1456,6 +1495,15 @@ export interface Commands {
         };
         data: unknown;
     };
+    "repos:status": {
+        payload: {
+            refresh?: boolean;
+        };
+        data: {
+            repos: RepoStatusRow[];
+            sweptAt: string | null;
+        };
+    };
     "freshness:reconcile": {
         payload: Record<string, never>;
         data: unknown;
@@ -1524,13 +1572,23 @@ export interface Commands {
         /** `contextOmitted` appears only when the gate context plus every
             question's `context` exceeded their shared 8192-byte budget: the
             gate still opened, but question contexts were dropped, and the gate
-            context too when it was over the budget on its own. */
+            context too when it was over the budget on its own.
+            `formCapExceeded`/`formCapAdvisory` appear only when the pane could
+            have presented an in-pane form and one or more questions exceeded
+            its 4-option cap, which is the one thing that forced this gate to
+            `wait`: the gate still opens, and the advisory names the structural
+            fix so the caller can re-author. */
         data: {
             id: string;
             presentation: "form" | "wait";
             subject: string;
             supersededId: string | null;
             contextOmitted?: true;
+            formCapExceeded?: Array<{
+                question: string;
+                options: number;
+            }>;
+            formCapAdvisory?: string;
         };
     };
     /**

package/dist/gate.js

@@ -99,12 +99,12 @@ function gatePresentation(args) {
   return args.questions.every((q) => q.options.length <= GATE_FORM_OPTION_CAP) ? "form" : "wait";
 }
 export {
-  validateGateAnswers,
-  unwrapGateAnswerValue,
-  normalizeGateQuestions,
-  normalizeGateOptions,
-  gatePresentation,
-  gateOptionValue,
+  GATE_FORM_OPTION_CAP,
   gateOptionLabel,
-  GATE_FORM_OPTION_CAP
+  gateOptionValue,
+  gatePresentation,
+  normalizeGateOptions,
+  normalizeGateQuestions,
+  unwrapGateAnswerValue,
+  validateGateAnswers
 };

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export { normalizeGateOptions, normalizeGateQuestions } from "./gate-options.ts"
 export type { GateOptionObject } from "./gate-options.ts";
 export { unwrapGateAnswerValue, validateGateAnswers } from "./gate-answers.ts";
 export type { GateAnswerWire } from "./gate-answers.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, ExecutorState, ExecutorView, ReconcilerStatus, ChatPane, PaneAccount, PaneDirectory, InviteResult, PaneDelivery, PaneSendResult, PaneFocusResult, GateStatus, GateOption, GateOrigin, GateQuestion, GateAnswer, GateRow, GateSubscription, HerdInfo, HerdListRow, HerdJobInfo, HerdStatusData, } from "./commands.ts";
+export type { Discussion, DemandDecl, ProjectMRsScope, ProjectSyncError, ProjectSyncErrorKind, 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, ExecutorState, ExecutorView, ReconcilerStatus, ChatPane, PaneAccount, PaneDirectory, InviteResult, PaneDelivery, PaneSendResult, PaneFocusResult, GateStatus, GateOption, GateOrigin, GateQuestion, GateAnswer, GateRow, GateSubscription, HerdInfo, HerdListRow, HerdJobInfo, HerdStatusData, } 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

@@ -582,6 +582,7 @@ var COMMAND_NAMES = [
   "endpoint:release",
   "endpoint:status",
   "repos:locate",
+  "repos:status",
   "freshness:reconcile",
   "reconciler:status",
   "reconciler:clear",
@@ -1120,6 +1121,16 @@ var REGISTRY = [
     migrated: true,
     description: "Age floor in days for the log janitor pruning every surface's rotated log files under ~/.mattstack/rt/logs (default 14). A fresh key, not an ownership-latch port, so a default is fine here."
   },
+  {
+    key: "rt.gitStatus",
+    type: "object",
+    scopes: ALL_SCOPES,
+    default: { sweep: true, sweepIntervalSec: 300, fetchIntervalSec: 900 },
+    merge: "deep",
+    repoScoped: true,
+    migrated: true,
+    description: "Mission-control git badge sweep. sweep gates the daemon sweep and fetchIntervalSec (the background fetch cadence, 0 disables fetching) are both read per repo, so a per-repo override of either takes effect (a repo override of { sweep: false } opts that repo out). sweepIntervalSec, the minimum seconds between sweeps, is read only from the global config by the sweep tick; a per-repo override of sweepIntervalSec has no effect."
+  },
   {
     key: "rt.logLevel",
     type: "string",
@@ -1682,6 +1693,14 @@ var REGISTRY = [
     default: false,
     merge: "replace",
     description: "Whether the watchdog may drive a mid-run folder-trust dialog on a daemon-provisioned tree itself, rather than only parking the job and notifying (RT-196). Off by default: the screen match cannot yet confirm the dialog's folder matches the job's worktree, so a working session showing an unrelated permission prompt with the same shape is a real risk."
+  },
+  {
+    key: "panes.relocationAutoAccept",
+    type: "boolean",
+    scopes: ["machine"],
+    default: true,
+    merge: "replace",
+    description: "Whether the daemon may answer Claude Code's EnterWorktree permission-root relocation prompt on a blocked pane by itself (RT-200). Unlike the trust dialog, the prompt names the worktree path in its own body, and the daemon accepts only when that exact path is in rt's worktree registry, so this is on by default. Read by both the herd watchdog and the executor reconciler."
   }
 ];
 
@@ -1856,11 +1875,11 @@ function expandString(input, ctx) {
     return match;
   });
 }
-function teamPath(teamsDir2, name) {
+function teamPath(teamsDir, name) {
   if (name.includes("/") || name.includes("\\") || name.includes("..")) {
     throw new Error(`rt: cannot expand \${team:${name}} — a team name must be a single directory segment (no "/", "\\" or "..")`);
   }
-  return join6(teamsDir2, name);
+  return join6(teamsDir, name);
 }
 function required(value, name, needs) {
   if (value === undefined || value === "") {
@@ -2525,122 +2544,122 @@ async function resolveNameToIdentity(name, reposJsonPath) {
   }
 }
 export {
-  validateValue,
-  validateGateAnswers,
-  unwrapGateAnswerValue,
-  unsetSetting,
-  subscribe,
-  setSettingsWarnSink,
-  setSetting,
-  serializeIdentity,
-  rtCommand,
-  resolveNameToIdentity,
-  resolveForgeToken,
-  repoNameForPath,
-  reconcilerStatus,
-  reconcilerClear,
-  readStore,
-  readProjectMRs,
-  readMrsByBranch,
-  readDiscussions,
-  readBranchCache,
-  parsePaneRef,
-  parseIdentity,
-  paneSpawn,
-  paneSend,
-  panePeek,
-  paneList,
-  paneFocus,
-  paneDirectories,
-  paneAccounts,
-  openSmartPane,
-  normalizeRemote,
-  normalizeGateQuestions,
-  normalizeGateOptions,
-  listTeams,
-  listSettings,
-  listRuns,
-  isMigrated,
-  identityFromRemote,
-  herdWrapUp,
-  herdStopHidden,
-  herdStatus,
-  herdStart,
-  herdSpawn,
-  herdResume,
-  herdReport,
-  herdMilestone,
-  herdList,
-  herdGates,
-  herdClose,
-  herdAttend,
-  herdAsk,
-  herdAnswer,
-  guardTestDaemonEnv,
-  getSetting,
-  getRun,
-  getDef,
-  gateWait,
-  gateUnsubscribe,
-  gateSubscriptions,
-  gateSubscribe,
-  gatePresentation,
-  gatePark,
-  gateOptionValue,
-  gateOptionLabel,
-  gateOpen,
-  gateList,
-  gateClose,
-  gateAsk,
-  gateAnswer,
-  formatPaneRef,
-  explainSetting,
-  expandVariables,
-  eventsWait,
-  eventsList,
-  eventsHead,
-  eventsEmit,
-  deriveRepoIdentity,
-  decidePlacement,
-  daemonHealth,
-  createRelay,
-  clearIdentityMemo,
-  chatWho,
-  chatSignOut,
-  chatSignIn,
-  chatRooms,
-  chatRelease,
-  chatRead,
-  chatPost,
-  chatMessages,
-  chatMark,
-  chatLeave,
-  chatJoin,
-  chatInvite,
-  chatDmOpen,
-  chatDm,
-  chatClaim,
-  chatBuddies,
-  chatBack,
-  chatAway,
-  chatArchive,
-  chatAck,
-  bgStop,
-  bgStatus,
-  bgRelease,
-  bgEnsure,
-  allDefs,
-  agentStart,
-  agentResume,
-  agentList,
-  agentGet,
-  abandonRun,
-  SCOPE_ORDER,
-  REGISTRY,
-  GATE_FORM_OPTION_CAP,
-  GATE_BY_PANE,
-  DEFAULT_WS_URL,
-  DEFAULT_SOCK,
+  BG_PREFIX,
   COMMAND_NAMES,
-  BG_PREFIX
+  DEFAULT_SOCK,
+  DEFAULT_WS_URL,
+  GATE_BY_PANE,
+  GATE_FORM_OPTION_CAP,
+  REGISTRY,
+  SCOPE_ORDER,
+  abandonRun,
+  agentGet,
+  agentList,
+  agentResume,
+  agentStart,
+  allDefs,
+  bgEnsure,
+  bgRelease,
+  bgStatus,
+  bgStop,
+  chatAck,
+  chatArchive,
+  chatAway,
+  chatBack,
+  chatBuddies,
+  chatClaim,
+  chatDm,
+  chatDmOpen,
+  chatInvite,
+  chatJoin,
+  chatLeave,
+  chatMark,
+  chatMessages,
+  chatPost,
+  chatRead,
+  chatRelease,
+  chatRooms,
+  chatSignIn,
+  chatSignOut,
+  chatWho,
+  clearIdentityMemo,
+  createRelay,
+  daemonHealth,
+  decidePlacement,
+  deriveRepoIdentity,
+  eventsEmit,
+  eventsHead,
+  eventsList,
+  eventsWait,
+  expandVariables,
+  explainSetting,
+  formatPaneRef,
+  gateAnswer,
+  gateAsk,
+  gateClose,
+  gateList,
+  gateOpen,
+  gateOptionLabel,
+  gateOptionValue,
+  gatePark,
+  gatePresentation,
+  gateSubscribe,
+  gateSubscriptions,
+  gateUnsubscribe,
+  gateWait,
+  getDef,
+  getRun,
+  getSetting,
+  guardTestDaemonEnv,
+  herdAnswer,
+  herdAsk,
+  herdAttend,
+  herdClose,
+  herdGates,
+  herdList,
+  herdMilestone,
+  herdReport,
+  herdResume,
+  herdSpawn,
+  herdStart,
+  herdStatus,
+  herdStopHidden,
+  herdWrapUp,
+  identityFromRemote,
+  isMigrated,
+  listRuns,
+  listSettings,
+  listTeams,
+  normalizeGateOptions,
+  normalizeGateQuestions,
+  normalizeRemote,
+  openSmartPane,
+  paneAccounts,
+  paneDirectories,
+  paneFocus,
+  paneList,
+  panePeek,
+  paneSend,
+  paneSpawn,
+  parseIdentity,
+  parsePaneRef,
+  readBranchCache,
+  readDiscussions,
+  readMrsByBranch,
+  readProjectMRs,
+  readStore,
+  reconcilerClear,
+  reconcilerStatus,
+  repoNameForPath,
+  resolveForgeToken,
+  resolveNameToIdentity,
+  rtCommand,
+  serializeIdentity,
+  setSetting,
+  setSettingsWarnSink,
+  subscribe,
+  unsetSetting,
+  unwrapGateAnswerValue,
+  validateGateAnswers,
+  validateValue
 };

package/dist/settings/identity-codec.js

@@ -47,7 +47,7 @@ function normalizeRemote(remote) {
   return `${host.toLowerCase()}/${normalizedPath}`;
 }
 export {
-  serializeIdentity,
+  normalizeRemote,
   parseIdentity,
-  normalizeRemote
+  serializeIdentity
 };

package/package.json

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

package/src/commands.ts

@@ -31,12 +31,27 @@ export interface ProjectMRsScope {
   knownSections?: string[];
 }
 
+/** Classified cause of a repo's failing project sync (lib/daemon/project-sync-health.ts). */
+export type ProjectSyncErrorKind = "rate-limited" | "auth" | "server-error" | "timeout" | "other";
+
+/** A repo's current unbroken run of failed project syncs. */
+export interface ProjectSyncError {
+  /** First failure of the run; later failures leave it alone. */
+  since: number;
+  lastAt: number;
+  kind: ProjectSyncErrorKind;
+  /** Raw error text, capped at 200 chars. */
+  message: string;
+}
+
 export interface ProjectMRsData {
   mrs: Record<string, { pr: PullRequest; fetchedAt: number; codeownerSections?: string[] }>;
   listSyncedAt: number;
   source: "poll" | "events" | "mutation";
   syncedAt: number;
   scope?: ProjectMRsScope;
+  /** Present while this repo's most recent project sync failed. */
+  syncError?: ProjectSyncError;
 }
 
 export interface DiscussionsData {
@@ -464,8 +479,14 @@ export interface WorktreeProvisionData {
   tree: string; path: string; branch: string; wasOnDeck: boolean;
   readyAt: string | null; branchState: "new" | "tracking-remote" | "existing-clean" | "diverged" | "behind";
   readyFailed?: true; failedStep?: string;
+  /** Set only when the tree was built by hydrating from the repo's golden donor, not the on-deck pool or a cold create. */
+  hydratedFrom?: string;
+}
+export interface WorktreeCreateData {
+  tree: string; path: string;
+  /** Set only for `--on-deck`, and only when that tree hydrated from the golden rather than cold-creating. */
+  hydratedFrom?: string;
 }
-export interface WorktreeCreateData { tree: string; path: string }
 export interface WorktreeDisposeData {
   disposed: string[];
   /** `detail` is set only for a refusal whose bare `reason` code can't name
@@ -505,6 +526,30 @@ export type MRActionName =
   | "retryJob" | "retryPipeline"
   | "toggleDraft" | "requestReReview";
 
+/** One worktree's git badge as the daemon sweep computed it. All timestamps ISO 8601. */
+export interface GitWorktreeBadge {
+  worktree: string;
+  branch: string | null;
+  detached: boolean;
+  staged: number;
+  unstaged: number;
+  untracked: number;
+  conflicted: number;
+  clean: boolean;
+  ahead: number | null;
+  behind: number | null;
+  upstream: string | null;
+  lastFetchedAt: string | null;
+  updatedAt: string;
+}
+
+/** repo is the serialized identity (the repo-index key). error is set when the last sweep could not read the repo; stale worktrees may accompany it. */
+export interface RepoStatusRow {
+  repo: string;
+  worktrees: GitWorktreeBadge[];
+  error: string | null;
+}
+
 export interface Commands {
   "project-mrs:read": { payload: { repoName: string; maxAgeMs?: number; demand?: DemandDecl }; data: ProjectMRsData };
   "discussions:read": { payload: { repoName: string; iid: number }; data: DiscussionsData };
@@ -684,6 +729,7 @@ export interface Commands {
   "endpoint:status": { payload: { repo?: string }; data: EndpointStatusData };
 
   "repos:locate": { payload: { newPath: string; repo?: string; dryRun?: boolean }; data: unknown };
+  "repos:status": { payload: { refresh?: boolean }; data: { repos: RepoStatusRow[]; sweptAt: string | null } };
   "freshness:reconcile": { payload: Record<string, never>; data: unknown };
 
   // ─── Reconciler (executor state; lib/daemon/reconciler.ts) ───────────────
@@ -721,8 +767,17 @@ export interface Commands {
     /** `contextOmitted` appears only when the gate context plus every
         question's `context` exceeded their shared 8192-byte budget: the
         gate still opened, but question contexts were dropped, and the gate
-        context too when it was over the budget on its own. */
-    data: { id: string; presentation: "form" | "wait"; subject: string; supersededId: string | null; contextOmitted?: true };
+        context too when it was over the budget on its own.
+        `formCapExceeded`/`formCapAdvisory` appear only when the pane could
+        have presented an in-pane form and one or more questions exceeded
+        its 4-option cap, which is the one thing that forced this gate to
+        `wait`: the gate still opens, and the advisory names the structural
+        fix so the caller can re-author. */
+    data: {
+      id: string; presentation: "form" | "wait"; subject: string; supersededId: string | null; contextOmitted?: true;
+      formCapExceeded?: Array<{ question: string; options: number }>;
+      formCapAdvisory?: string;
+    };
   };
   /**
    * A CAS loss is a DEFINED OUTCOME, not an error: `ok:true` with
@@ -875,6 +930,7 @@ export const COMMAND_NAMES: readonly CommandName[] = [
   "endpoint:release",
   "endpoint:status",
   "repos:locate",
+  "repos:status",
   "freshness:reconcile",
   "reconciler:status",
   "reconciler:clear",

package/src/index.ts

@@ -88,6 +88,8 @@ export type {
   Discussion,
   DemandDecl,
   ProjectMRsScope,
+  ProjectSyncError,
+  ProjectSyncErrorKind,
   ProjectMRsData,
   DiscussionsData,
   MrByBranchEntry,

package/src/settings/registry-defs.ts

@@ -222,6 +222,16 @@ export const REGISTRY: readonly SettingDef[] = [
     migrated: true,
     description: "Age floor in days for the log janitor pruning every surface's rotated log files under ~/.mattstack/rt/logs (default 14). A fresh key, not an ownership-latch port, so a default is fine here.",
   },
+  {
+    key: "rt.gitStatus",
+    type: "object",
+    scopes: ALL_SCOPES,
+    default: { sweep: true, sweepIntervalSec: 300, fetchIntervalSec: 900 },
+    merge: "deep",
+    repoScoped: true,
+    migrated: true,
+    description: "Mission-control git badge sweep. sweep gates the daemon sweep and fetchIntervalSec (the background fetch cadence, 0 disables fetching) are both read per repo, so a per-repo override of either takes effect (a repo override of { sweep: false } opts that repo out). sweepIntervalSec, the minimum seconds between sweeps, is read only from the global config by the sweep tick; a per-repo override of sweepIntervalSec has no effect.",
+  },
   {
     key: "rt.logLevel",
     type: "string",
@@ -825,4 +835,12 @@ export const REGISTRY: readonly SettingDef[] = [
     merge: "replace",
     description: "Whether the watchdog may drive a mid-run folder-trust dialog on a daemon-provisioned tree itself, rather than only parking the job and notifying (RT-196). Off by default: the screen match cannot yet confirm the dialog's folder matches the job's worktree, so a working session showing an unrelated permission prompt with the same shape is a real risk.",
   },
+  {
+    key: "panes.relocationAutoAccept",
+    type: "boolean",
+    scopes: ["machine"],
+    default: true,
+    merge: "replace",
+    description: "Whether the daemon may answer Claude Code's EnterWorktree permission-root relocation prompt on a blocked pane by itself (RT-200). Unlike the trust dialog, the prompt names the worktree path in its own body, and the daemon accepts only when that exact path is in rt's worktree registry, so this is on by default. Read by both the herd watchdog and the executor reconciler.",
+  },
 ];