@try-works/dsh-recursive-mode 0.1.7 → 0.1.8

package/lib/client/slots.d.ts

@@ -1,3 +1,22 @@
+/**
+ * Slot registrations (SP2 R1 + run 08 R1/R3/R4): the sidebar launcher, the
+ * shell.overlay board, the conversation.input.dock status strip, and the
+ * settings.section page.
+ *
+ * Run 08: the launcher now OPENS the shared board store (onClick), and the
+ * shell.overlay entry renders the board gated on that store + the recursive
+ * preset, swapping to the drill-down inspector when a run is selected.
+ *
+ * Run 10 (LIVE BUG FIX): useSessions is a SnapshotSelectorHook (NOT a zero-arg
+ * thunk) — it is called WITH a selector, e.g. useSessions((s) => s) for the
+ * full SessionListStateLike. The old code called useSessions() with NO selector
+ * and wrapped the garbage in a fake {list:{getSnapshot}} — so the preset gate
+ * never saw the recursive preset and the board never mounted (launcher click
+ * did nothing). The board/strip now consume the SessionListStateLike directly.
+ *
+ * READ-ONLY (R9): the client only GETs the live host route; no mutation.
+ */
+import { type ReactNode } from 'react';
 import type { ClientContext, SessionListStateLike, SnapshotSelectorHook } from './contract.ts';
 import { isRecursivePreset, currentSessionCwd } from './contract.ts';
 export type OverlayContent = 'hidden' | 'board' | 'inspector';
@@ -12,6 +31,16 @@ export declare function overlayContent(state: {
  * Exported so the spec can assert the selector is actually passed.
  */
 export declare function useRecursiveSessions(useSessions: SnapshotSelectorHook<SessionListStateLike>): SessionListStateLike;
+/**
+ * Run 11 (UX gate): the ⧉ launcher renders ONLY in recursive sessions. The seat
+ * is root-scoped (the icon shows in every session otherwise), while the board it
+ * opens is recursive-preset-gated — in a code/other session the click was a dead
+ * no-op. Gating the launcher itself removes the trap: the icon appears exactly
+ * where clicking it opens the board.
+ */
+export declare function RecursiveLauncherGate({ useSessions }: {
+    useSessions: SnapshotSelectorHook<SessionListStateLike>;
+}): ReactNode;
 export declare function registerSlots(ctx: ClientContext): () => void;
 /** Export the gate helpers for tests. */
 export { isRecursivePreset, currentSessionCwd };

package/lib/client.js

@@ -528,6 +528,21 @@ window.__ModuleLoader__.load({
 		function useRecursiveSessions(useSessions) {
 			return useSessions((s) => s);
 		}
+		/**
+		* Run 11 (UX gate): the ⧉ launcher renders ONLY in recursive sessions. The seat
+		* is root-scoped (the icon shows in every session otherwise), while the board it
+		* opens is recursive-preset-gated — in a code/other session the click was a dead
+		* no-op. Gating the launcher itself removes the trap: the icon appears exactly
+		* where clicking it opens the board.
+		*/
+		function RecursiveLauncherGate({ useSessions }) {
+			if (!isRecursivePreset(useRecursiveSessions(useSessions))) return null;
+			return (0, react.createElement)("button", {
+				className: "rec-launcher",
+				title: "Recursive runs",
+				onClick: () => boardState.openBoard()
+			}, "⧉");
+		}
 		function registerSlots(ctx) {
 			const disposers = [];
 			disposers.push(ctx.slots.inject("sidebar.footer.action", () => ctx.slots.register({
@@ -535,11 +550,11 @@ window.__ModuleLoader__.load({
 				id: "recursive",
 				order: 50,
 				label: "Recursive runs"
-			}, () => (0, react.createElement)("button", {
-				className: "rec-launcher",
-				title: "Recursive runs",
-				onClick: () => boardState.openBoard()
-			}, "⧉"))));
+			}, (props) => {
+				const useSessions = props?.useSessions;
+				if (useSessions === void 0) return null;
+				return (0, react.createElement)(RecursiveLauncherGate, { useSessions });
+			})));
 			disposers.push(ctx.slots.inject("shell.overlay", () => ctx.slots.register({
 				name: "shell.overlay",
 				id: "recursive-board",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@try-works/dsh-recursive-mode",
   "description": "recursive-mode workflow as a DeepSeek Harness bundle: RecursiveRuntime service + recursive_status tool",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/src/client/slots.ts

@@ -58,16 +58,36 @@ export function useRecursiveSessions(useSessions: SnapshotSelectorHook<SessionLi
   return useSessions((s) => s)
 }
 
+/**
+ * Run 11 (UX gate): the ⧉ launcher renders ONLY in recursive sessions. The seat
+ * is root-scoped (the icon shows in every session otherwise), while the board it
+ * opens is recursive-preset-gated — in a code/other session the click was a dead
+ * no-op. Gating the launcher itself removes the trap: the icon appears exactly
+ * where clicking it opens the board.
+ */
+export function RecursiveLauncherGate({ useSessions }: { useSessions: SnapshotSelectorHook<SessionListStateLike> }): ReactNode {
+  const list = useRecursiveSessions(useSessions)
+  if (!isRecursivePreset(list)) return null
+  return createElement('button', { className: 'rec-launcher', title: 'Recursive runs', onClick: () => boardState.openBoard() }, '⧉')
+}
+
 export function registerSlots(ctx: ClientContext): () => void {
   const disposers: (() => void)[] = []
 
   // Board launcher in the sidebar footer action list — OPENS the shared board store (run 08 R1).
+  // Run 11 (UX gate): the seat is root-scoped (visible in every session), but the board it
+  // opens is recursive-preset-gated. In a code/other session the icon was a dead click — a
+  // trap. The launcher itself now renders ONLY in recursive sessions, where it works.
   disposers.push(ctx.slots.inject('sidebar.footer.action', () => ctx.slots.register({
     name: 'sidebar.footer.action',
     id: 'recursive',
     order: 50,
     label: 'Recursive runs',
-  }, () => createElement('button', { className: 'rec-launcher', title: 'Recursive runs', onClick: () => boardState.openBoard() }, '⧉'))))
+  }, (props: RootSlotProps) => {
+    const useSessions = props?.useSessions
+    if (useSessions === undefined) return null
+    return createElement(RecursiveLauncherGate, { useSessions })
+  })))
 
   // Board panel overlay (root scope, cross-session read) — gated on the recursive preset + shared store.
   disposers.push(ctx.slots.inject('shell.overlay', () => ctx.slots.register({