dsh-brief-sidebar 0.7.0 → 0.8.0

package/lib/client.js

@@ -231,11 +231,11 @@ window.__ModuleLoader__.load({
 			in_progress: "var(--dsw-alias-state-business-primary)",
 			pending: "var(--dsw-alias-label-tertiary)"
 		};
-		const SECTION_STYLE$2 = {
+		const SECTION_STYLE$3 = {
 			flexShrink: 0,
 			borderBottom: "1px solid var(--dsw-alias-border-secondary)"
 		};
-		const HEADER_STYLE$3 = {
+		const HEADER_STYLE$4 = {
 			padding: "10px 12px 0",
 			color: "var(--dsw-alias-label-secondary)",
 			fontSize: 12,
@@ -246,14 +246,14 @@ window.__ModuleLoader__.load({
 			color: "var(--dsw-alias-label-secondary)",
 			fontSize: 12
 		};
-		const LIST_STYLE$2 = {
+		const LIST_STYLE$3 = {
 			listStyle: "none",
 			margin: 0,
 			padding: "6px 0",
 			display: "flex",
 			flexDirection: "column"
 		};
-		const ROW_STYLE$3 = {
+		const ROW_STYLE$4 = {
 			display: "flex",
 			alignItems: "flex-start",
 			gap: 8,
@@ -305,7 +305,7 @@ window.__ModuleLoader__.load({
 		/** One task row. */
 		function TodoRow(props) {
 			const { item, t } = props;
-			return (0, react.createElement)("li", { style: ROW_STYLE$3 }, (0, react.createElement)("span", { style: pillStyle(item.status) }, t(statusKey(item.status))), (0, react.createElement)("span", { style: contentStyle(item.status) }, item.content));
+			return (0, react.createElement)("li", { style: ROW_STYLE$4 }, (0, react.createElement)("span", { style: pillStyle(item.status) }, t(statusKey(item.status))), (0, react.createElement)("span", { style: contentStyle(item.status) }, item.content));
 		}
 		/**
 		* The progress section. The subscription is unconditional (a plain listener,
@@ -316,24 +316,24 @@ window.__ModuleLoader__.load({
 			const { t, ctx, scope } = props;
 			const todos = useTodos(ctx, scope?.sessionId);
 			if (todos === void 0) return (0, react.createElement)("div", {
-				style: SECTION_STYLE$2,
+				style: SECTION_STYLE$3,
 				"data-dsh-brief-sidebar": "progress-section"
-			}, (0, react.createElement)("div", { style: HEADER_STYLE$3 }, t("section.progress")), (0, react.createElement)(Notice, {
+			}, (0, react.createElement)("div", { style: HEADER_STYLE$4 }, t("section.progress")), (0, react.createElement)(Notice, {
 				title: t("board.unavailable"),
 				detail: t("board.unavailableHint")
 			}));
 			if (todos.length === 0) return (0, react.createElement)("div", {
-				style: SECTION_STYLE$2,
+				style: SECTION_STYLE$3,
 				"data-dsh-brief-sidebar": "progress-section"
-			}, (0, react.createElement)("div", { style: HEADER_STYLE$3 }, t("section.progress")), (0, react.createElement)(Notice, {
+			}, (0, react.createElement)("div", { style: HEADER_STYLE$4 }, t("section.progress")), (0, react.createElement)(Notice, {
 				title: t("board.empty"),
 				detail: t("board.emptyHint")
 			}));
 			const counts = countTodos(todos);
 			return (0, react.createElement)("div", {
-				style: SECTION_STYLE$2,
+				style: SECTION_STYLE$3,
 				"data-dsh-brief-sidebar": "progress-section"
-			}, (0, react.createElement)("div", { style: HEADER_STYLE$3 }, t("section.progress")), (0, react.createElement)("div", { style: PROGRESS_STYLE }, progressLine(counts, t)), (0, react.createElement)("ul", { style: LIST_STYLE$2 }, todos.map((item, index) => (0, react.createElement)(TodoRow, {
+			}, (0, react.createElement)("div", { style: HEADER_STYLE$4 }, t("section.progress")), (0, react.createElement)("div", { style: PROGRESS_STYLE }, progressLine(counts, t)), (0, react.createElement)("ul", { style: LIST_STYLE$3 }, todos.map((item, index) => (0, react.createElement)(TodoRow, {
 				key: `${index}:${item.content}`,
 				item,
 				t
@@ -561,10 +561,15 @@ window.__ModuleLoader__.load({
 				"slots.status.done": "已完成",
 				"slots.status.dropped": "已弃置",
 				"slots.status.expired": "已过期",
+				"section.memoryRecall": "本会话召回",
+				"recall.empty": "本会话还没有召回到记忆",
+				"recall.count": "注入 {count} 条 · 压缩后自动清空",
 				"settings.title": "概要侧栏",
 				"settings.desc": "右侧栏概要 tab 的分区开关（只读展示）。",
 				"settings.memorySlots": "记忆槽位分区",
 				"settings.memorySlotsHint": "开启后，概要 tab 在进展与产物之下显示 dsh-prime-memory 的激活记忆槽位（只读）。",
+				"settings.memoryRecall": "本会话召回分区",
+				"settings.memoryRecallHint": "开启后，概要 tab 显示本会话已注入、尚未被压缩覆盖的记忆（只读，非常驻）。",
 				"settings.unavailable": "配置面不可用，记忆分区按默认「开」处理。",
 				"settings.readonly": "当前配置只读，无法在此修改。"
 			},
@@ -592,10 +597,15 @@ window.__ModuleLoader__.load({
 				"slots.status.done": "Done",
 				"slots.status.dropped": "Dropped",
 				"slots.status.expired": "Expired",
+				"section.memoryRecall": "Session recall",
+				"recall.empty": "No memories recalled in this session yet",
+				"recall.count": "{count} injected · cleared on compaction",
 				"settings.title": "Brief sidebar",
 				"settings.desc": "Section switches for the summary tab in the right sidebar (read-only views).",
 				"settings.memorySlots": "Memory slots section",
 				"settings.memorySlotsHint": "When on, the summary tab lists the active memory slots from dsh-prime-memory beneath progress and produced files (read-only).",
+				"settings.memoryRecall": "Session recall section",
+				"settings.memoryRecallHint": "When on, the summary tab lists memories injected in this session that compaction has not overwritten (read-only, not resident).",
 				"settings.unavailable": "The config face is unavailable; the memory section falls back to its default (on).",
 				"settings.readonly": "This config is read-only here; edits are not available."
 			},
@@ -623,10 +633,15 @@ window.__ModuleLoader__.load({
 				"slots.status.done": "完了",
 				"slots.status.dropped": "破棄",
 				"slots.status.expired": "期限切れ",
+				"section.memoryRecall": "このセッションの想起",
+				"recall.empty": "このセッションではまだ記憶を想起していません",
+				"recall.count": "{count} 件注入 · 圧縮で自動消去",
 				"settings.title": "概要サイドバー",
 				"settings.desc": "右サイドバー概要タブのセクション表示切り替え（読み取り専用）。",
 				"settings.memorySlots": "メモリスロットセクション",
 				"settings.memorySlotsHint": "オンにすると、概要タブの進行状況と成果物の下に dsh-prime-memory のアクティブなメモリスロット（読み取り専用）が表示されます。",
+				"settings.memoryRecall": "セッション想起のセクション",
+				"settings.memoryRecallHint": "オンにすると、概要タブにこのセッションで注入され、まだ圧縮で失われていない記憶を表示します（読み取り専用、常駐しません）。",
 				"settings.unavailable": "設定画面を利用できません。メモリセクションは既定（オン）で動作します。",
 				"settings.readonly": "この設定はここでは読み取り専用のため変更できません。"
 			},
@@ -654,10 +669,15 @@ window.__ModuleLoader__.load({
 				"slots.status.done": "완료",
 				"slots.status.dropped": "폐기",
 				"slots.status.expired": "만료",
+				"section.memoryRecall": "이 세션 회상",
+				"recall.empty": "이 세션에서는 아직 기억을 회상하지 않았습니다",
+				"recall.count": "{count}개 주입 · 압축 시 자동 삭제",
 				"settings.title": "요약 사이드바",
 				"settings.desc": "오른쪽 사이드바 요약 탭의 섹션 표시 전환(읽기 전용).",
 				"settings.memorySlots": "메모리 슬롯 섹션",
 				"settings.memorySlotsHint": "켜면 요약 탭의 진행 상황과 산출물 아래에 dsh-prime-memory의 활성 메모리 슬롯(읽기 전용)이 표시됩니다.",
+				"settings.memoryRecall": "세션 회상 섹션",
+				"settings.memoryRecallHint": "켜면 개요 탭에 이 세션에 주입되고 아직 압축으로 사라지지 않은 기억이 표시됩니다(읽기 전용, 상주하지 않음).",
 				"settings.unavailable": "설정 화면을 사용할 수 없어 메모리 섹션은 기본값(켜짐)으로 동작합니다.",
 				"settings.readonly": "이 설정은 여기서 읽기 전용이므로 변경할 수 없습니다."
 			},
@@ -685,10 +705,15 @@ window.__ModuleLoader__.load({
 				"slots.status.done": "Terminé",
 				"slots.status.dropped": "Abandonné",
 				"slots.status.expired": "Expiré",
+				"section.memoryRecall": "Rappel de la session",
+				"recall.empty": "Aucun souvenir rappelé dans cette session",
+				"recall.count": "{count} injectés · effacés à la compression",
 				"settings.title": "Barre latérale Résumé",
 				"settings.desc": "Interrupteurs des sections de l’onglet Résumé de la barre latérale (lecture seule).",
 				"settings.memorySlots": "Section des emplacements mémoire",
 				"settings.memorySlotsHint": "Une fois activé, l’onglet Résumé liste les emplacements mémoire actifs de dsh-prime-memory sous l’avancement et les fichiers produits (lecture seule).",
+				"settings.memoryRecall": "Section rappel de session",
+				"settings.memoryRecallHint": "Affiche dans l’onglet Résumé les souvenirs injectés dans cette session et non encore effacés par la compression (lecture seule, non résidents).",
 				"settings.unavailable": "Le canal de configuration est indisponible ; la section mémoire revient à sa valeur par défaut (activée).",
 				"settings.readonly": "Cette configuration est en lecture seule ici ; aucune modification possible."
 			},
@@ -716,10 +741,15 @@ window.__ModuleLoader__.load({
 				"slots.status.done": "Erledigt",
 				"slots.status.dropped": "Verworfen",
 				"slots.status.expired": "Abgelaufen",
+				"section.memoryRecall": "Sitzungserinnerung",
+				"recall.empty": "In dieser Sitzung wurden noch keine Erinnerungen geholt",
+				"recall.count": "{count} eingefügt · beim Komprimieren geleert",
 				"settings.title": "Übersicht-Seitenleiste",
 				"settings.desc": "Schalter für die Abschnitte des Übersicht-Tabs in der rechten Seitenleiste (schreibgeschützt).",
 				"settings.memorySlots": "Speicherplätze-Abschnitt",
 				"settings.memorySlotsHint": "Ist der Schalter eingeschaltet, listet der Übersicht-Tab die aktiven Speicherplätze aus dsh-prime-memory unter Fortschritt und erzeugten Dateien auf (schreibgeschützt).",
+				"settings.memoryRecall": "Bereich Sitzungserinnerung",
+				"settings.memoryRecallHint": "Zeigt in der Übersichtsseite die in dieser Sitzung eingefügten, noch nicht komprimierten Erinnerungen (schreibgeschützt, nicht dauerhaft).",
 				"settings.unavailable": "Die Konfigurationsoberfläche ist nicht verfügbar; der Gedächtnis-Abschnitt fällt auf den Standard (ein) zurück.",
 				"settings.readonly": "Diese Konfiguration ist hier schreibgeschützt; Änderungen sind nicht möglich."
 			},
@@ -747,10 +777,15 @@ window.__ModuleLoader__.load({
 				"slots.status.done": "Completato",
 				"slots.status.dropped": "Scartato",
 				"slots.status.expired": "Scaduto",
+				"section.memoryRecall": "Richiamo della sessione",
+				"recall.empty": "Nessun ricordo richiamato in questa sessione",
+				"recall.count": "{count} inseriti · svuotati alla compressione",
 				"settings.title": "Barra laterale Riepilogo",
 				"settings.desc": "Interruttori delle sezioni della scheda Riepilogo nella barra laterale destra (sola lettura).",
 				"settings.memorySlots": "Sezione slot di memoria",
 				"settings.memorySlotsHint": "Quando attivo, la scheda Riepilogo elenca gli slot di memoria attivi di dsh-prime-memory sotto avanzamento e file prodotti (sola lettura).",
+				"settings.memoryRecall": "Sezione richiamo sessione",
+				"settings.memoryRecallHint": "Mostra nella pagina Riepilogo i ricordi inseriti in questa sessione e non ancora rimossi dalla compressione (sola lettura, non residenti).",
 				"settings.unavailable": "La superficie di configurazione non è disponibile; la sezione memoria torna al valore predefinito (attivo).",
 				"settings.readonly": "Questa configurazione è in sola lettura qui; non è possibile modificarla."
 			},
@@ -778,10 +813,15 @@ window.__ModuleLoader__.load({
 				"slots.status.done": "Завершён",
 				"slots.status.dropped": "Отброшен",
 				"slots.status.expired": "Истёк",
+				"section.memoryRecall": "Воспоминания сессии",
+				"recall.empty": "В этой сессии воспоминания ещё не вызывались",
+				"recall.count": "вставлено {count} · очищается при сжатии",
 				"settings.title": "Боковая панель «Сводка»",
 				"settings.desc": "Переключатели разделов вкладки «Сводка» на правой панели (только чтение).",
 				"settings.memorySlots": "Раздел слотов памяти",
 				"settings.memorySlotsHint": "Когда включено, вкладка «Сводка» показывает активные слоты памяти из dsh-prime-memory под ходом работы и созданными файлами (только чтение).",
+				"settings.memoryRecall": "Раздел Воспоминания сессии",
+				"settings.memoryRecallHint": "Показывает на странице Обзор воспоминания, вставленные в этой сессии и ещё не удалённые сжатием (только чтение, не постоянные).",
 				"settings.unavailable": "Панель конфигурации недоступна; раздел памяти работает по умолчанию (включён).",
 				"settings.readonly": "Эта конфигурация здесь только для чтения; изменить её нельзя."
 			},
@@ -809,10 +849,15 @@ window.__ModuleLoader__.load({
 				"slots.status.done": "Hecha",
 				"slots.status.dropped": "Descartada",
 				"slots.status.expired": "Caducada",
+				"section.memoryRecall": "Recuerdo de la sesión",
+				"recall.empty": "Aún no se ha recuperado ningún recuerdo en esta sesión",
+				"recall.count": "{count} insertados · se limpia al comprimir",
 				"settings.title": "Barra lateral Resumen",
 				"settings.desc": "Interruptores de las secciones de la pestaña Resumen en la barra lateral derecha (solo lectura).",
 				"settings.memorySlots": "Sección de ranuras de memoria",
 				"settings.memorySlotsHint": "Al activarla, la pestaña Resumen enumera las ranuras de memoria activas de dsh-prime-memory bajo el avance y los archivos generados (solo lectura).",
+				"settings.memoryRecall": "Sección de recuerdo de sesión",
+				"settings.memoryRecallHint": "Muestra en la pestaña Resumen los recuerdos insertados en esta sesión y aún no eliminados por la compresión (solo lectura, no residentes).",
 				"settings.unavailable": "La superficie de configuración no está disponible; la sección de memoria vuelve a su valor por defecto (activada).",
 				"settings.readonly": "Esta configuración es de solo lectura aquí; no se puede modificar."
 			}
@@ -846,24 +891,24 @@ window.__ModuleLoader__.load({
 		*
 		* Colours come from `--dsw-alias-*` tokens only (skin contract).
 		*/
-		const SECTION_STYLE$1 = {
+		const SECTION_STYLE$2 = {
 			flexShrink: 0,
 			borderBottom: "1px solid var(--dsw-alias-border-secondary)"
 		};
-		const HEADER_STYLE$2 = {
+		const HEADER_STYLE$3 = {
 			padding: "10px 12px 0",
 			color: "var(--dsw-alias-label-secondary)",
 			fontSize: 12,
 			fontWeight: 600
 		};
-		const LIST_STYLE$1 = {
+		const LIST_STYLE$2 = {
 			listStyle: "none",
 			margin: 0,
 			padding: "6px 0",
 			display: "flex",
 			flexDirection: "column"
 		};
-		const ROW_STYLE$2 = {
+		const ROW_STYLE$3 = {
 			display: "flex",
 			alignItems: "flex-start",
 			gap: 8,
@@ -929,11 +974,11 @@ window.__ModuleLoader__.load({
 			const title = plan === null ? path : `${t("deliverable.codeplanTag")}: ${plan.task} · ${path}`;
 			const label = basename(path);
 			const content = plan === null ? null : (0, react.createElement)("span", { style: TAG_STYLE }, t("deliverable.codeplanTag"));
-			if (open === void 0) return (0, react.createElement)("li", { style: ROW_STYLE$2 }, content, (0, react.createElement)("span", {
+			if (open === void 0) return (0, react.createElement)("li", { style: ROW_STYLE$3 }, content, (0, react.createElement)("span", {
 				style: PATH_STYLE,
 				title
 			}, label));
-			return (0, react.createElement)("li", { style: ROW_STYLE$2 }, content, (0, react.createElement)("button", {
+			return (0, react.createElement)("li", { style: ROW_STYLE$3 }, content, (0, react.createElement)("button", {
 				style: BUTTON_STYLE,
 				title,
 				onClick: () => {
@@ -958,9 +1003,9 @@ window.__ModuleLoader__.load({
 			const latestPaths = view.latest?.paths ?? [];
 			const history = historyPaths(view.sessionPaths, latestPaths);
 			if (latestPaths.length === 0 && view.sessionTotal === 0) return (0, react.createElement)("div", {
-				style: SECTION_STYLE$1,
+				style: SECTION_STYLE$2,
 				"data-dsh-brief-sidebar": "deliverables-section"
-			}, (0, react.createElement)("div", { style: HEADER_STYLE$2 }, t("section.deliverables")), (0, react.createElement)("div", { style: {
+			}, (0, react.createElement)("div", { style: HEADER_STYLE$3 }, t("section.deliverables")), (0, react.createElement)("div", { style: {
 				margin: "0 auto",
 				padding: 24,
 				maxWidth: 460,
@@ -973,9 +1018,9 @@ window.__ModuleLoader__.load({
 				color: "var(--dsw-alias-label-secondary)"
 			} }, t("deliverables.empty")), (0, react.createElement)("div", null, t("deliverables.emptyHint"))));
 			return (0, react.createElement)("div", {
-				style: SECTION_STYLE$1,
+				style: SECTION_STYLE$2,
 				"data-dsh-brief-sidebar": "deliverables-section"
-			}, (0, react.createElement)("div", { style: HEADER_STYLE$2 }, t("section.deliverables")), (0, react.createElement)("ul", { style: LIST_STYLE$1 }, latestPaths.map((path) => (0, react.createElement)(PathRow, {
+			}, (0, react.createElement)("div", { style: HEADER_STYLE$3 }, t("section.deliverables")), (0, react.createElement)("ul", { style: LIST_STYLE$2 }, latestPaths.map((path) => (0, react.createElement)(PathRow, {
 				key: path,
 				path,
 				t,
@@ -1000,7 +1045,7 @@ window.__ModuleLoader__.load({
 				strokeWidth: 1.5,
 				strokeLinecap: "round",
 				strokeLinejoin: "round"
-			}))), historyOpen && (0, react.createElement)("ul", { style: LIST_STYLE$1 }, history.map((path) => (0, react.createElement)(PathRow, {
+			}))), historyOpen && (0, react.createElement)("ul", { style: LIST_STYLE$2 }, history.map((path) => (0, react.createElement)(PathRow, {
 				key: path,
 				path,
 				t,
@@ -1048,7 +1093,7 @@ window.__ModuleLoader__.load({
 		function readSlots(value) {
 			if (value === null || typeof value !== "object" || Array.isArray(value)) return void 0;
 			const raw = value;
-			if (!isCounter(raw["rev"]) || !isCounter(raw["count"]) || !isCounter(raw["openCount"])) return void 0;
+			if (!isCounter$1(raw["rev"]) || !isCounter$1(raw["count"]) || !isCounter$1(raw["openCount"])) return void 0;
 			if (!Array.isArray(raw["slots"])) return void 0;
 			const slots = [];
 			for (const entry of raw["slots"]) {
@@ -1063,7 +1108,7 @@ window.__ModuleLoader__.load({
 			};
 		}
 		/** Whether a value is a non-negative safe integer (the view's counter shape). */
-		function isCounter(value) {
+		function isCounter$1(value) {
 			return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
 		}
 		/** Narrow one slot entry; `undefined` = malformed, dropped. */
@@ -1116,8 +1161,62 @@ window.__ModuleLoader__.load({
 		* explicit `false` is the only off.
 		*/
 		function resolveShowMemorySlots(snapshot) {
+			if (snapshot === void 0 || snapshot.status !== "ready") return false;
+			return snapshot.value?.showMemorySlots === true;
+		}
+		/**
+		* Resolve the session-recall switch from one snapshot (pure; testable).
+		* Any cannot-answer shape falls back to {@link DEFAULT_SHOW_MEMORY_RECALL};
+		* an explicit `false` is the only off.
+		*/
+		function resolveShowMemoryRecall(snapshot) {
 			if (snapshot === void 0 || snapshot.status !== "ready") return true;
-			return snapshot.value?.showMemorySlots !== false;
+			return snapshot.value?.showMemoryRecall !== false;
+		}
+		//#endregion
+		//#region src/client/summary/use-config-flag.ts
+		/**
+		* The shared `configForms` subscription behind this plugin's section switches.
+		*
+		* Both memory sections (pinned slots / session recall) gate on one boolean of
+		* this plugin's entry config. The plumbing — defensive scope resolution,
+		* `useSyncExternalStore`, and a stable absent-snapshot — is identical, so it
+		* lives here once; each section passes its own pure resolver, which is what
+		* the unit tests pin.
+		*
+		* A host without `configForms` (or a scope still loading) degrades to the
+		* resolver's default instead of throwing inside a render.
+		*/
+		/**
+		* The snapshot served while no config scope is reachable — every resolver
+		* maps it to its own default.
+		*/
+		const ABSENT_SNAPSHOT = {
+			status: "unavailable",
+			value: void 0,
+			revision: void 0,
+			writable: false
+		};
+		/** A no-op unsubscribe source, kept as one identity so the absent-scope
+		*  subscription never thrashes (a store contract requires a disposer). */
+		const NO_SUBSCRIBE$1 = () => () => {};
+		/**
+		* Read one config switch, live.
+		*
+		* @param ctx - the client root context handed to the tab body.
+		* @param resolve - pure snapshot → boolean resolver (owns the default).
+		* @returns the resolved switch value.
+		*/
+		function useConfigFlag(ctx, resolve) {
+			const scope = (0, react.useMemo)(() => {
+				if (ctx === void 0) return void 0;
+				const configForms = ctx.get("configForms");
+				if (configForms === void 0 || typeof configForms.get !== "function") return void 0;
+				return configForms.get("dsh-brief-sidebar");
+			}, [ctx]);
+			const subscribe = (0, react.useCallback)((listener) => scope?.subscribe(listener) ?? NO_SUBSCRIBE$1(), [scope]);
+			const getSnapshot = (0, react.useCallback)(() => scope?.getSnapshot() ?? ABSENT_SNAPSHOT, [scope]);
+			return resolve((0, react.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot));
 		}
 		//#endregion
 		//#region src/client/summary/MemorySlotsSection.tsx
@@ -1129,9 +1228,10 @@ window.__ModuleLoader__.load({
 		* paints nothing here:
 		*
 		* 1. **The switch.** This plugin's entry config (`configForms` → entry
-		*    `dsh-brief-sidebar`, field `showMemorySlots`, default on). When the
-		*    config face cannot answer (service absent, scope not ready, field
-		*    unset) the default applies — see `scope-face.ts`.
+		*    `dsh-brief-sidebar`, field `showMemorySlots`, default OFF — the pinned
+		*    list moved out of the summary pane's way in favour of the session-recall
+		*    section). When the config face cannot answer (service absent, scope not
+		*    ready, field unset) the default applies — see `scope-face.ts`.
 		* 2. **The capability.** The `memorySlots` projection must exist for the
 		*    session; `undefined` hides the section entirely, exactly like the
 		*    optional deliverables section.
@@ -1139,35 +1239,35 @@ window.__ModuleLoader__.load({
 		* Colours come from `--dsw-alias-*` tokens only (skin contract, enforced by
 		* `tests/purity.spec.ts`).
 		*/
-		const SECTION_STYLE = {
+		const SECTION_STYLE$1 = {
 			flexShrink: 0,
 			borderBottom: "1px solid var(--dsw-alias-border-secondary)"
 		};
-		const HEADER_STYLE$1 = {
+		const HEADER_STYLE$2 = {
 			padding: "10px 12px 0",
 			color: "var(--dsw-alias-label-secondary)",
 			fontSize: 12,
 			fontWeight: 600
 		};
-		const LIST_STYLE = {
+		const LIST_STYLE$1 = {
 			listStyle: "none",
 			margin: 0,
 			padding: "6px 0",
 			display: "flex",
 			flexDirection: "column"
 		};
-		const ROW_STYLE$1 = {
+		const ROW_STYLE$2 = {
 			display: "flex",
 			alignItems: "flex-start",
 			gap: 8,
 			padding: "6px 12px"
 		};
-		const TITLE_STYLE = {
+		const TITLE_STYLE$1 = {
 			minWidth: 0,
 			overflowWrap: "anywhere",
 			color: "var(--dsw-alias-label-secondary)"
 		};
-		const META_STYLE = {
+		const META_STYLE$1 = {
 			flexShrink: 0,
 			color: "var(--dsw-alias-label-tertiary)",
 			fontSize: 11,
@@ -1218,7 +1318,7 @@ window.__ModuleLoader__.load({
 			color: "var(--dsw-alias-label-tertiary)",
 			fontSize: 12
 		};
-		const EMPTY_STYLE = {
+		const EMPTY_STYLE$1 = {
 			margin: "0 auto",
 			padding: 24,
 			maxWidth: 460,
@@ -1245,57 +1345,29 @@ window.__ModuleLoader__.load({
 			const statusLabel = STATUS_KEY[slot.status] === void 0 ? slot.status : t(STATUS_KEY[slot.status]);
 			const title = slot.body === void 0 ? slot.title : `${slot.title} — ${slot.body}`;
 			const refsLine = slot.refViews !== void 0 ? slot.refViews.map((view) => view.title).join(" · ") : slot.refs !== void 0 ? slot.refs.join(" · ") : void 0;
-			return (0, react.createElement)("li", { style: ROW_STYLE$1 }, (0, react.createElement)("span", { style: KIND_STYLE }, slot.kind), (0, react.createElement)("div", { style: {
+			return (0, react.createElement)("li", { style: ROW_STYLE$2 }, (0, react.createElement)("span", { style: KIND_STYLE }, slot.kind), (0, react.createElement)("div", { style: {
 				minWidth: 0,
 				flex: "1 1 auto",
 				display: "flex",
 				flexDirection: "column",
 				gap: 2
 			} }, (0, react.createElement)("span", {
-				style: TITLE_STYLE,
+				style: TITLE_STYLE$1,
 				title
 			}, slot.title), slot.body !== void 0 && (0, react.createElement)("p", { style: BODY_STYLE$1 }, truncateBody(slot.body)), refsLine !== void 0 && (0, react.createElement)("p", {
 				style: REFS_STYLE,
 				title: slot.refs !== void 0 ? slot.refs.join("\n") : void 0
-			}, refsLine)), (0, react.createElement)("span", { style: META_STYLE }, `P${slot.priority}`), (0, react.createElement)("span", { style: slot.status === "open" ? STATUS_OPEN_STYLE : STATUS_SETTLED_STYLE }, statusLabel));
+			}, refsLine)), (0, react.createElement)("span", { style: META_STYLE$1 }, `P${slot.priority}`), (0, react.createElement)("span", { style: slot.status === "open" ? STATUS_OPEN_STYLE : STATUS_SETTLED_STYLE }, statusLabel));
 		}
 		/**
-		* A no-op unsubscribe source, kept as one identity so the absent-scope
-		* subscription never thrashes (returns a no-op disposer, as the store
-		* contract requires).
-		*/
-		const NO_SUBSCRIBE$1 = () => () => {};
-		/**
-		* The snapshot served while no config scope is reachable — resolves to the
-		* switch default (on) in `resolveShowMemorySlots`.
-		*/
-		const ABSENT_SNAPSHOT = {
-			status: "unavailable",
-			value: void 0,
-			revision: void 0,
-			writable: false
-		};
-		/**
-		* Subscribe to this plugin's entry config and resolve the section switch.
-		*
-		* The scope is resolved defensively (a host without `configForms` degrades to
-		* the default instead of throwing inside a render) and subscribed with
-		* `useSyncExternalStore`, so flipping the switch in settings updates the open
-		* tab without a reload.
+		* Subscribe to this plugin's entry config and resolve the slots switch.
+		* Plumbing lives in `use-config-flag`; the default (off) lives in the resolver.
 		*
 		* @param ctx - the client root context handed to the tab body.
 		* @returns whether the memory-slots section may render at all.
 		*/
 		function useShowMemorySlots(ctx) {
-			const scope = (0, react.useMemo)(() => {
-				if (ctx === void 0) return void 0;
-				const configForms = ctx.get("configForms");
-				if (configForms === void 0 || typeof configForms.get !== "function") return void 0;
-				return configForms.get("dsh-brief-sidebar");
-			}, [ctx]);
-			const subscribe = (0, react.useCallback)((listener) => scope?.subscribe(listener) ?? NO_SUBSCRIBE$1(), [scope]);
-			const getSnapshot = (0, react.useCallback)(() => scope?.getSnapshot() ?? ABSENT_SNAPSHOT, [scope]);
-			return resolveShowMemorySlots((0, react.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot));
+			return useConfigFlag(ctx, resolveShowMemorySlots);
 		}
 		/**
 		* The memory-slots section. Both hooks run unconditionally (a conditional
@@ -1310,31 +1382,239 @@ window.__ModuleLoader__.load({
 			if (show === false) return null;
 			if (view === void 0) return null;
 			if (view.slots.length === 0) return (0, react.createElement)("div", {
-				style: SECTION_STYLE,
+				style: SECTION_STYLE$1,
 				"data-dsh-brief-sidebar": "memory-slots-section"
-			}, (0, react.createElement)("div", { style: HEADER_STYLE$1 }, t("section.memorySlots")), (0, react.createElement)("div", { style: EMPTY_STYLE }, (0, react.createElement)("div", { style: {
+			}, (0, react.createElement)("div", { style: HEADER_STYLE$2 }, t("section.memorySlots")), (0, react.createElement)("div", { style: EMPTY_STYLE$1 }, (0, react.createElement)("div", { style: {
 				marginBottom: 6,
 				color: "var(--dsw-alias-label-secondary)"
 			} }, t("slots.empty")), (0, react.createElement)("div", null, t("slots.emptyHint"))));
 			return (0, react.createElement)("div", {
-				style: SECTION_STYLE,
+				style: SECTION_STYLE$1,
 				"data-dsh-brief-sidebar": "memory-slots-section"
-			}, (0, react.createElement)("div", { style: HEADER_STYLE$1 }, t("section.memorySlots")), (0, react.createElement)("ul", { style: LIST_STYLE }, view.slots.map((slot) => (0, react.createElement)(SlotRow, {
+			}, (0, react.createElement)("div", { style: HEADER_STYLE$2 }, t("section.memorySlots")), (0, react.createElement)("ul", { style: LIST_STYLE$1 }, view.slots.map((slot) => (0, react.createElement)(SlotRow, {
 				key: slot.id,
 				slot,
 				t
 			}))), (0, react.createElement)("div", { style: TOTAL_STYLE }, expandCount(t("slots.openCount"), view.openCount)));
 		}
 		//#endregion
+		//#region src/client/summary/memory-recall.ts
+		/**
+		* The `memoryRecall` projection — reading it.
+		*
+		* The projection unit is registered by `dsh-prime-memory` (key `memoryRecall`,
+		* wire view `{rev, sessionId, count, items[]}`): the memories this session has
+		* actually injected and that compaction has not overwritten yet. Unlike
+		* `memorySlots` (pinned, resident conventions written by hand), this set is
+		* NOT resident — it is the at-a-glance answer to "what is the model seeing
+		* right now", and it empties itself when the context is compacted.
+		*
+		* This plugin does NOT depend on prime-memory: with the unit unregistered the
+		* client reads `undefined` from the face and the section hides. The module is
+		* deliberately PURE — no React, no context, no IO — so the narrowing is
+		* testable directly, exactly like `memory-slots.ts`.
+		*/
+		/** The projection key `dsh-prime-memory` registers (its canonical constant). */
+		const MEMORY_RECALL_KEY = "memoryRecall";
+		/** Whether a value is a non-negative safe integer (the view's counter shape). */
+		function isCounter(value) {
+			return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+		}
+		/** Narrow one item entry; `undefined` = malformed, dropped. */
+		function readItem(value) {
+			if (value === null || typeof value !== "object" || Array.isArray(value)) return void 0;
+			const raw = value;
+			if (typeof raw["id"] !== "string" || raw["id"].length === 0) return void 0;
+			if (typeof raw["type"] !== "string" || typeof raw["title"] !== "string") return void 0;
+			if (typeof raw["priority"] !== "number") return void 0;
+			const item = {
+				id: raw["id"],
+				type: raw["type"],
+				title: raw["title"],
+				priority: raw["priority"]
+			};
+			if (Array.isArray(raw["scenario"])) {
+				const phrases = raw["scenario"].filter((s) => typeof s === "string" && s.length > 0);
+				if (phrases.length > 0) item.scenario = phrases;
+			}
+			return item;
+		}
+		/**
+		* Narrow a raw projection value into a recall view.
+		*
+		* `undefined` means the capability is ABSENT (prime-memory not in the
+		* composition, or no frame carried the key) or the frame drifted beyond repair;
+		* a view with `items: []` IS the honest empty state (prime-memory publishes as
+		* soon as the unit registers). Malformed items are dropped, never thrown on.
+		*
+		* @param value - the raw `unknown` snapshot of the `memoryRecall` face.
+		* @returns the validated view, or `undefined` when the capability is absent.
+		*/
+		function readRecall(value) {
+			if (value === null || typeof value !== "object" || Array.isArray(value)) return void 0;
+			const raw = value;
+			if (!isCounter(raw["rev"]) || !isCounter(raw["count"])) return void 0;
+			if (typeof raw["sessionId"] !== "string") return void 0;
+			if (!Array.isArray(raw["items"])) return void 0;
+			const items = [];
+			for (const entry of raw["items"]) {
+				const item = readItem(entry);
+				if (item !== void 0) items.push(item);
+			}
+			return {
+				rev: raw["rev"],
+				sessionId: raw["sessionId"],
+				count: raw["count"],
+				items
+			};
+		}
+		//#endregion
+		//#region src/client/summary/MemoryRecallSection.tsx
+		/**
+		* The session-recall section: what this session actually injected, drawn as a
+		* part of the summary tab.
+		*
+		* Where `MemorySlotsSection` lists hand-pinned resident conventions (written
+		* once, injected every turn), this one answers a different question: **which
+		* memories is the model seeing right now**. The set is not resident — it is
+		* relevance recall, and prime-memory empties it when the context is compacted
+		* or cleared, so an entry disappearing here is honest, not a bug.
+		*
+		* TWO gates, both fail-open to "hidden", mirroring the slots section:
+		*
+		* 1. **The switch.** This plugin's entry config (`configForms` → field
+		*    `showMemoryRecall`, default on).
+		* 2. **The capability.** The `memoryRecall` projection must exist for the
+		*    session; `undefined` hides the section entirely — a composition without
+		*    dsh-prime-memory paints nothing here.
+		*
+		* Rows are read-only by design: the write surface for memory is prime-memory's
+		* own panel, and offering pin/activate affordances here would re-introduce the
+		* "resident list" reading this section exists to replace.
+		*
+		* Colours come from `--dsw-alias-*` tokens only (skin contract, enforced by
+		* `tests/purity.spec.ts`).
+		*/
+		const SECTION_STYLE = {
+			flexShrink: 0,
+			borderBottom: "1px solid var(--dsw-alias-border-secondary)"
+		};
+		const HEADER_STYLE$1 = {
+			padding: "10px 12px 0",
+			color: "var(--dsw-alias-label-secondary)",
+			fontSize: 12,
+			fontWeight: 600
+		};
+		const LIST_STYLE = {
+			listStyle: "none",
+			margin: 0,
+			padding: "6px 0",
+			display: "flex",
+			flexDirection: "column"
+		};
+		const ROW_STYLE$1 = {
+			display: "flex",
+			alignItems: "flex-start",
+			gap: 8,
+			padding: "6px 12px"
+		};
+		/** The type pill: same form as the slot kind pill, tertiary emphasis. */
+		const TYPE_STYLE = {
+			flexShrink: 0,
+			color: "var(--dsw-alias-label-tertiary)",
+			border: "1px solid var(--dsw-alias-label-tertiary)",
+			borderRadius: 999,
+			padding: "0 6px",
+			fontSize: 11,
+			lineHeight: "16px",
+			whiteSpace: "nowrap"
+		};
+		const TITLE_STYLE = {
+			minWidth: 0,
+			overflowWrap: "anywhere",
+			color: "var(--dsw-alias-label-secondary)"
+		};
+		const SCENARIO_STYLE = {
+			margin: 0,
+			minWidth: 0,
+			overflowWrap: "anywhere",
+			color: "var(--dsw-alias-label-tertiary)",
+			fontSize: 11,
+			lineHeight: "16px"
+		};
+		const META_STYLE = {
+			flexShrink: 0,
+			color: "var(--dsw-alias-label-tertiary)",
+			fontSize: 11,
+			lineHeight: "18px",
+			whiteSpace: "nowrap"
+		};
+		const FOOTER_STYLE = {
+			padding: "6px 12px 10px",
+			color: "var(--dsw-alias-label-tertiary)",
+			fontSize: 12
+		};
+		const EMPTY_STYLE = {
+			margin: "0 auto",
+			padding: 24,
+			maxWidth: 460,
+			textAlign: "center",
+			color: "var(--dsw-alias-label-tertiary)",
+			lineHeight: 1.7,
+			fontSize: 12
+		};
+		/**
+		* One recalled memory: type pill, first line of the body (full text and the
+		* "when should this surface" phrases ride the tooltip), its own priority.
+		*/
+		function RecallRow(props) {
+			const { item } = props;
+			const scenario = item.scenario === void 0 ? void 0 : item.scenario.join(" · ");
+			return (0, react.createElement)("li", { style: ROW_STYLE$1 }, (0, react.createElement)("span", { style: TYPE_STYLE }, item.type), (0, react.createElement)("div", { style: {
+				minWidth: 0,
+				flex: "1 1 auto",
+				display: "flex",
+				flexDirection: "column",
+				gap: 2
+			} }, (0, react.createElement)("span", {
+				style: TITLE_STYLE,
+				title: scenario === void 0 ? item.title : `${item.title} — ${scenario}`
+			}, item.title), scenario !== void 0 && (0, react.createElement)("p", { style: SCENARIO_STYLE }, scenario)), (0, react.createElement)("span", { style: META_STYLE }, `P${item.priority}`));
+		}
+		/**
+		* The session-recall section. Both hooks run unconditionally (a conditional
+		* hook order would break the moment the switch flips); the switch only decides
+		* whether the resolved view paints.
+		* @param props - translation, client context, session scope.
+		*/
+		function MemoryRecallSection(props) {
+			const { t, ctx, scope } = props;
+			const show = useConfigFlag(ctx, resolveShowMemoryRecall);
+			const view = readRecall(useProjectionValue(ctx, scope?.sessionId, MEMORY_RECALL_KEY));
+			if (show === false) return null;
+			if (view === void 0) return null;
+			if (view.items.length === 0) return (0, react.createElement)("div", {
+				style: SECTION_STYLE,
+				"data-dsh-brief-sidebar": "memory-recall-section"
+			}, (0, react.createElement)("div", { style: HEADER_STYLE$1 }, t("section.memoryRecall")), (0, react.createElement)("div", { style: EMPTY_STYLE }, t("recall.empty")));
+			return (0, react.createElement)("div", {
+				style: SECTION_STYLE,
+				"data-dsh-brief-sidebar": "memory-recall-section"
+			}, (0, react.createElement)("div", { style: HEADER_STYLE$1 }, t("section.memoryRecall")), (0, react.createElement)("ul", { style: LIST_STYLE }, view.items.map((item) => (0, react.createElement)(RecallRow, {
+				key: item.id,
+				item
+			}))), (0, react.createElement)("div", { style: FOOTER_STYLE }, expandCount(t("recall.count"), view.count)));
+		}
+		//#endregion
 		//#region src/client/SummaryTab.tsx
 		/**
 		* The summary tab body: the session's at-a-glance state, composed of sections.
 		*
 		* Section order: 进展 (the todos board) → 产物 (produced files, codeplan
-		* artifacts marked inline) → 记忆 (the active memory slots of the session,
-		* served by the `memorySlots` projection dsh-prime-memory registers).
-		* Each section owns its own data chain and its own gating contract; this
-		* component owns only the shell.
+		* artifacts marked inline) → 本会话召回 (what prime-memory injected into this
+		* session and compaction has not overwritten) → 记忆槽位 (hand-pinned resident
+		* conventions, off by default). Each section owns its own data chain and its
+		* own gating contract; this component owns only the shell.
 		*
 		* Two better-sidebar contracts are honoured:
 		*
@@ -1381,6 +1661,11 @@ window.__ModuleLoader__.load({
 				t,
 				ctx,
 				scope
+			}), (0, react.createElement)(MemoryRecallSection, {
+				key: "memory-recall",
+				t,
+				ctx,
+				scope
 			}), (0, react.createElement)(MemorySlotsSection, {
 				key: "memory-slots",
 				t,
@@ -1628,6 +1913,25 @@ window.__ModuleLoader__.load({
 			cursor: "pointer"
 		};
 		/**
+		* One switch row: label + hint on the left, checkbox on the right. Extracted
+		* because the card now binds two sections (session recall / pinned slots).
+		*/
+		function FlagRow(props) {
+			return (0, react.createElement)("div", { style: ROW_STYLE }, (0, react.createElement)("div", { style: ROW_TEXT_STYLE }, (0, react.createElement)("label", {
+				htmlFor: props.id,
+				style: LABEL_STYLE
+			}, props.label), (0, react.createElement)("p", { style: HINT_STYLE }, props.hint)), (0, react.createElement)("input", {
+				id: props.id,
+				type: "checkbox",
+				checked: props.checked,
+				disabled: props.disabled,
+				style: SWITCH_STYLE,
+				onChange: (event) => {
+					props.onToggle(event.currentTarget.checked);
+				}
+			}));
+		}
+		/**
 		* The settings card body. `scope` is optional on purpose: the inject factory
 		* always provides it, but a host whose `configForms` face degrades must not
 		* crash the settings page — the card renders the unavailable note and keeps
@@ -1639,7 +1943,8 @@ window.__ModuleLoader__.load({
 			const snapshot = (0, react.useSyncExternalStore)((0, react.useCallback)((listener) => scope?.subscribe(listener) ?? NO_SUBSCRIBE(), [scope]), (0, react.useCallback)(() => scope?.getSnapshot() ?? ABSENT, [scope]), (0, react.useCallback)(() => scope?.getSnapshot() ?? ABSENT, [scope]));
 			const unavailable = scope === void 0 || snapshot.status === "unavailable";
 			const readonly = unavailable || !snapshot.writable;
-			const checked = snapshot.value?.showMemorySlots !== false;
+			const slotsChecked = resolveShowMemorySlots(snapshot);
+			const recallChecked = resolveShowMemoryRecall(snapshot);
 			return (0, react.createElement)("div", {
 				style: CARD_STYLE,
 				"data-dsh-brief-sidebar": "settings-card"
@@ -1663,17 +1968,29 @@ window.__ModuleLoader__.load({
 				strokeWidth: 1.5,
 				strokeLinecap: "round",
 				strokeLinejoin: "round"
-			}))), open && (0, react.createElement)("div", { style: BODY_STYLE }, unavailable ? (0, react.createElement)("p", { style: HINT_STYLE }, t("settings.unavailable")) : (0, react.createElement)("div", { style: ROW_STYLE }, (0, react.createElement)("div", { style: ROW_TEXT_STYLE }, (0, react.createElement)("label", {
-				htmlFor: "dsh-brief-sidebar-show-memory-slots",
-				style: LABEL_STYLE
-			}, t("settings.memorySlots")), (0, react.createElement)("p", { style: HINT_STYLE }, t("settings.memorySlotsHint"))), (0, react.createElement)("input", {
+			}))), open && (0, react.createElement)("div", { style: BODY_STYLE }, unavailable ? (0, react.createElement)("p", { style: HINT_STYLE }, t("settings.unavailable")) : (0, react.createElement)("div", { style: {
+				display: "flex",
+				flexDirection: "column",
+				gap: 12
+			} }, (0, react.createElement)(FlagRow, {
+				key: "recall",
+				id: "dsh-brief-sidebar-show-memory-recall",
+				label: t("settings.memoryRecall"),
+				hint: t("settings.memoryRecallHint"),
+				checked: recallChecked,
+				disabled: readonly,
+				onToggle: (next) => {
+					scope?.set("showMemoryRecall", next);
+				}
+			}), (0, react.createElement)(FlagRow, {
+				key: "slots",
 				id: "dsh-brief-sidebar-show-memory-slots",
-				type: "checkbox",
-				checked,
+				label: t("settings.memorySlots"),
+				hint: t("settings.memorySlotsHint"),
+				checked: slotsChecked,
 				disabled: readonly,
-				style: SWITCH_STYLE,
-				onChange: (event) => {
-					scope?.set("showMemorySlots", event.currentTarget.checked);
+				onToggle: (next) => {
+					scope?.set("showMemorySlots", next);
 				}
 			})), !unavailable && !snapshot.writable && (0, react.createElement)("p", { style: HINT_STYLE }, t("settings.readonly"))));
 		}