dsh-pstack 0.2.0 → 0.3.0-beta.1

package/dist/client.mjs

@@ -7,6 +7,98 @@ window.__ModuleLoader__.load({
 		let react = require("react");
 		let react_jsx_runtime = require("react/jsx-runtime");
 		let react_dom = require("react-dom");
+		// src/internal/role-manifest.ts
+		/** The 17 roles, in manifest order. */
+		const ROLE_MANIFEST = [
+			{
+				key: "feature, refactoring",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "bug-fix",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "perf-issue",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "hillclimb",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "judgment and prose",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "hardest tasks",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "how explorer",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "how explainer",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "why investigators",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "why synthesizer",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "reflect tooling",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "reflect judgment, divergent, synthesizer",
+				shape: "single",
+				autoPanel: false
+			},
+			{
+				key: "arena runners",
+				shape: "list",
+				autoPanel: true
+			},
+			{
+				key: "arena cross-judge pool",
+				shape: "list",
+				autoPanel: false
+			},
+			{
+				key: "swarm workers",
+				shape: "list",
+				autoPanel: false
+			},
+			{
+				key: "architect runners",
+				shape: "list",
+				autoPanel: true
+			},
+			{
+				key: "interrogate reviewers",
+				shape: "list",
+				autoPanel: true
+			}
+		];
+		function isRoleKey(value) {
+			return ROLE_MANIFEST.some((role) => role.key === value);
+		}
 		// src/remote.ts
 		/** npm package that owns these methods. */
 		const REMOTE_PACKAGE = "dsh-pstack";
@@ -79,7 +171,7 @@ window.__ModuleLoader__.load({
 		}
 		function parseRoleView(value, index) {
 			const record = parseRecord(value, `roles[${index}]`);
-			if (typeof record["key"] !== "string") throw new TypeError(`roles[${index}].key must be a string`);
+			if (typeof record["key"] !== "string" || !isRoleKey(record["key"])) throw new TypeError(`roles[${index}].key is not in the role manifest`);
 			if (record["shape"] !== "single" && record["shape"] !== "list") throw new TypeError(`roles[${index}].shape is unknown`);
 			if (typeof record["configured"] !== "boolean") throw new TypeError(`roles[${index}].configured must be a boolean`);
 			const routes = record["routes"];
@@ -247,19 +339,13 @@ window.__ModuleLoader__.load({
 		];
 		/** The complete optional-plugin catalogue in documentation order. */
 		const OPTIONAL_PLUGINS = [
-			{
-				id: "OPT-01",
-				group: "sessions",
-				packages: ["@deepseek-ai/dsh-experimental-worktree", "@deepseek-ai/dsh-experimental-tool-worktree"],
-				bundle: "@deepseek-ai/dsh-experimental-tool-worktree",
-				recommended: true
-			},
 			{
 				id: "OPT-02",
 				group: "sessions",
 				packages: ["@deepseek-ai/dsh-experimental-forge-bundle"],
 				bundle: "@deepseek-ai/dsh-experimental-forge-bundle",
-				suggested: true
+				recommended: true,
+				exclusiveWith: ["@deepseek-ai/dsh-experimental-worktree", "@deepseek-ai/dsh-experimental-tool-worktree"]
 			},
 			{
 				id: "OPT-03",
@@ -310,6 +396,10 @@ window.__ModuleLoader__.load({
 				bundle: "@deepseek-ai/dsh-experimental-ralph-bundle"
 			}
 		];
+		/** The default recommendation ids, in catalogue order. */
+		function defaultRecommendationIds() {
+			return OPTIONAL_PLUGINS.filter((plugin) => plugin.recommended === true).map((plugin) => plugin.id);
+		}
 		// src/client/optional-plugins-state.ts
 		/**
 		* Pure state and small async operations for the optional-plugin recommendation
@@ -317,9 +407,22 @@ window.__ModuleLoader__.load({
 		* browser tests cover every decision without mounting the Plugins page.
 		*
 		* The two wire shapes below mirror the public `BundleInfo` and `ChangeResult`
-		* fields this page reads from `pluginManager` (DSH 0.2.2-alpha.2), the same way
+		* fields this page reads from `pluginManager` (DSH 0.2.2-alpha.3), the same way
 		* `remote.ts` hand-writes the role Remote contract.
 		*/
+		/** Bundle names the Host currently reports as enabled. */
+		function enabledBundleNames(bundles) {
+			return new Set((bundles ?? []).filter((bundle) => bundle.enabled).map((bundle) => bundle.name));
+		}
+		/**
+		* Mutual-exclusion bundles of one row that are already enabled. The page must
+		* not switch this row on while any of them stays on (for example the standalone
+		* worktree bundle next to the unified forge bundle).
+		*/
+		function conflictingEnabledBundles(definition, bundles) {
+			const enabled = enabledBundleNames(bundles);
+			return (definition.exclusiveWith ?? []).filter((name) => enabled.has(name));
+		}
 		/** Read one bundle's display status, including platform and file failures. */
 		function optionalPluginStatus(bundle) {
 			if (bundle === void 0) return "missing";
@@ -334,11 +437,13 @@ window.__ModuleLoader__.load({
 			return OPTIONAL_PLUGINS.map((definition) => {
 				const bundle = definition.bundle === void 0 ? void 0 : byName.get(definition.bundle);
 				const status = definition.bundle === void 0 ? "missing" : optionalPluginStatus(bundle);
+				const blockedBy = conflictingEnabledBundles(definition, bundles);
 				return {
 					definition,
 					status,
 					enabled: status === "enabled",
-					canToggle: definition.bundle !== void 0 && definition.switchable !== false && (status === "off" || status === "enabled")
+					canToggle: definition.bundle !== void 0 && definition.switchable !== false && (status === "enabled" || status === "off" && blockedBy.length === 0),
+					blockedBy
 				};
 			});
 		}
@@ -363,6 +468,16 @@ window.__ModuleLoader__.load({
 					skipped += 1;
 					continue;
 				}
+				if (row.blockedBy.length > 0) {
+					outcomes.push({
+						id: row.definition.id,
+						bundle: row.definition.bundle,
+						application: "skipped",
+						blockedBy: row.blockedBy
+					});
+					skipped += 1;
+					continue;
+				}
 				try {
 					const result = await api.setBundleEnabled(row.definition.bundle, true);
 					outcomes.push({
@@ -444,10 +559,6 @@ window.__ModuleLoader__.load({
 			"multi-agent": "groupMultiAgent"
 		};
 		const COPY = {
-			"OPT-01": {
-				title: "opt01Title",
-				detail: "opt01Detail"
-			},
 			"OPT-02": {
 				title: "opt02Title",
 				detail: "opt02Detail"
@@ -516,6 +627,7 @@ window.__ModuleLoader__.load({
 		function changeResultText(application, t, reason) {
 			if (application === "applied") return t("resultApplied");
 			if (application === "restart-required") return t("resultRestartRequired");
+			if (application === "skipped") return t("resultSkippedConflict", { bundles: reason ?? "" });
 			if (application === "failed" || application === "error") return t("resultFailed", { reason: reason ?? application });
 			if (application === "overridden") return t("resultOverridden");
 			return t("resultCancelled");
@@ -527,6 +639,7 @@ window.__ModuleLoader__.load({
 		/** Render the recommendation section; all decisions come from props. */
 		function OptionalPluginsView(props) {
 			const { rows, status, loadError, busyId, bulkBusy = false, messages, summary, onToggle, onEnableRecommended, onRetry, t } = props;
+			const recommendationIds = defaultRecommendationIds();
 			const offRecommended = rows.filter((row) => row.definition.recommended === true && row.status === "off").length;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
 				"data-optional-plugins": true,
@@ -600,7 +713,7 @@ window.__ModuleLoader__.load({
 									color: COLOR_CAPTION$1,
 									fontSize: 12
 								},
-								children: t("recommendedHint")
+								children: t("recommendedHint", { ids: recommendationIds.join(t("listSeparator")) })
 							})
 						]
 					}),
@@ -684,10 +797,6 @@ window.__ModuleLoader__.load({
 								style: tagStyle(COLOR_SUCCESS$1),
 								children: t("recommendedTag")
 							}) : null,
-							definition.suggested === true ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-								style: tagStyle(COLOR_SECONDARY$1),
-								children: t("suggestedTag")
-							}) : null,
 							definition.conflict === true ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 								style: tagStyle(COLOR_ERROR$1),
 								children: t("conflictTag")
@@ -722,6 +831,16 @@ window.__ModuleLoader__.load({
 						},
 						children: t("conflictWarning")
 					}) : null,
+					row.blockedBy.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						role: "alert",
+						style: {
+							margin: 0,
+							color: COLOR_ERROR$1,
+							fontSize: 12,
+							lineHeight: 1.5
+						},
+						children: t("mutexWarning", { bundles: row.blockedBy.join(t("listSeparator")) })
+					}) : null,
 					nonBundle ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 						style: {
 							margin: 0,
@@ -796,8 +915,19 @@ window.__ModuleLoader__.load({
 			const rows = optionalPluginRows(bundles);
 			const reload = () => setReloadToken((value) => value + 1);
 			const toggle = (id, enabled) => {
-				const bundle = rows.find((candidate) => candidate.definition.id === id)?.definition.bundle;
-				if (bundle === void 0) return;
+				const row = rows.find((candidate) => candidate.definition.id === id);
+				const bundle = row?.definition.bundle;
+				if (row === void 0 || bundle === void 0) return;
+				if (enabled && row.blockedBy.length > 0) {
+					setMessages((current) => ({
+						...current,
+						[id]: {
+							tone: "error",
+							text: t("resultSkippedConflict", { bundles: row.blockedBy.join(t("listSeparator")) })
+						}
+					}));
+					return;
+				}
 				setBusyId(id);
 				setMessages((current) => {
 					const { [id]: _ignored, ...rest } = current;
@@ -831,10 +961,13 @@ window.__ModuleLoader__.load({
 				setMessages({});
 				enableRecommendedPlugins(api, rows).then((result) => {
 					const next = {};
-					for (const outcome of result.outcomes) next[outcome.id] = {
-						tone: outcome.application === "failed" || outcome.application === "error" ? "error" : "ok",
-						text: changeResultText(outcome.application, t)
-					};
+					for (const outcome of result.outcomes) {
+						const blocked = outcome.application === "skipped";
+						next[outcome.id] = {
+							tone: outcome.application === "failed" || outcome.application === "error" || blocked ? "error" : "ok",
+							text: changeResultText(outcome.application, t, blocked ? (outcome.blockedBy ?? []).join(t("listSeparator")) : void 0)
+						};
+					}
 					setMessages(next);
 					setSummary(t("recommendedSummary", {
 						applied: result.applied,
@@ -1222,10 +1355,7 @@ window.__ModuleLoader__.load({
 		/** Localized role name and usage, keyed by the exact role-file key. */
 		function rolePresentation(key, t) {
 			const copy = roleCopyKeys[key];
-			return copy === void 0 ? {
-				name: key,
-				description: ""
-			} : {
+			return {
 				name: t(copy.name),
 				description: t(copy.description)
 			};
@@ -1257,6 +1387,17 @@ window.__ModuleLoader__.load({
 				color: primary ? "var(--dsw-alias-label-primary-foreground)" : COLOR_TEXT$1
 			};
 		}
+		function dangerButtonStyle() {
+			return {
+				border: `1px solid color-mix(in srgb, ${COLOR_ERROR} 55%, transparent)`,
+				borderRadius: 8,
+				padding: "5px 12px",
+				cursor: "pointer",
+				font: "inherit",
+				background: `color-mix(in srgb, ${COLOR_ERROR} 10%, transparent)`,
+				color: COLOR_ERROR
+			};
+		}
 		function fieldStyle(basis, fullWidth = false) {
 			return {
 				flex: fullWidth ? "1 1 auto" : `1 1 ${basis}px`,
@@ -1414,7 +1555,7 @@ window.__ModuleLoader__.load({
 					routes.length > 1 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 						type: "button",
 						style: {
-							...buttonStyle(),
+							...dangerButtonStyle(),
 							justifySelf: "start"
 						},
 						onClick: () => onRemove(index),
@@ -2157,7 +2298,6 @@ window.__ModuleLoader__.load({
 				groupVerification: "Verification and evidence",
 				groupMultiAgent: "Multi-agent",
 				recommendedTag: "Recommended",
-				suggestedTag: "GitHub PR suggestion",
 				conflictTag: "Conflict",
 				optionalLoading: "Loading optional plugin status…",
 				optionalLoadFailed: "Could not read optional plugin status: {message}",
@@ -2166,7 +2306,8 @@ window.__ModuleLoader__.load({
 				enableRecommended: "Enable recommended plugins",
 				enablingRecommended: "Enabling recommended plugins…",
 				recommendedSummary: "{applied} applied, {restart} need a restart, {failed} failed, {skipped} skipped",
-				recommendedHint: "Default recommendations: OPT-01, OPT-06.",
+				recommendedHint: "Default recommendations: {ids}.",
+				listSeparator: ", ",
 				enablePlugin: "Enable",
 				disablePlugin: "Disable",
 				pluginWorking: "Working…",
@@ -2180,15 +2321,15 @@ window.__ModuleLoader__.load({
 				resultFailed: "Failed: {reason}",
 				resultOverridden: "Overridden by a higher layer",
 				resultCancelled: "Cancelled",
+				resultSkippedConflict: "Skipped: turn off {bundles} first",
 				conflictWarning: "Do not enable Agent Teams and pstack_subagent in one profile: Agent Teams disables subagent and subagent_fork and replaces the child controls.",
 				nonBundleGuidance: "Not a bundle: configure it in the DSH documentation; this page cannot switch it.",
+				mutexWarning: "This conflicts with {bundles}; turn it off first.",
 				guidanceTitle: "{count} recommended plugins are still off",
 				guidanceOpen: "Review recommended plugins",
 				guidanceDismiss: "Dismiss",
-				opt01Title: "Worktree isolation",
-				opt01Detail: "Creates local worktrees for /arena, /swarm, and /architect; the worktree tool changes the Session directory.",
-				opt02Title: "GitHub PR workspace",
-				opt02Detail: "PR panels, checks, reviews, ready state, and merge for /babysit, /shipping, and /autopilot-*; needs a logged-in gh.",
+				opt02Title: "Change requests & worktrees",
+				opt02Detail: "One switch for PR panels, checks, reviews, ready state, merge, worktree Sessions, and the model's create_worktree tool for /babysit, /shipping, and /autopilot-*; needs a logged-in gh for GitHub status.",
 				opt03Title: "Browser verification",
 				opt03Detail: "Browser navigation, input, screenshots, and ARIA snapshots; pick one provider and a supported model.",
 				opt04Title: "Computer use",
@@ -2217,7 +2358,6 @@ window.__ModuleLoader__.load({
 				groupVerification: "验证与证据",
 				groupMultiAgent: "多代理",
 				recommendedTag: "推荐",
-				suggestedTag: "GitHub PR 用户建议",
 				conflictTag: "冲突",
 				optionalLoading: "正在读取可选插件状态…",
 				optionalLoadFailed: "无法读取可选插件状态：{message}",
@@ -2226,7 +2366,8 @@ window.__ModuleLoader__.load({
 				enableRecommended: "一键启用推荐项",
 				enablingRecommended: "正在启用推荐项…",
 				recommendedSummary: "成功 {applied} 项，需重启 {restart} 项，失败 {failed} 项，跳过 {skipped} 项",
-				recommendedHint: "默认推荐 OPT-01、OPT-06。",
+				recommendedHint: "默认推荐 {ids}。",
+				listSeparator: "、",
 				enablePlugin: "启用",
 				disablePlugin: "关闭",
 				pluginWorking: "处理中…",
@@ -2240,15 +2381,15 @@ window.__ModuleLoader__.load({
 				resultFailed: "失败：{reason}",
 				resultOverridden: "被更高层覆盖",
 				resultCancelled: "已取消",
+				resultSkippedConflict: "已跳过：请先关闭 {bundles}",
 				conflictWarning: "不要在同一 profile 中同时启用 Agent Teams 与 pstack_subagent：Agent Teams 会禁用 subagent 和 subagent_fork，并替换子代理控制。",
 				nonBundleGuidance: "非 bundle 项：请按 DSH 文档配置，本页不提供开关。",
+				mutexWarning: "此项与 {bundles} 冲突；请先关闭它。",
 				guidanceTitle: "还有 {count} 个推荐插件未开启",
 				guidanceOpen: "查看推荐插件",
 				guidanceDismiss: "忽略",
-				opt01Title: "工作树隔离",
-				opt01Detail: "为 /arena、/swarm 和 /architect 创建本地工作树；worktree 工具会切换 Session 目录。",
-				opt02Title: "GitHub PR 工作区",
-				opt02Detail: "提供 PR 面板、checks、review、mark ready 与 merge，服务 /babysit、/shipping 和 /autopilot-*；需要已登录的 gh。",
+				opt02Title: "Change requests & worktrees",
+				opt02Detail: "同一开关提供 PR 面板、checks、review、mark ready、merge、工作树 Session 与模型侧 create_worktree 工具，服务 /babysit、/shipping 和 /autopilot-*；GitHub 状态需要已登录的 gh。",
 				opt03Title: "浏览器验证",
 				opt03Detail: "提供浏览器导航、输入、截图和 ARIA 快照；需选择一个提供方和受支持的模型。",
 				opt04Title: "桌面操作",