@treeseed/dsh-chapters 0.1.13 → 0.1.15

package/docs/backlog.md

@@ -0,0 +1,97 @@
+# Open items — 2026-10-11
+
+Handoff for a fresh session. Everything below is *scoped and reachable*; none of it is a unknown
+defect. Shipped state: **0.1.13** (tag = npm `latest` = the user's installed profile), hosted CI green
+(deterministic gate + eight-project tape chain), and the untagged commit after it (`5bdc11b`) changes
+only the e2e stub and this record.
+
+Order matters: 1 and 2 are the ones that change what we are allowed to *claim*.
+
+## 1. Live-model proof of the plans journey
+
+**What is missing.** Every acceptance claim for plan carriage runs off a tape distilled from the
+scripted upstream (`tests/e2e/stub-model.ts`), because this box's model server was in a CUDA-OOM
+restart loop. The behaviour at our seam is proven; "a real model plans, a human approves, the
+continuation carries it" is not.
+
+**What attempt 5 already bought** (see `tests/fixtures/model-tape/plans/PROVENANCE.md`): a real
+`exit_plan_mode` submission, the host review answered by a real click, `plan/mode` flipping
+active→inactive on approval, the archived chapter carrying the plan, and the **branch** child receiving
+zero directive bytes — all with a live model. What it did *not* buy: the continuation leg, because the
+model called `chapters_segment` and then answered in prose.
+
+**How to close it.** The container is now `RestartCount=0` with `N_PARALLEL` removed.
+
+1. Prove a **completion**, not a health check: `curl` a real ~14K-token chat request and confirm it
+   finishes. `/v1/models` answering proves nothing (measured repeatedly).
+2. Run the journey live: `E2E_MODEL=live E2E_PORT=41850 E2E_THRESHOLD=0.99 E2E_NO_AUX_MODEL=1
+   npx playwright test -c tests/e2e/playwright.config.ts --project=plans`
+3. Expect cost: ~15 tok/s decode means several minutes per turn, and with one slot this session's own
+   turns queue behind it. Do it when the box is otherwise free.
+4. Record the outcome in `PROVENANCE.md` either way — including a failure and its cause. Do **not**
+   promote the scripted tape's status based on a live run that only half-completed.
+
+**Honest limit.** A live journey is inherently non-deterministic (attempt 5 proved the model may chain
+two calls or may not). It is evidence, never a CI gate. Do not try to make it one.
+
+## 2. The seeded-gate row in a browser
+
+**What is missing.** The seeded `plan/mode` into a continuation child (§ 10 of
+`docs/plans-carriage.md`) is proven by a kernel probe and by deterministic rows, but never *observed*
+in a real session.
+
+**Already done, and it is the hard part:** the session shape was reached live-in-the-harness and
+recorded — `plan/mode {active:true}` at seq 4, `turn/end` at 21, **no** tool call. So a session can be
+in plan mode with a completed turn, which gives the deterministic door a real ceiling to archive
+against. The attempt was reverted unshipped for two harness reasons, both now fixed on `main`:
+
+- the stub had to learn to answer **plainly** in plan mode (`kind: 'plain'`), and its "is the human
+  asking for a plan?" test first read the **last** user message — but the harness appends its own
+  injected user messages (workspace instructions, runtime snapshot, skill catalog) *after* the human's,
+  so the ask was invisible and the next step hung 15 minutes on a review card that could not appear.
+  Now it scans every user-role message, the trigger is a whole sentence so the plan-mode *policy* text
+  cannot set it off, and both properties are pinned by rows in `tests/unit/stub-model.test.ts`.
+- a **stale stub process** was serving pre-edit logic, which made a harness bug look like a product
+  one. Restart the upstream before trusting any distillation.
+
+**Remaining work.** Re-add the leg (draft is in this file's history of the repo: new session → `/plan`
+with a plain ask → wait for `plan/mode` + `turn/end` → `/chapters-continue` → poll `ch-` children for a
+`plan/mode` event at seq 1 with `active:true`, assert exactly one `dsh-chapters` user/message, and
+assert the notice carries **no** plan section since no plan was submitted). Then re-distill the plans
+tape with a **fresh** stub and replay it. Roughly 15–20 minutes.
+
+## 3. Per-message anchoring (needs a product decision, not just code)
+
+`deriveRanges` already accepts any anchor, and the fork/continue doors archive from the watermark. What
+does not exist is a way for a human to say *"branch from this message"*, because the button acts at
+conversation end. Two open questions before code:
+
+- where the affordance lives (message action row vs selection in the composer), and
+- **how the child is told what it did not inherit** — an anchored branch silently drops the tail, which
+  is exactly the kind of unstated loss this project refuses. It needs a line in the notice.
+
+Scope it as its own plan; do not fold it into a release.
+
+## 4. Default-preset shipping policy (the user's call)
+
+Today `chapters` is opt-in: the profile must name it, and the README/site tell users how. The
+alternative — make it the default agent preset — changes every new session's header. That is a
+distribution decision with a cache consequence (a recomposed header is measured at ~12K tokens on a
+32K model) and it belongs to the human, not to an agent. Ask before touching it.
+
+## 5. Human-judgment verification rows
+
+Still open and still human-only: readability of a real checkpoint in a real browser, and whether the
+notice/preamble *feels* right to work in. These are not automatable and should not be faked with
+assertions. `docs/verify.md` lists them; run them after installing, in the project you actually care
+about.
+
+## Also worth knowing
+
+- **Durability caveat for a new project:** with no pool linked, the archive lives only in the
+  workspace. `/chapters-link <path-or-url>` is the difference between "this machine remembers" and
+  "the project remembers".
+- **Search now answers unlinked** (0.1.12) and says which door it used. If a result ever looks
+  machine-only when you expected the pool, that note is the first thing to read.
+- **`/chapters-continue` vs `/chapters-fork`** is the intent line: continue carries the operative plan
+  and may seed plan mode; fork carries nothing.

package/docs/development.md

@@ -362,7 +362,7 @@ happened in these notes before it was caught.
 | `scripts/dsh-scratch.sh` | **done** — refuses any DSH_HOME under the live `~/.dsh`; the near-miss is in FINDINGS |
 | `chapters_segment` / `chapters_continue` / `chapters_fork` tools (`src/tools.ts` → `continue-core.ts`) | **done & boot-proven** (r22 9/9 full loop incl. child read-back; r24 fork siblings reserve nothing; r25 durable title; r26/26b checklist pass) |
 | E3: header cache across a compaction | **measured, per-machine (r23 cloud, r28 local)**: cloud held 7,424 cached across the replacement (refill 13,658 → ~7,000); local llama.cpp reuses NOTHING across a head replacement (0 cached) but steady-state turns cost only the new content. Never quote one machine's number for the other |
-| Fork button | **shipped** (client bundle + slots; `remote.commands` trigger — `connection.rpc.handle` from a plugin is broken on this host, r26a; the button rides the command path instead) |
+| Fork + Continue buttons | **shipped** (client bundle + slots; `remote.commands` trigger — `connection.rpc.handle` from a plugin is broken on this host, r26a; the buttons ride the command path instead). Both deterministic doors are rows over ONE client runner (`src/client/doors.ts` + the `DOOR_ACTIONS` table): `/chapters-continue` shipped as a composer command only, so its child was created correctly with no visible affordance |
 | Long-context mechanics (architecture amendments) | **built + verified**: arrival-time artifacting (`src/arrival.ts`, `chapters_artifact`; e2e artifact-arrival green — 373KB book never prefilled, cache intact) and plot carriage (persona PLOT: + elicited fallback); e2e = 7 specs / 2 projects on a throwaway per-boot home (188 unit/integration) |
 | Knowledge layer P1 (record §13) | **complete**: project identity, redaction, live turn signatures, topic-sequential composition (fork proven live, r36; engine wired, r29), sharded index + incremental manifest, `chapters_search`, `/chapters-link`+`/chapters-status`+notice v2 (Project line, `(N msgs)`), the sync loop with §5.3 local-only degradation + diverged-rebuild, both schedulers and all §5.1 triggers wired. 9/9 live (r35j) + the two-machine exit criterion PROVEN as a browser journey (e2e suite green 2026-09-18) (composer→real remote→machine B searches) |
 | Topic mapping (composer) | **live-verified at the fork (r36)**: same-topic turns merge into one chapter on real signatures; topic changes split; pressure fragments stay legacy (measured, documented §4.2/4.3 + FINDINGS r28-36) — engine composition (r29) waits for deep selections |

package/docs/plans-carriage.md

@@ -425,7 +425,15 @@ containing a submission does not end until the review is answered. So:
   plan marked PENDING/un-stored (`continue-command.test.ts`).
 
 So the honest statement is: the seeded continuation is covered deterministically and structurally, and
-NOT yet observed in a real browser. Building that row needs new stub rules and a fresh distillation; it is
+NOT yet observed in a real browser. An attempt at that browser row on 2026-10-11 was built and then
+REVERTED, unshipped, for two reasons worth recording so the next person does not re-derive them:
+(a) the scripted upstream had to learn to answer PLAINLY in plan mode, and its decision rule first keyed
+on the LAST user message — but the harness appends its own injected user messages (instructions, runtime
+snapshot, skill catalog) AFTER the human's, so the ask was invisible and the journey hung on a review card
+that could never appear; that ordering trap is now pinned by a unit row; and (b) a stale stub process
+serving pre-edit logic made the failure look like a product problem. Neither is a product defect. The
+shape is sound — `plan/mode {active:true}` logged, turn completed at seq 21, no tool call — so a future
+leg needs the plain branch plus a fresh distillation, and nothing else. Building that row needs new stub rules and a fresh distillation; it is
 recorded as the remaining piece rather than quietly claimed.
 
 ## Deferred (human decisions, not ours)

package/docs/verify.md

@@ -152,7 +152,7 @@ renderer, the segmentation tool, and the child's notice.
 | P10 | Artifact citations resolve wherever they were written | a chapter's `artifacts/aa/<sha>.txt` reference resolves whether the blob sits at the STORE ROOT (arrival stubs) or inside the ANCESTRY TREE (`<store>/<root>/artifacts/…`, where `writeArchive` puts deferred results and every plan) — before this fix the second form was unreadable through `chapters_artifact`, which is what "every byte remains retrievable" actually promised | `artifact-query.test.ts` rows + integration `plans-carriage.test.ts` (`resolveArtifactWithMirror` over the real tree) |
 | P11 | The browser plane runs in the chain | `/plan <message>` → a real `exit_plan_mode` call → the host's review card opened and answered by a real CLICK → fork; asserts the submission's bytes are the artifact's bytes (or provably only-redacted), `planMode: inactive` from the fold, a `kind: plan` document on disk, and that the BRANCH child carries **no** `## Active plan` and no call-out while still citing the archive; plus a guard that no `compaction/*` entered the journey | `tests/e2e/plans.spec.ts` = chain project `plans` (13 s replay, no LLM; 3-entry tape). **Scope, learned at cost:** the continuation leg was REMOVED from this journey because a tape freezes the model's tool ARGUMENTS — my scripted upstream derived `chapters_continue` ranges from the ceiling the live segment tool reported while distilling (30 here), and the runner's session lands at 29, so `validateRanges` refused the stale input (correctly). A journey whose recorded request embeds a machine-specific seq cannot be hardware-neutral. Continuation semantics — `## Active plan`, `## Previous plans`, the seeded `plan/mode`, the checkpoint carry — are covered by the deterministic plane (`continue-plans`, `plans-engine`, `plan-documents`, the § 10 kernel probe) and the in-place path by the heavy/arrival/enrich/fanout journeys. Tape provenance: scripted upstream, see `tests/fixtures/model-tape/plans/PROVENANCE.md` |
 
-| P21 | The continuation has a **human-pulled door**, and the two doors cannot drift | `/chapters-continue` = `deterministicCommand({intent:'continue'})`, the same builder as `/chapters-fork`; only name/verbs/intent/no-directive prose differ; archive semantics identical (everything since the watermark) | unit `continue-command.test.ts` (7 rows) incl. the **no-drift row**: same events in ⇒ same ranges, titles and plan facts out of both doors; the no-plan case, the refusal naming its own door, and approved ⇒ NOT seeded vs still-planning ⇒ seeded `['user/message','plan/mode']` |
+| P21 | The continuation has a **human-pulled door**, and the two doors cannot drift | `/chapters-continue` = `deterministicCommand({intent:'continue'})`, the same builder as `/chapters-fork`; only name/verbs/intent/no-directive prose differ; archive semantics identical (everything since the watermark). CLIENT SIDE, same discipline: the assistant row registers both doors from ONE runner (`src/client/doors.ts` `makeDoorRunner` + a two-row `DOOR_ACTIONS` table) — a composer-only continue left the user with a created child and no affordance | unit `continue-command.test.ts` (7 rows) incl. the **no-drift row**: same events in ⇒ same ranges, titles and plan facts out of both doors; the no-plan case, the refusal naming its own door, and approved ⇒ NOT seeded vs still-planning ⇒ seeded `['user/message','plan/mode']`. Unit `client-doors.test.ts` (7 rows) pins the two client rows (distinct id/order/label/command, the fork label frozen for the specs), that ONE child-id regex parses BOTH door wordings, that both rows fire their own command through the same body, and — by reading the server's own templates — that the reply wording the client parses is still what `deterministicCommand` emits. Browser: project `fork` asserts BOTH buttons render |
 | P22 | The continuation shape is covered **in the browser**, on every push | the leg that a tape could not carry (§ 15) is back, driven by the command — no model request, no frozen `endSeq`; asserted from the child's durable log without switching the UI: `## Active plan`, the operative plan by title with its real verdict, `plan document:` and `chapters_artifact` citations, `## Finding things`, no seeded gate after approval, exactly one synthetic notice (invariant 2) | `tests/e2e/plans.spec.ts` project `plans` — replays in ~14 s with no LLM/GPU, eight-project chain green |
 | P18 | Search answers **without a pool linked** — the findability audit | `buildLocalCorpus` walks the workspace store (chapters, `kind: plan` documents, rules) and answers through the SAME scorer as the mirror door (`rankEntries`), so ranking cannot drift between doors; artifacts are deliberately not indexed (they answer to `chapters_artifact`); the answer names its door ("searched this machine's store, N docs, no pool mirror") so a session never reads *this machine only* as *the whole project*; "nothing matched" (`documents>0`) is distinguished from "nothing here" (`empty`); a pool miss falls back to the local store before answering empty | unit `local-corpus.test.ts` (5) + integration `find-without-a-pool.test.ts` through the real tool wrapper — the empty answer used to be born in the wrapper, not the pure function |
 | P19 | A child is TOLD the lookup verbs | the notice gains a three-line `## Finding things` naming `read` (chapters), `chapters_artifact` (deferred blobs, path or bare sha) and `chapters_search` (everything else), plus the one fact a model cannot infer — that plans are searchable **as plans** (`kind: plan`) and rules arrive from other machines; `retrievalHints` (default on) off ⇒ the notice is byte-identical to the previous shape | unit rows in `find-without-a-pool.test.ts` (on/off goldens); measured that NO committed tape prefix contains a seeded notice, so the change costs no re-record, and the eight-project chain replays green |

package/lib/client.js

@@ -6,39 +6,28 @@ window.__ModuleLoader__.load({
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 		let react = require("react");
 		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
-		//#region src/client/index.ts
-		/**
-		* dsh-chapters client entry: the per-message fork action.
-		*
-		* Registers one button into the assistant action row
-		* (`conversation.chat.assistant-actions` — the slot the official feedback
-		* package populates beside copy/branch). Clicking it executes `/chapters-fork`
-		* through `remote.commands` — the exact wire the composer's input line rides —
-		* then SWITCHES the app to the fresh branch:
-		*
-		*   1. `sessions.open(child)` — the client sessions service carries open() on
-		*      its prototype (Playwright-verified against this host; a keys-dump alone
-		*      hid it, which is why an earlier round wrongly gave up on this path);
-		*   2. fallback: click the branch's sidebar row after expanding collapsed
-		*      groups (plugin children can render under collapsed 'Ungrouped' heads);
-		*   3. last resort: an inline note — the branch is durable either way.
-		*
-		* There is deliberately NO second implementation of fork logic here: the
-		* button is a mouth for the host command (watermark, segmentation, budget,
-		* titles, refusal-with-numbers all server-side, all tested). The purity gate
-		* in tsdown.client.config.ts keeps this file cross-plugin-free.
-		*
-		* @module dsh-chapters/src/client
-		*/
-		const inject = [
-			"slots",
-			"remote",
-			"remote.commands",
-			"sessions"
-		];
-		/** Pull the child id and branch title out of the command's durable texts. */
+		//#region src/client/doors.ts
+		const DOOR_ACTIONS = [{
+			id: "chapters-fork",
+			order: 30,
+			label: "Fork with chapters",
+			command: "/chapters-fork",
+			noun: "branch",
+			iconPath: "M5 3.25a2.25 2.25 0 1 0-1.5 2.12v5.26a2.25 2.25 0 1 0 1.5 0V9h5a2.25 2.25 0 0 0 2.25-2.25v-1.4a2.25 2.25 0 1 0-1.5 0v1.4A.75.75 0 0 1 10 7.5H5V5.37A2.25 2.25 0 0 0 5 3.25Z"
+		}, {
+			id: "chapters-continue",
+			order: 31,
+			label: "Continue with chapters",
+			command: "/chapters-continue",
+			noun: "continuation",
+			iconPath: "M1 8a.75.75 0 0 1 0-1.5h9.44L7.72 3.28a.75.75 0 1 1 1.06-1.06l3.5 3.5.53.53-.53.53-3.5 3.5a.75.75 0 1 1-1.06-1.06L10.44 9.5H1Zm13-5.25v10.5a.75.75 0 0 1-1.5 0v-10.5a.75.75 0 0 1 1.5 0Z"
+		}];
+		/** Pull the child id out of either door's durable success text — both end in
+		* `… is session ch-…` (src/tools.ts), so this regex is door-agnostic. */
 		const CHILD_ID = /is session (ch-[\w-]+)/;
-		const BRANCH_TITLE = /branch \u201C([^\u201D]+)\u201D is session/;
+		/** The quoted title the door gave the child, matched by its OWN noun so a
+		* refusal or an unrelated quote cannot pass for it. */
+		const doorTitle = (noun) => new RegExp(`${noun} \\u201C([^\\u201D]+)\\u201D is session`);
 		function openByService(sessions, sessionId) {
 			return (async () => {
 				const svc = sessions;
@@ -58,8 +47,8 @@ window.__ModuleLoader__.load({
 		}
 		/**
 		* Fallback path: expand collapsed groups / show-more buttons, then click the
-		* newest treeitem whose label contains the branch title (newest-updated sorts
-		* first, so the first match is the fresh branch).
+		* newest treeitem whose label contains the child title (newest-updated sorts
+		* first, so the first match is the fresh child).
 		*/
 		async function openBranchRow(title, budgetMs = 4e3) {
 			if (typeof document === "undefined") return false;
@@ -88,41 +77,41 @@ window.__ModuleLoader__.load({
 			}
 			return tryClick();
 		}
-		function makeForker(remote, sessions) {
-			return async function fork(sessionId) {
+		function makeDoorRunner(remote, sessions, door) {
+			return async function run(sessionId) {
 				try {
 					if (remote.commands?.execute === void 0) return {
 						ok: false,
 						message: "commands remote unavailable"
 					};
-					const res = await remote.commands.execute(sessionId, "/chapters-fork", []);
+					const res = await remote.commands.execute(sessionId, door.command, []);
 					if (res.ok !== true) return {
 						ok: false,
-						message: (res.error?.message ?? "the fork call failed").slice(0, 90)
+						message: (res.error?.message ?? `the ${door.noun} call failed`).slice(0, 90)
 					};
 					const result = res.value?.result;
 					const text = typeof result?.text === "string" ? result.text : "";
 					if (result?.kind !== "success") return {
 						ok: false,
-						message: (text || "the fork was refused — see the command result").slice(0, 90)
+						message: (text || `the ${door.noun} was refused — see the command result`).slice(0, 90)
 					};
 					const child = CHILD_ID.exec(text)?.[1];
 					if (child === void 0) return {
 						ok: true,
-						message: "forked — the branch is appearing in the sidebar"
+						message: `${door.noun} created — appearing in the sidebar`
 					};
 					if (await openByService(sessions, child)) return {
 						ok: true,
 						message: ""
 					};
-					const title = BRANCH_TITLE.exec(text)?.[1];
+					const title = doorTitle(door.noun).exec(text)?.[1];
 					if (title !== void 0 && await openBranchRow(title)) return {
 						ok: true,
 						message: ""
 					};
 					return {
 						ok: true,
-						message: "forked — open the branch in the sidebar"
+						message: `${door.noun} created — open it in the sidebar`
 					};
 				} catch (error) {
 					return {
@@ -132,11 +121,45 @@ window.__ModuleLoader__.load({
 				}
 			};
 		}
+		//#endregion
+		//#region src/client/index.ts
+		/**
+		* dsh-chapters client entry: the per-message door buttons.
+		*
+		* Registers the two deterministic archive doors into the assistant action row
+		* (`conversation.chat.assistant-actions` — the slot the official feedback
+		* package populates beside copy/branch). Clicking one executes its host
+		* command — `/chapters-fork`, `/chapters-continue` — through `remote.commands`,
+		* the exact wire the composer's input line rides, then SWITCHES the app to the
+		* fresh child:
+		*
+		*   1. `sessions.open(child)` — the client sessions service carries open() on
+		*      its prototype (Playwright-verified against this host; a keys-dump alone
+		*      hid it, which is why an earlier round wrongly gave up on this path);
+		*   2. fallback: click the child's sidebar row after expanding collapsed
+		*      groups (plugin children can render under collapsed 'Ungrouped' heads);
+		*   3. last resort: an inline note — the child is durable either way.
+		*
+		* There is deliberately NO second implementation of door logic here: the
+		* buttons are mouths for the host commands (watermark, segmentation, budget,
+		* titles, refusal-with-numbers all server-side, all tested), and the runner
+		* they share is `src/client/doors.ts` — one body, one row per door. The purity
+		* gate in tsdown.client.config.ts keeps this file cross-plugin-free.
+		*
+		* @module dsh-chapters/src/client
+		*/
+		const inject = [
+			"slots",
+			"remote",
+			"remote.commands",
+			"sessions"
+		];
 		/**
 		* Style parity with the native IconActions row: rules copied verbatim from the
 		* host's MessageIconActions module (`._xzv4MW_action` in dsh-client-ui-chat's
 		* compiled client + the feedback package's :disabled) — same metrics, tokens,
-		* hover. Update this string if the host restyles its action row.
+		* hover. Update this string if the host restyles its action row. Both doors
+		* share these metrics.
 		*
 		* The final rule hides the native branch action IN THE MESSAGE ROW only
 		* (user-approved cosmetic decision, docs/architecture.md): built-in chrome, so
@@ -163,48 +186,51 @@ window.__ModuleLoader__.load({
 				document.head.appendChild(tag);
 			} catch {}
 		}
-		function ChaptersForkAction({ fork }) {
-			const [busy, setBusy] = (0, react.useState)(false);
-			const [note, setNote] = (0, react.useState)(null);
-			const alive = (0, react.useRef)(true);
-			(0, react.useEffect)(() => () => {
-				alive.current = false;
-			}, []);
-			const onClick = (0, react.useCallback)(() => {
-				if (busy) return;
-				setBusy(true);
-				setNote(null);
-				fork().then((result) => {
-					if (!alive.current) return;
-					setBusy(false);
-					setNote(result.message === "" ? null : result.message);
-					setTimeout(() => {
-						if (alive.current) setNote(null);
-					}, 8e3);
-				});
-			}, [busy, fork]);
-			const button = (0, react.createElement)("button", {
-				type: "button",
-				"aria-label": "Fork with chapters",
-				disabled: busy,
-				onClick,
-				className: "dsh-chapters_forkAction"
-			}, (0, react.createElement)("svg", {
-				viewBox: "0 0 16 16",
-				width: "15",
-				height: "15",
-				fill: "currentColor",
-				"aria-hidden": "true"
-			}, (0, react.createElement)("path", { d: "M5 3.25a2.25 2.25 0 1 0-1.5 2.12v5.26a2.25 2.25 0 1 0 1.5 0V9h5a2.25 2.25 0 0 0 2.25-2.25v-1.4a2.25 2.25 0 1 0-1.5 0v1.4A.75.75 0 0 1 10 7.5H5V5.37A2.25 2.25 0 0 0 5 3.25Z" })));
-			return (0, react.createElement)("span", { style: {
-				display: "inline-flex",
-				alignItems: "center",
-				gap: "4px"
-			} }, (0, react.createElement)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
-				label: "Fork with chapters",
-				side: "bottom",
-				children: button
-			}), note !== null ? (0, react.createElement)("span", { className: "dsh-chapters_forkNote" }, note) : null);
+		/** One component body for every door row; only the label and glyph differ. */
+		function makeDoorAction(door) {
+			return function ChaptersDoorAction({ run }) {
+				const [busy, setBusy] = (0, react.useState)(false);
+				const [note, setNote] = (0, react.useState)(null);
+				const alive = (0, react.useRef)(true);
+				(0, react.useEffect)(() => () => {
+					alive.current = false;
+				}, []);
+				const onClick = (0, react.useCallback)(() => {
+					if (busy) return;
+					setBusy(true);
+					setNote(null);
+					run().then((result) => {
+						if (!alive.current) return;
+						setBusy(false);
+						setNote(result.message === "" ? null : result.message);
+						setTimeout(() => {
+							if (alive.current) setNote(null);
+						}, 8e3);
+					});
+				}, [busy, run]);
+				const button = (0, react.createElement)("button", {
+					type: "button",
+					"aria-label": door.label,
+					disabled: busy,
+					onClick,
+					className: "dsh-chapters_forkAction"
+				}, (0, react.createElement)("svg", {
+					viewBox: "0 0 16 16",
+					width: "15",
+					height: "15",
+					fill: "currentColor",
+					"aria-hidden": "true"
+				}, (0, react.createElement)("path", { d: door.iconPath })));
+				return (0, react.createElement)("span", { style: {
+					display: "inline-flex",
+					alignItems: "center",
+					gap: "4px"
+				} }, (0, react.createElement)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
+					label: door.label,
+					side: "bottom",
+					children: button
+				}), note !== null ? (0, react.createElement)("span", { className: "dsh-chapters_forkNote" }, note) : null);
+			};
 		}
 		function apply(ctx) {
 			injectStyles();
@@ -216,13 +242,17 @@ window.__ModuleLoader__.load({
 			} catch {
 				sessions = void 0;
 			}
-			const fork = makeForker(remote, sessions);
-			slots.inject("conversation.chat.assistant-actions", () => slots.register({
+			const rows = DOOR_ACTIONS.map((door) => ({
+				door,
+				run: makeDoorRunner(remote, sessions, door),
+				component: makeDoorAction(door)
+			}));
+			slots.inject("conversation.chat.assistant-actions", () => rows.map(({ door, run, component }) => slots.register({
 				name: "conversation.chat.assistant-actions",
-				id: "chapters-fork",
-				order: 30,
-				inject: (sessionId) => ({ fork: () => fork(sessionId) })
-			}, ChaptersForkAction));
+				id: door.id,
+				order: door.order,
+				inject: (sessionId) => ({ run: () => run(sessionId) })
+			}, component)));
 		}
 		//#endregion
 		exports.apply = apply;

package/lib/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","names":["useState","useRef","useCallback","h","Tooltip"],"sources":["../src/client/index.ts"],"sourcesContent":["/**\n * dsh-chapters client entry: the per-message fork action.\n *\n * Registers one button into the assistant action row\n * (`conversation.chat.assistant-actions` — the slot the official feedback\n * package populates beside copy/branch). Clicking it executes `/chapters-fork`\n * through `remote.commands` — the exact wire the composer's input line rides —\n * then SWITCHES the app to the fresh branch:\n *\n *   1. `sessions.open(child)` — the client sessions service carries open() on\n *      its prototype (Playwright-verified against this host; a keys-dump alone\n *      hid it, which is why an earlier round wrongly gave up on this path);\n *   2. fallback: click the branch's sidebar row after expanding collapsed\n *      groups (plugin children can render under collapsed 'Ungrouped' heads);\n *   3. last resort: an inline note — the branch is durable either way.\n *\n * There is deliberately NO second implementation of fork logic here: the\n * button is a mouth for the host command (watermark, segmentation, budget,\n * titles, refusal-with-numbers all server-side, all tested). The purity gate\n * in tsdown.client.config.ts keeps this file cross-plugin-free.\n *\n * @module dsh-chapters/src/client\n */\n\nimport { createElement as h, useCallback, useEffect, useRef, useState, type ReactElement } from 'react'\n// The host's own tooltip bubble — a platform module served by the loader table,\n// external like react. Every action in this row labels through it.\nimport { Tooltip } from '@deepseek-ai/dsh-client-ui-primitives'\n\n/** Structural slice of the aggregated remote service (@deepseek-ai/dsh-api-remotes).\n * `remote.commands` must ALSO appear in inject — the federation gates each\n * sub-service individually (the live feedback package declares\n * remote.messageFeedback beside remote for exactly this reason). */\ninterface ClientRemote {\n  commands?: {\n    execute(sessionId: string, line: string, attachments: readonly unknown[]): Promise<{\n      ok?: boolean\n      value?: { commandId?: string; result?: { kind?: string; text?: string } }\n      error?: { code?: string; message?: string }\n    }>\n  }\n}\n\ninterface ClientSlots {\n  inject(name: string, factory: () => unknown): void\n  register(registration: Record<string, unknown>, component: unknown): unknown\n}\n\n/** The client sessions service (dsh-client-runtime): open() lives on the\n * prototype; everything else on the surface stays untrusted and unused. */\ninterface ClientSessions {\n  open(sessionId: string): unknown\n}\n\ninterface Ctx {\n  slots: ClientSlots\n  get(name: string): unknown\n}\n\nexport const inject = ['slots', 'remote', 'remote.commands', 'sessions'] as const\n\n/** Pull the child id and branch title out of the command's durable texts. */\nconst CHILD_ID = /is session (ch-[\\w-]+)/\nconst BRANCH_TITLE = /branch \\u201C([^\\u201D]+)\\u201D is session/\n\nfunction openByService(sessions: ClientSessions | undefined, sessionId: string): Promise<boolean> {\n  return (async () => {\n    const svc = sessions as unknown as { open?: (id: string) => unknown; refresh?: () => unknown } | undefined\n    if (typeof svc?.open !== 'function') return false\n    try { await svc.refresh?.() } catch { /* refresh best-effort */ }\n    // The store must know the session before open() resolves it; a child\n    // created seconds ago is only server-known until refresh lands. Retry\n    // open briefly across that window.\n    const started = Date.now()\n    for (;;) {\n      try { svc.open(sessionId); return true } catch {\n        if (Date.now() - started > 4_000) return false\n        await new Promise((r) => setTimeout(r, 250))\n      }\n    }\n  })()\n}\n\n/**\n * Fallback path: expand collapsed groups / show-more buttons, then click the\n * newest treeitem whose label contains the branch title (newest-updated sorts\n * first, so the first match is the fresh branch).\n */\nasync function openBranchRow(title: string, budgetMs = 4_000): Promise<boolean> {\n  if (typeof document === 'undefined') return false\n  const needle = title.toLowerCase()\n  const tryClick = (): boolean => {\n    const rows = Array.from(document.querySelectorAll<HTMLElement>('[role=\"treeitem\"]'))\n    const hit = rows.find((row) => (row.textContent ?? '').toLowerCase().includes(needle))\n    if (hit === undefined) return false\n    hit.click()\n    return true\n  }\n  const clickMore = (): number => {\n    const buttons = Array.from(document.querySelectorAll<HTMLElement>('button'))\n      .filter((b) => /more sessions|ungrouped/i.test(b.textContent ?? '') && b.getAttribute('aria-expanded') !== 'true')\n    for (const b of buttons) b.click()\n    return buttons.length\n  }\n  const started = Date.now()\n  let expansions = 0\n  while (Date.now() - started < budgetMs) {\n    if (tryClick()) return true\n    if (expansions < 4 && clickMore() > 0) { expansions += 1; await new Promise((r) => setTimeout(r, 250)); continue }\n    await new Promise((resolve) => setTimeout(resolve, 150))\n  }\n  return tryClick()\n}\n\nfunction makeForker(remote: ClientRemote, sessions: ClientSessions | undefined) {\n  return async function fork(sessionId: string): Promise<{ ok: boolean; message: string }> {\n    try {\n      if (remote.commands?.execute === undefined) return { ok: false, message: 'commands remote unavailable' }\n      const res = await remote.commands.execute(sessionId, '/chapters-fork', [])\n      if (res.ok !== true) return { ok: false, message: (res.error?.message ?? 'the fork call failed').slice(0, 90) }\n      const result = res.value?.result\n      const text = typeof result?.text === 'string' ? result.text : ''\n      if (result?.kind !== 'success') return { ok: false, message: (text || 'the fork was refused — see the command result').slice(0, 90) }\n      const child = CHILD_ID.exec(text)?.[1]\n      if (child === undefined) return { ok: true, message: 'forked — the branch is appearing in the sidebar' }\n      const opened = await openByService(sessions, child)\n      if (opened) return { ok: true, message: '' }\n      const title = BRANCH_TITLE.exec(text)?.[1]\n      if (title !== undefined && await openBranchRow(title)) return { ok: true, message: '' }\n      return { ok: true, message: 'forked — open the branch in the sidebar' }\n    } catch (error) {\n      return { ok: false, message: String((error as Error)?.message ?? error).slice(0, 90) }\n    }\n  }\n}\n\n/** Props composed by the slot framework: owner (`messageId`) + our injected verb. */\ninterface ForkActionProps {\n  messageId: string\n  fork: () => Promise<{ ok: boolean; message: string }>\n}\n\n/**\n * Style parity with the native IconActions row: rules copied verbatim from the\n * host's MessageIconActions module (`._xzv4MW_action` in dsh-client-ui-chat's\n * compiled client + the feedback package's :disabled) — same metrics, tokens,\n * hover. Update this string if the host restyles its action row.\n *\n * The final rule hides the native branch action IN THE MESSAGE ROW only\n * (user-approved cosmetic decision, docs/architecture.md): built-in chrome, so\n * the selector is its accessible label scoped to action-row buttons; both\n * locale spellings covered. If the host rewords the label the button simply\n * reappears — fails open, visibly.\n */\nconst CSS = [\n  '.dsh-chapters_forkAction{width:calc(28px + var(--dsh-content-font-delta,0px));height:calc(28px + var(--dsh-content-font-delta,0px));color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:none;border-radius:28px;justify-content:center;align-items:center;padding:6px;display:inline-flex}',\n  '.dsh-chapters_forkAction svg{width:calc(15px + var(--dsh-content-font-delta,0px));height:calc(15px + var(--dsh-content-font-delta,0px))}',\n  '.dsh-chapters_forkAction:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}',\n  '.dsh-chapters_forkAction:disabled{cursor:default;opacity:.4}',\n  '.dsh-chapters_forkNote{color:var(--dsw-alias-label-tertiary);padding-left:4px;font-size:13px;line-height:20px}',\n  'button[class*=\"_action\"][aria-label=\"Branch into a new conversation\"],button[class*=\"_action\"][aria-label=\"\\u5728\\u65b0\\u5bf9\\u8bdd\\u4e2d\\u5206\\u652f\"]{display:none !important}',\n].join('\\n')\nconst CSS_TAG_ID = 'dsh-chapters/assistant-action.css'\n\nfunction injectStyles(): void {\n  try {\n    if (typeof document === 'undefined' || document.querySelector(`style[data-plugin-css=${JSON.stringify(CSS_TAG_ID)}]`) !== null) return\n    const tag = document.createElement('style')\n    tag.dataset.plugin = 'dsh-chapters'\n    tag.dataset.pluginCss = CSS_TAG_ID\n    tag.textContent = CSS\n    document.head.appendChild(tag)\n  } catch { /* styling is cosmetic; the action still works without it */ }\n}\n\nfunction ChaptersForkAction({ fork }: ForkActionProps) {\n  const [busy, setBusy] = useState(false)\n  const [note, setNote] = useState<string | null>(null)\n  const alive = useRef(true)\n  useEffect(() => () => { alive.current = false }, [])\n  const onClick = useCallback(() => {\n    if (busy) return\n    setBusy(true)\n    setNote(null)\n    void fork().then((result) => {\n      if (!alive.current) return\n      setBusy(false)\n      setNote(result.message === '' ? null : result.message)\n      setTimeout(() => { if (alive.current) setNote(null) }, 8000)\n    })\n  }, [busy, fork])\n  const button = h('button', {\n    type: 'button',\n    'aria-label': 'Fork with chapters',\n    disabled: busy,\n    onClick,\n    className: 'dsh-chapters_forkAction',\n  },\n    h('svg', { viewBox: '0 0 16 16', width: '15', height: '15', fill: 'currentColor', 'aria-hidden': 'true' },\n      h('path', { d: 'M5 3.25a2.25 2.25 0 1 0-1.5 2.12v5.26a2.25 2.25 0 1 0 1.5 0V9h5a2.25 2.25 0 0 0 2.25-2.25v-1.4a2.25 2.25 0 1 0-1.5 0v1.4A.75.75 0 0 1 10 7.5H5V5.37A2.25 2.25 0 0 0 5 3.25Z' })))\n  return h('span', { style: { display: 'inline-flex', alignItems: 'center', gap: '4px' } },\n    h(Tooltip, { label: 'Fork with chapters', side: 'bottom' as const, children: button as ReactElement<Record<string, unknown>> }),\n    note !== null\n      ? h('span', { className: 'dsh-chapters_forkNote' }, note)\n      : null)\n}\n\nexport function apply(ctx: Ctx): void {\n  injectStyles()\n  const slots = ctx.slots\n  const remote = (ctx.get('remote') ?? {}) as ClientRemote\n  let sessions: ClientSessions | undefined\n  try { sessions = ctx.get('sessions') as ClientSessions | undefined } catch { sessions = undefined }\n  // No early return on missing descriptors: the button registers regardless\n  // and the click reports the gap. A missing button is worse than a button\n  // that explains itself.\n  const fork = makeForker(remote, sessions)\n  slots.inject('conversation.chat.assistant-actions', () => slots.register({\n    name: 'conversation.chat.assistant-actions',\n    id: 'chapters-fork',\n    order: 30,\n    inject: (sessionId: string) => ({ fork: () => fork(sessionId) }),\n  }, ChaptersForkAction))\n}\n"],"mappings":"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"}
+{"version":3,"file":"client.js","names":["useState","useRef","useCallback","h","Tooltip"],"sources":["../src/client/doors.ts","../src/client/index.ts"],"sourcesContent":["/**\n * The client door runner: the two deterministic archive doors, executed over\n * `remote.commands` and followed by a SWITCH to the fresh child.\n *\n * ONE runner, two rows. The server side keeps the same discipline — both doors\n * come from `deterministicCommand(door)` in src/tools.ts, and a unit row pins\n * that they archive identically. Copy-pasting this body is how the two would\n * drift apart, so there is exactly one implementation and a table of rows.\n *\n * `chapters-continue` ships only as a composer command; without a button here\n * the child is created correctly and the UI shows nothing, which reads as\n * \"nothing happened\". The row is the missing affordance, not new logic.\n *\n * React-free on purpose: the primitives package pulls CSS modules the node\n * test runner cannot load, so the testable half lives here and index.ts is the\n * thin chrome that renders these rows as buttons (tests/unit/client-doors.test.ts).\n *\n * @module dsh-chapters/src/client/doors\n */\n\n/** Structural slice of the aggregated remote service (@deepseek-ai/dsh-api-remotes).\n * `remote.commands` must ALSO appear in inject — the federation gates each\n * sub-service individually (the live feedback package declares\n * remote.messageFeedback beside remote for exactly this reason). */\nexport interface ClientRemote {\n  commands?: {\n    execute(sessionId: string, line: string, attachments: readonly unknown[]): Promise<{\n      ok?: boolean\n      value?: { commandId?: string; result?: { kind?: string; text?: string } }\n      error?: { code?: string; message?: string }\n    }>\n  }\n}\n\n/** The client sessions service (dsh-client-runtime): open() lives on the\n * prototype; everything else on the surface stays untrusted and unused. */\nexport interface ClientSessions {\n  open(sessionId: string): unknown\n}\n\nexport interface DoorResult {\n  ok: boolean\n  message: string\n}\n\n/**\n * One assistant-action row. `noun` is the server's own word for the child in\n * its success text (`branch` / `continuation`), so the fallback wording and the\n * title regex both track the door without a second implementation.\n */\nexport interface DoorAction {\n  /** The slot registration id. */\n  id: string\n  /** Position in the assistant action row. */\n  order: number\n  /** Button + tooltip label, and the accessible name the e2e specs select on. */\n  label: string\n  /** The host command this row executes — the ONLY semantic difference at runtime. */\n  command: string\n  /** The noun in `${noun} “title” is session ch-…`. */\n  noun: string\n  /** The row's glyph (16×16 viewBox, single path). */\n  iconPath: string\n}\n\nexport const DOOR_ACTIONS: readonly DoorAction[] = [\n  {\n    id: 'chapters-fork',\n    order: 30,\n    label: 'Fork with chapters',\n    command: '/chapters-fork',\n    noun: 'branch',\n    iconPath: 'M5 3.25a2.25 2.25 0 1 0-1.5 2.12v5.26a2.25 2.25 0 1 0 1.5 0V9h5a2.25 2.25 0 0 0 2.25-2.25v-1.4a2.25 2.25 0 1 0-1.5 0v1.4A.75.75 0 0 1 10 7.5H5V5.37A2.25 2.25 0 0 0 5 3.25Z',\n  },\n  {\n    id: 'chapters-continue',\n    order: 31,\n    label: 'Continue with chapters',\n    command: '/chapters-continue',\n    noun: 'continuation',\n    iconPath: 'M1 8a.75.75 0 0 1 0-1.5h9.44L7.72 3.28a.75.75 0 1 1 1.06-1.06l3.5 3.5.53.53-.53.53-3.5 3.5a.75.75 0 1 1-1.06-1.06L10.44 9.5H1Zm13-5.25v10.5a.75.75 0 0 1-1.5 0v-10.5a.75.75 0 0 1 1.5 0Z',\n  },\n]\n\n/** Pull the child id out of either door's durable success text — both end in\n * `… is session ch-…` (src/tools.ts), so this regex is door-agnostic. */\nexport const CHILD_ID = /is session (ch-[\\w-]+)/\n\n/** The quoted title the door gave the child, matched by its OWN noun so a\n * refusal or an unrelated quote cannot pass for it. */\nexport const doorTitle = (noun: string): RegExp => new RegExp(`${noun} \\\\u201C([^\\\\u201D]+)\\\\u201D is session`)\n\nfunction openByService(sessions: ClientSessions | undefined, sessionId: string): Promise<boolean> {\n  return (async () => {\n    const svc = sessions as unknown as { open?: (id: string) => unknown; refresh?: () => unknown } | undefined\n    if (typeof svc?.open !== 'function') return false\n    try { await svc.refresh?.() } catch { /* refresh best-effort */ }\n    // The store must know the session before open() resolves it; a child\n    // created seconds ago is only server-known until refresh lands. Retry\n    // open briefly across that window.\n    const started = Date.now()\n    for (;;) {\n      try { svc.open(sessionId); return true } catch {\n        if (Date.now() - started > 4_000) return false\n        await new Promise((r) => setTimeout(r, 250))\n      }\n    }\n  })()\n}\n\n/**\n * Fallback path: expand collapsed groups / show-more buttons, then click the\n * newest treeitem whose label contains the child title (newest-updated sorts\n * first, so the first match is the fresh child).\n */\nasync function openBranchRow(title: string, budgetMs = 4_000): Promise<boolean> {\n  if (typeof document === 'undefined') return false\n  const needle = title.toLowerCase()\n  const tryClick = (): boolean => {\n    const rows = Array.from(document.querySelectorAll<HTMLElement>('[role=\"treeitem\"]'))\n    const hit = rows.find((row) => (row.textContent ?? '').toLowerCase().includes(needle))\n    if (hit === undefined) return false\n    hit.click()\n    return true\n  }\n  const clickMore = (): number => {\n    const buttons = Array.from(document.querySelectorAll<HTMLElement>('button'))\n      .filter((b) => /more sessions|ungrouped/i.test(b.textContent ?? '') && b.getAttribute('aria-expanded') !== 'true')\n    for (const b of buttons) b.click()\n    return buttons.length\n  }\n  const started = Date.now()\n  let expansions = 0\n  while (Date.now() - started < budgetMs) {\n    if (tryClick()) return true\n    if (expansions < 4 && clickMore() > 0) { expansions += 1; await new Promise((r) => setTimeout(r, 250)); continue }\n    await new Promise((resolve) => setTimeout(resolve, 150))\n  }\n  return tryClick()\n}\n\nexport function makeDoorRunner(\n  remote: ClientRemote,\n  sessions: ClientSessions | undefined,\n  door: DoorAction,\n): (sessionId: string) => Promise<DoorResult> {\n  return async function run(sessionId: string): Promise<DoorResult> {\n    try {\n      if (remote.commands?.execute === undefined) return { ok: false, message: 'commands remote unavailable' }\n      const res = await remote.commands.execute(sessionId, door.command, [])\n      if (res.ok !== true) return { ok: false, message: (res.error?.message ?? `the ${door.noun} call failed`).slice(0, 90) }\n      const result = res.value?.result\n      const text = typeof result?.text === 'string' ? result.text : ''\n      if (result?.kind !== 'success') return { ok: false, message: (text || `the ${door.noun} was refused — see the command result`).slice(0, 90) }\n      const child = CHILD_ID.exec(text)?.[1]\n      if (child === undefined) return { ok: true, message: `${door.noun} created — appearing in the sidebar` }\n      const opened = await openByService(sessions, child)\n      if (opened) return { ok: true, message: '' }\n      const title = doorTitle(door.noun).exec(text)?.[1]\n      if (title !== undefined && await openBranchRow(title)) return { ok: true, message: '' }\n      return { ok: true, message: `${door.noun} created — open it in the sidebar` }\n    } catch (error) {\n      return { ok: false, message: String((error as Error)?.message ?? error).slice(0, 90) }\n    }\n  }\n}\n","/**\n * dsh-chapters client entry: the per-message door buttons.\n *\n * Registers the two deterministic archive doors into the assistant action row\n * (`conversation.chat.assistant-actions` — the slot the official feedback\n * package populates beside copy/branch). Clicking one executes its host\n * command — `/chapters-fork`, `/chapters-continue` — through `remote.commands`,\n * the exact wire the composer's input line rides, then SWITCHES the app to the\n * fresh child:\n *\n *   1. `sessions.open(child)` — the client sessions service carries open() on\n *      its prototype (Playwright-verified against this host; a keys-dump alone\n *      hid it, which is why an earlier round wrongly gave up on this path);\n *   2. fallback: click the child's sidebar row after expanding collapsed\n *      groups (plugin children can render under collapsed 'Ungrouped' heads);\n *   3. last resort: an inline note — the child is durable either way.\n *\n * There is deliberately NO second implementation of door logic here: the\n * buttons are mouths for the host commands (watermark, segmentation, budget,\n * titles, refusal-with-numbers all server-side, all tested), and the runner\n * they share is `src/client/doors.ts` — one body, one row per door. The purity\n * gate in tsdown.client.config.ts keeps this file cross-plugin-free.\n *\n * @module dsh-chapters/src/client\n */\n\nimport { createElement as h, useCallback, useEffect, useRef, useState, type ReactElement } from 'react'\n// The host's own tooltip bubble — a platform module served by the loader table,\n// external like react. Every action in this row labels through it.\nimport { Tooltip } from '@deepseek-ai/dsh-client-ui-primitives'\nimport { DOOR_ACTIONS, makeDoorRunner, type ClientRemote, type ClientSessions, type DoorAction, type DoorResult } from './doors.ts'\n\ninterface ClientSlots {\n  inject(name: string, factory: () => unknown): void\n  register(registration: Record<string, unknown>, component: unknown): unknown\n}\n\ninterface Ctx {\n  slots: ClientSlots\n  get(name: string): unknown\n}\n\nexport const inject = ['slots', 'remote', 'remote.commands', 'sessions'] as const\n\n/** Props composed by the slot framework: owner (`messageId`) + our injected verb. */\ninterface DoorActionProps {\n  messageId: string\n  run: () => Promise<DoorResult>\n}\n\n/**\n * Style parity with the native IconActions row: rules copied verbatim from the\n * host's MessageIconActions module (`._xzv4MW_action` in dsh-client-ui-chat's\n * compiled client + the feedback package's :disabled) — same metrics, tokens,\n * hover. Update this string if the host restyles its action row. Both doors\n * share these metrics.\n *\n * The final rule hides the native branch action IN THE MESSAGE ROW only\n * (user-approved cosmetic decision, docs/architecture.md): built-in chrome, so\n * the selector is its accessible label scoped to action-row buttons; both\n * locale spellings covered. If the host rewords the label the button simply\n * reappears — fails open, visibly.\n */\nconst CSS = [\n  '.dsh-chapters_forkAction{width:calc(28px + var(--dsh-content-font-delta,0px));height:calc(28px + var(--dsh-content-font-delta,0px));color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:none;border-radius:28px;justify-content:center;align-items:center;padding:6px;display:inline-flex}',\n  '.dsh-chapters_forkAction svg{width:calc(15px + var(--dsh-content-font-delta,0px));height:calc(15px + var(--dsh-content-font-delta,0px))}',\n  '.dsh-chapters_forkAction:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}',\n  '.dsh-chapters_forkAction:disabled{cursor:default;opacity:.4}',\n  '.dsh-chapters_forkNote{color:var(--dsw-alias-label-tertiary);padding-left:4px;font-size:13px;line-height:20px}',\n  'button[class*=\"_action\"][aria-label=\"Branch into a new conversation\"],button[class*=\"_action\"][aria-label=\"\\u5728\\u65b0\\u5bf9\\u8bdd\\u4e2d\\u5206\\u652f\"]{display:none !important}',\n].join('\\n')\nconst CSS_TAG_ID = 'dsh-chapters/assistant-action.css'\n\nfunction injectStyles(): void {\n  try {\n    if (typeof document === 'undefined' || document.querySelector(`style[data-plugin-css=${JSON.stringify(CSS_TAG_ID)}]`) !== null) return\n    const tag = document.createElement('style')\n    tag.dataset.plugin = 'dsh-chapters'\n    tag.dataset.pluginCss = CSS_TAG_ID\n    tag.textContent = CSS\n    document.head.appendChild(tag)\n  } catch { /* styling is cosmetic; the action still works without it */ }\n}\n\n/** One component body for every door row; only the label and glyph differ. */\nfunction makeDoorAction(door: DoorAction) {\n  return function ChaptersDoorAction({ run }: DoorActionProps) {\n    const [busy, setBusy] = useState(false)\n    const [note, setNote] = useState<string | null>(null)\n    const alive = useRef(true)\n    useEffect(() => () => { alive.current = false }, [])\n    const onClick = useCallback(() => {\n      if (busy) return\n      setBusy(true)\n      setNote(null)\n      void run().then((result) => {\n        if (!alive.current) return\n        setBusy(false)\n        setNote(result.message === '' ? null : result.message)\n        setTimeout(() => { if (alive.current) setNote(null) }, 8000)\n      })\n    }, [busy, run])\n    const button = h('button', {\n      type: 'button',\n      'aria-label': door.label,\n      disabled: busy,\n      onClick,\n      className: 'dsh-chapters_forkAction',\n    },\n      h('svg', { viewBox: '0 0 16 16', width: '15', height: '15', fill: 'currentColor', 'aria-hidden': 'true' },\n        h('path', { d: door.iconPath })))\n    return h('span', { style: { display: 'inline-flex', alignItems: 'center', gap: '4px' } },\n      h(Tooltip, { label: door.label, side: 'bottom' as const, children: button as ReactElement<Record<string, unknown>> }),\n      note !== null\n        ? h('span', { className: 'dsh-chapters_forkNote' }, note)\n        : null)\n  }\n}\n\nexport function apply(ctx: Ctx): void {\n  injectStyles()\n  const slots = ctx.slots\n  const remote = (ctx.get('remote') ?? {}) as ClientRemote\n  let sessions: ClientSessions | undefined\n  try { sessions = ctx.get('sessions') as ClientSessions | undefined } catch { sessions = undefined }\n  // No early return on missing descriptors: the buttons register regardless\n  // and the click reports the gap. A missing button is worse than a button\n  // that explains itself. Components and runners are built ONCE here — slot\n  // factories may re-run, and a fresh component identity per call would\n  // remount the row.\n  const rows = DOOR_ACTIONS.map((door) => ({ door, run: makeDoorRunner(remote, sessions, door), component: makeDoorAction(door) }))\n  slots.inject('conversation.chat.assistant-actions', () => rows.map(({ door, run, component }) => slots.register({\n    name: 'conversation.chat.assistant-actions',\n    id: door.id,\n    order: door.order,\n    inject: (sessionId: string) => ({ run: () => run(sessionId) }),\n  }, component)))\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/dsh-chapters",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "dsh plugin: verbatim chapter archive + zero-token index for small-context models",
   "type": "module",
   "license": "Apache-2.0",