dsh-pstack 0.2.0-beta.3 → 0.2.1

package/dist/client.mjs

@@ -0,0 +1,2448 @@
+window.__ModuleLoader__.load({
+	id: "dsh-pstack",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		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";
+		/** Cordis service key and wire namespace of the Host role service. */
+		const ROLES_SERVICE = "pstackRoles";
+		function jsonCodec(typeSymbol, parse, decode) {
+			return {
+				mode: "strict",
+				typeSymbol,
+				create: () => ({ parse }),
+				...decode === void 0 ? {} : { decode }
+			};
+		}
+		function parameter(wire, typeSymbol, parse) {
+			return {
+				name: wire,
+				wire,
+				source: "json",
+				codec: jsonCodec(typeSymbol, parse)
+			};
+		}
+		function parseRecord(value, subject) {
+			if (typeof value !== "object" || value === null || Array.isArray(value)) throw new TypeError(`${subject} must be an object`);
+			return value;
+		}
+		function parseRoute(value, subject) {
+			const record = parseRecord(value, subject);
+			if (record["kind"] === "inherit") {
+				const alias = record["alias"] ?? "inherit-parent";
+				if (alias !== "inherit-parent" && alias !== "auto") throw new TypeError(`${subject}.alias must be "inherit-parent" or "auto"`);
+				return {
+					kind: "inherit",
+					alias
+				};
+			}
+			if (record["kind"] !== "route") throw new TypeError(`${subject}.kind is unknown`);
+			const provider = record["provider"];
+			const model = record["model"];
+			const effort = record["effort"];
+			if (typeof provider !== "string" || provider.trim() === "") throw new TypeError(`${subject}.provider must be a non-empty string`);
+			if (typeof model !== "string" || model.trim() === "") throw new TypeError(`${subject}.model must be a non-empty string`);
+			if (effort !== void 0 && (typeof effort !== "string" || effort.trim() === "")) throw new TypeError(`${subject}.effort must be a non-empty string when present`);
+			return {
+				kind: "route",
+				provider,
+				model,
+				...typeof effort === "string" ? { effort } : {}
+			};
+		}
+		/** Parse one save request from the wire. */
+		function parseSaveRoleRequest(value) {
+			const record = parseRecord(value, "the save request");
+			if (typeof record["key"] !== "string") throw new TypeError("the save request must name a role");
+			const routes = record["routes"];
+			if (!Array.isArray(routes)) throw new TypeError("the save request must carry a route list");
+			return {
+				key: record["key"],
+				routes: routes.map((route, index) => parseRoute(route, `routes[${index}]`))
+			};
+		}
+		function parseRoleFileIssue(value) {
+			const record = parseRecord(value, "a role file issue");
+			if (typeof record["message"] !== "string") throw new TypeError("a role file issue needs a message");
+			const line = record["line"];
+			if (line !== void 0 && typeof line !== "number") throw new TypeError("a role file issue line must be a number");
+			return {
+				...typeof line === "number" ? { line } : {},
+				message: record["message"]
+			};
+		}
+		function parseRoleView(value, index) {
+			const record = parseRecord(value, `roles[${index}]`);
+			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"];
+			const issues = record["issues"];
+			if (!Array.isArray(routes) || !Array.isArray(issues)) throw new TypeError(`roles[${index}] must carry routes and issues arrays`);
+			const line = record["line"];
+			return {
+				key: record["key"],
+				shape: record["shape"],
+				configured: record["configured"],
+				...typeof line === "number" ? { line } : {},
+				routes: routes.map((route, routeIndex) => parseRoute(route, `roles[${index}].routes[${routeIndex}]`)),
+				issues: issues.map((issue) => String(issue))
+			};
+		}
+		/** Parse a role-file snapshot from the wire. */
+		function parseRoleFileSnapshot(value) {
+			const record = parseRecord(value, "the role file snapshot");
+			const status = record["status"];
+			if (status !== "missing" && status !== "loaded" && status !== "unreadable") throw new TypeError("the role file snapshot status is unknown");
+			if (typeof record["path"] !== "string") throw new TypeError("the role file snapshot path must be a string");
+			if (typeof record["canSave"] !== "boolean") throw new TypeError("the role file snapshot canSave must be a boolean");
+			const roles = record["roles"];
+			const issues = record["issues"];
+			if (!Array.isArray(roles) || !Array.isArray(issues)) throw new TypeError("the role file snapshot must carry roles and issues arrays");
+			const reason = record["reason"];
+			const budget = record["budget"];
+			return {
+				path: record["path"],
+				status,
+				...typeof reason === "string" ? { reason } : {},
+				...typeof budget === "string" ? { budget } : {},
+				roles: roles.map((role, index) => parseRoleView(role, index)),
+				issues: issues.map(parseRoleFileIssue),
+				canSave: record["canSave"]
+			};
+		}
+		/** Parse a save result from the wire. */
+		function parseSaveRoleResult(value) {
+			const record = parseRecord(value, "the save result");
+			if (record["ok"] === true) return {
+				ok: true,
+				snapshot: parseRoleFileSnapshot(record["snapshot"])
+			};
+			if (record["ok"] === false && typeof record["reason"] === "string") return {
+				ok: false,
+				reason: record["reason"]
+			};
+			throw new TypeError("the save result must be ok with a snapshot or refused with a reason");
+		}
+		/** Parse the live catalogue the page offers. */
+		function parseCatalogue(value) {
+			const record = parseRecord(value, "the catalogue");
+			const providers = record["providers"];
+			if (!Array.isArray(providers)) throw new TypeError("the catalogue must carry providers");
+			if (typeof record["truncated"] !== "boolean") throw new TypeError("the catalogue truncated flag must be a boolean");
+			return {
+				providers: providers.map((provider, index) => {
+					const entry = parseRecord(provider, `providers[${index}]`);
+					if (typeof entry["provider"] !== "string" || typeof entry["name"] !== "string") throw new TypeError(`providers[${index}] needs provider and name strings`);
+					const models = entry["models"];
+					if (!Array.isArray(models)) throw new TypeError(`providers[${index}].models must be an array`);
+					return {
+						provider: entry["provider"],
+						name: entry["name"],
+						...typeof entry["error"] === "string" ? { error: entry["error"] } : {},
+						models: models.map((model, modelIndex) => {
+							const item = parseRecord(model, `providers[${index}].models[${modelIndex}]`);
+							if (typeof item["route"] !== "string" || typeof item["id"] !== "string" || typeof item["name"] !== "string") throw new TypeError(`providers[${index}].models[${modelIndex}] needs route, id, and name strings`);
+							const efforts = item["efforts"];
+							if (!Array.isArray(efforts) || efforts.some((effort) => typeof effort !== "string")) throw new TypeError(`providers[${index}].models[${modelIndex}].efforts must be strings`);
+							return {
+								route: item["route"],
+								id: item["id"],
+								name: item["name"],
+								...typeof item["description"] === "string" ? { description: item["description"] } : {},
+								...typeof item["contextWindow"] === "number" ? { contextWindow: item["contextWindow"] } : {},
+								...typeof item["maxTokens"] === "number" ? { maxTokens: item["maxTokens"] } : {},
+								efforts,
+								...typeof item["defaultEffort"] === "string" ? { defaultEffort: item["defaultEffort"] } : {},
+								...typeof item["error"] === "string" ? { error: item["error"] } : {}
+							};
+						})
+					};
+				}),
+				truncated: record["truncated"]
+			};
+		}
+		function directMethod(options) {
+			const descriptor = {
+				id: `${REMOTE_PACKAGE}#${ROLES_SERVICE}/${options.method}`,
+				service: ROLES_SERVICE,
+				namespace: ROLES_SERVICE,
+				method: options.method,
+				invocation: { kind: "direct" },
+				parameters: options.parameters,
+				result: options.result,
+				...options.cancellation === true ? { cancellation: { parameter: "signal" } } : {}
+			};
+			const input = { create() {
+				return { parse(value) {
+					const record = parseRecord(value, "the method input");
+					const parsed = {};
+					for (const item of options.parameters) if (record[item.wire] !== void 0) {
+						const codec = item.codec;
+						parsed[item.wire] = codec.create().parse(record[item.wire]);
+					}
+					return parsed;
+				} };
+			} };
+			return {
+				...descriptor,
+				input: () => input,
+				invoke(remote, named, signal) {
+					const namespace = Reflect.get(remote, ROLES_SERVICE);
+					const values = options.parameters.map((item) => named[item.wire]);
+					if (options.cancellation === true) values.push(signal);
+					return namespace[options.method](...values);
+				}
+			};
+		}
+		const statusMethod = directMethod({
+			method: "status",
+			parameters: [],
+			result: jsonCodec("PstackRoleFileSnapshot", parseRoleFileSnapshot, parseRoleFileSnapshot),
+			invoke: (remote) => remote.pstackRoles.status()
+		});
+		const catalogueMethod = directMethod({
+			method: "catalogue",
+			parameters: [],
+			result: jsonCodec("PstackRoleCatalogue", parseCatalogue, parseCatalogue),
+			cancellation: true,
+			invoke: (remote, _input, signal) => remote.pstackRoles.catalogue(signal)
+		});
+		const saveMethod = directMethod({
+			method: "save",
+			parameters: [parameter("request", "PstackSaveRoleRequest", (value) => {
+				parseSaveRoleRequest(value);
+				return value;
+			})],
+			result: jsonCodec("PstackSaveRoleResult", parseSaveRoleResult, parseSaveRoleResult),
+			cancellation: true,
+			invoke: (remote, request, signal) => remote.pstackRoles.save(request, signal)
+		});
+		/** Mountable contribution the Client passes to `ctx.remote.$mount()`. */
+		const pstackRolesRemote = {
+			package: REMOTE_PACKAGE,
+			descriptors: [
+				statusMethod,
+				catalogueMethod,
+				saveMethod
+			],
+			methods: {
+				[`${ROLES_SERVICE}/status`]: statusMethod,
+				[`${ROLES_SERVICE}/catalogue`]: catalogueMethod,
+				[`${ROLES_SERVICE}/save`]: saveMethod
+			}
+		};
+		// src/internal/optional-plugins.ts
+		/** Group order shared by the page and its tests. */
+		const OPTIONAL_PLUGIN_GROUPS = [
+			"sessions",
+			"verification",
+			"multi-agent"
+		];
+		/** 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
+			},
+			{
+				id: "OPT-03",
+				group: "verification",
+				packages: [
+					"@deepseek-ai/dsh-browser-use",
+					"@deepseek-ai/dsh-experimental-browser-use-stagehand-native",
+					"@deepseek-ai/dsh-experimental-browser-use-playwright-mcp",
+					"@deepseek-ai/dsh-experimental-browser-use-chrome-devtools-mcp"
+				]
+			},
+			{
+				id: "OPT-04",
+				group: "verification",
+				packages: ["@deepseek-ai/dsh-cua-bundle"],
+				bundle: "@deepseek-ai/dsh-cua-bundle"
+			},
+			{
+				id: "OPT-05",
+				group: "verification",
+				packages: ["@deepseek-ai/dsh-experimental-terminal-bundle"],
+				bundle: "@deepseek-ai/dsh-experimental-terminal-bundle"
+			},
+			{
+				id: "OPT-06",
+				group: "sessions",
+				packages: ["@deepseek-ai/dsh-experimental-session-search"],
+				bundle: "@deepseek-ai/dsh-experimental-session-search",
+				recommended: true
+			},
+			{
+				id: "OPT-07",
+				group: "verification",
+				packages: ["@deepseek-ai/dsh-mcp-client"]
+			},
+			{
+				id: "OPT-08",
+				group: "multi-agent",
+				packages: ["@deepseek-ai/dsh-experimental-agent-team-profile"],
+				bundle: "@deepseek-ai/dsh-experimental-agent-team-profile",
+				conflict: true,
+				switchable: false
+			},
+			{
+				id: "OPT-09",
+				group: "multi-agent",
+				packages: ["@deepseek-ai/dsh-experimental-ralph-bundle"],
+				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
+		* section. Keeping status derivation and the one-click sequence here lets the
+		* 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
+		* `remote.ts` hand-writes the role Remote contract.
+		*/
+		/** Read one bundle's display status, including platform and file failures. */
+		function optionalPluginStatus(bundle) {
+			if (bundle === void 0) return "missing";
+			if (bundle.error?.code === "unsupported-platform") return "unsupported-platform";
+			if (bundle.availability === "missing") return "missing";
+			if (bundle.error !== void 0) return "error";
+			return bundle.enabled ? "enabled" : "off";
+		}
+		/** Join the catalogue with the Host's bundle list. */
+		function optionalPluginRows(bundles) {
+			const byName = new Map((bundles ?? []).map((bundle) => [bundle.name, bundle]));
+			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);
+				return {
+					definition,
+					status,
+					enabled: status === "enabled",
+					canToggle: definition.bundle !== void 0 && definition.switchable !== false && (status === "off" || status === "enabled")
+				};
+			});
+		}
+		/** How many default-recommended plugins are not on yet, for activation guidance. */
+		function remainingRecommendedCount(rows) {
+			return rows.filter((row) => row.definition.recommended === true && row.status !== "enabled").length;
+		}
+		/**
+		* Enable the default recommendation one bundle at a time and keep going after
+		* failures so the summary reports every attempted step.
+		*/
+		async function enableRecommendedPlugins(api, rows) {
+			const outcomes = [];
+			let applied = 0;
+			let restartRequired = 0;
+			let failed = 0;
+			let skipped = 0;
+			for (const row of rows) {
+				if (row.definition.recommended !== true || row.definition.bundle === void 0) continue;
+				if (row.status === "enabled") continue;
+				if (row.status !== "off") {
+					skipped += 1;
+					continue;
+				}
+				try {
+					const result = await api.setBundleEnabled(row.definition.bundle, true);
+					outcomes.push({
+						id: row.definition.id,
+						bundle: row.definition.bundle,
+						application: result.application
+					});
+					if (result.application === "applied") applied += 1;
+					else if (result.application === "restart-required") restartRequired += 1;
+					else failed += 1;
+				} catch {
+					outcomes.push({
+						id: row.definition.id,
+						bundle: row.definition.bundle,
+						application: "error"
+					});
+					failed += 1;
+				}
+			}
+			return {
+				applied,
+				restartRequired,
+				failed,
+				skipped,
+				outcomes
+			};
+		}
+		/** The one-time activation guidance marker. */
+		const GUIDANCE_DISMISSED_KEY = "dsh-pstack.recommended-plugins.guidance.v1";
+		/** Browser storage, or undefined outside a browser or when access throws. */
+		function browserStorage() {
+			if (typeof window === "undefined") return void 0;
+			try {
+				return window.localStorage;
+			} catch {
+				return;
+			}
+		}
+		/** Whether the activation guidance was already dismissed in this browser. */
+		function guidanceDismissed(storage) {
+			try {
+				return storage?.getItem(GUIDANCE_DISMISSED_KEY) === "1";
+			} catch {
+				return false;
+			}
+		}
+		/** Remember that the activation guidance must not appear again. */
+		function dismissGuidance(storage) {
+			try {
+				storage?.setItem(GUIDANCE_DISMISSED_KEY, "1");
+			} catch {}
+		}
+		// src/client/OptionalPluginsPage.tsx
+		/**
+		* Recommended optional plugins on the dsh-pstack bundle page, plus the
+		* one-time activation guidance offered after the bundle is switched on.
+		*
+		* The page only reads `pluginManager.listBundles()` when it opens. Every
+		* profile change goes through a button the person pressed.
+		*/
+		const COLOR_TEXT$2 = "var(--dsw-alias-label-primary)";
+		const COLOR_SECONDARY$1 = "var(--dsw-alias-label-secondary)";
+		const COLOR_CAPTION$1 = "var(--dsw-alias-label-caption)";
+		const COLOR_BORDER$1 = "var(--dsw-alias-border-l3)";
+		const COLOR_SURFACE$1 = "var(--dsw-alias-bg-layer-1)";
+		const COLOR_ERROR$1 = "var(--dsw-alias-state-error-primary)";
+		const COLOR_SUCCESS$1 = "var(--dsw-alias-state-success-primary)";
+		const COLOR_WARN$1 = "var(--dsw-alias-state-warn-primary)";
+		const STATUS_KEY = {
+			enabled: "pluginStatusEnabled",
+			off: "pluginStatusOff",
+			missing: "pluginStatusMissing",
+			"unsupported-platform": "pluginStatusUnsupportedPlatform",
+			error: "pluginStatusError"
+		};
+		const GROUP_KEY = {
+			sessions: "groupSessions",
+			verification: "groupVerification",
+			"multi-agent": "groupMultiAgent"
+		};
+		const COPY = {
+			"OPT-01": {
+				title: "opt01Title",
+				detail: "opt01Detail"
+			},
+			"OPT-02": {
+				title: "opt02Title",
+				detail: "opt02Detail"
+			},
+			"OPT-03": {
+				title: "opt03Title",
+				detail: "opt03Detail"
+			},
+			"OPT-04": {
+				title: "opt04Title",
+				detail: "opt04Detail"
+			},
+			"OPT-05": {
+				title: "opt05Title",
+				detail: "opt05Detail"
+			},
+			"OPT-06": {
+				title: "opt06Title",
+				detail: "opt06Detail"
+			},
+			"OPT-07": {
+				title: "opt07Title",
+				detail: "opt07Detail"
+			},
+			"OPT-08": {
+				title: "opt08Title",
+				detail: "opt08Detail"
+			},
+			"OPT-09": {
+				title: "opt09Title",
+				detail: "opt09Detail"
+			}
+		};
+		function statusColor$1(status) {
+			if (status === "enabled") return COLOR_SUCCESS$1;
+			if (status === "error") return COLOR_ERROR$1;
+			if (status === "missing" || status === "unsupported-platform") return COLOR_WARN$1;
+			return COLOR_CAPTION$1;
+		}
+		function buttonStyle$1(primary = false) {
+			return {
+				border: `1px solid ${primary ? "transparent" : COLOR_BORDER$1}`,
+				borderRadius: 8,
+				padding: "5px 12px",
+				cursor: "pointer",
+				font: "inherit",
+				background: primary ? "var(--dsw-alias-brand-primary)" : "transparent",
+				color: primary ? "var(--dsw-alias-label-primary-foreground)" : COLOR_TEXT$2
+			};
+		}
+		function tagStyle(color) {
+			return {
+				border: `1px solid ${color}`,
+				borderRadius: 999,
+				padding: "1px 8px",
+				color,
+				fontSize: 12,
+				whiteSpace: "nowrap"
+			};
+		}
+		/** Whether one row is a package group the plugin manager cannot switch. */
+		function isNonBundleRow(row) {
+			return row.definition.bundle === void 0;
+		}
+		/** Text for one change result. */
+		function changeResultText(application, t, reason) {
+			if (application === "applied") return t("resultApplied");
+			if (application === "restart-required") return t("resultRestartRequired");
+			if (application === "failed" || application === "error") return t("resultFailed", { reason: reason ?? application });
+			if (application === "overridden") return t("resultOverridden");
+			return t("resultCancelled");
+		}
+		function errorText(error) {
+			if (typeof error === "object" && error !== null && "message" in error) return String(error.message);
+			return String(error);
+		}
+		/** 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,
+				style: {
+					display: "grid",
+					gap: 12,
+					padding: "4px 0 18px",
+					color: COLOR_TEXT$2
+				},
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("header", {
+					style: {
+						display: "grid",
+						gap: 6
+					},
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+						style: {
+							margin: 0,
+							fontSize: 16
+						},
+						children: t("optionalPluginsTitle")
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						style: {
+							margin: 0,
+							color: COLOR_SECONDARY$1,
+							fontSize: 13,
+							lineHeight: 1.5
+						},
+						children: t("optionalPluginsSubtitle")
+					})]
+				}), status === "loading" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					style: { color: COLOR_SECONDARY$1 },
+					children: t("optionalLoading")
+				}) : status === "error" ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					style: {
+						display: "flex",
+						gap: 10,
+						alignItems: "center",
+						color: COLOR_ERROR$1
+					},
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("optionalLoadFailed", { message: loadError ?? "" }) }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						type: "button",
+						style: buttonStyle$1(),
+						onClick: onRetry,
+						children: t("optionalRetry")
+					})]
+				}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						style: {
+							display: "flex",
+							gap: 8,
+							alignItems: "center",
+							flexWrap: "wrap"
+						},
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								style: buttonStyle$1(true),
+								onClick: onEnableRecommended,
+								disabled: bulkBusy || offRecommended === 0,
+								children: bulkBusy ? t("enablingRecommended") : t("enableRecommended")
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								style: buttonStyle$1(),
+								onClick: onRetry,
+								disabled: bulkBusy,
+								children: t("optionalRefresh")
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								style: {
+									color: COLOR_CAPTION$1,
+									fontSize: 12
+								},
+								children: t("recommendedHint", { ids: recommendationIds.join(t("listSeparator")) })
+							})
+						]
+					}),
+					summary === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						"data-optional-summary": true,
+						style: {
+							color: COLOR_SECONDARY$1,
+							fontSize: 12
+						},
+						children: summary
+					}),
+					OPTIONAL_PLUGIN_GROUPS.map((group) => {
+						const groupRows = rows.filter((row) => row.definition.group === group);
+						if (groupRows.length === 0) return null;
+						return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+							style: {
+								display: "grid",
+								gap: 8
+							},
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h4", {
+								style: {
+									margin: "6px 0 0",
+									fontSize: 13,
+									color: COLOR_SECONDARY$1
+								},
+								children: t(GROUP_KEY[group])
+							}), groupRows.map((row) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(OptionalPluginCard, {
+								row,
+								busy: busyId === row.definition.id || bulkBusy,
+								message: messages[row.definition.id],
+								onToggle,
+								t
+							}, row.definition.id))]
+						}, group);
+					})
+				] })]
+			});
+		}
+		function OptionalPluginCard(props) {
+			const { row, busy, message, onToggle, t } = props;
+			const { definition } = row;
+			const copy = COPY[definition.id];
+			const nonBundle = isNonBundleRow(row);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("article", {
+				"data-optional-plugin": definition.id,
+				"data-optional-status": row.status,
+				style: {
+					display: "grid",
+					gap: 8,
+					border: `1px solid ${COLOR_BORDER$1}`,
+					borderRadius: 12,
+					padding: 12,
+					background: COLOR_SURFACE$1
+				},
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("header", {
+						style: {
+							display: "flex",
+							gap: 8,
+							alignItems: "baseline",
+							flexWrap: "wrap"
+						},
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("strong", {
+								style: { fontSize: 14 },
+								children: t(copy.title)
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								style: {
+									color: COLOR_CAPTION$1,
+									fontSize: 12
+								},
+								children: definition.id
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								"data-optional-status-label": true,
+								style: tagStyle(statusColor$1(row.status)),
+								children: t(STATUS_KEY[row.status])
+							}),
+							definition.recommended === true ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								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")
+							}) : null
+						]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", {
+						style: {
+							color: COLOR_SECONDARY$1,
+							fontSize: 12,
+							overflowWrap: "anywhere",
+							fontFamily: "var(--dsh-font-family-code)"
+						},
+						children: definition.packages.join(" · ")
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						style: {
+							margin: 0,
+							color: COLOR_SECONDARY$1,
+							fontSize: 12,
+							lineHeight: 1.5
+						},
+						children: t(copy.detail)
+					}),
+					definition.conflict === true ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						role: "alert",
+						style: {
+							margin: 0,
+							color: COLOR_ERROR$1,
+							fontSize: 12,
+							lineHeight: 1.5
+						},
+						children: t("conflictWarning")
+					}) : null,
+					nonBundle ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						style: {
+							margin: 0,
+							color: COLOR_CAPTION$1,
+							fontSize: 12
+						},
+						children: t("nonBundleGuidance")
+					}) : null,
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("footer", {
+						style: {
+							display: "flex",
+							gap: 8,
+							alignItems: "center",
+							flexWrap: "wrap"
+						},
+						children: [
+							row.canToggle ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								style: buttonStyle$1(),
+								disabled: busy,
+								onClick: () => onToggle(definition.id, row.status !== "enabled"),
+								children: row.status === "enabled" ? t("disablePlugin") : t("enablePlugin")
+							}) : null,
+							busy ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								style: {
+									color: COLOR_CAPTION$1,
+									fontSize: 12
+								},
+								children: t("pluginWorking")
+							}) : null,
+							message === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								"data-optional-message": true,
+								style: {
+									color: message.tone === "ok" ? COLOR_SUCCESS$1 : COLOR_ERROR$1,
+									fontSize: 12
+								},
+								children: message.text
+							})
+						]
+					})
+				]
+			});
+		}
+		/** Loads bundle status and owns the recommendation section's two actions. */
+		function OptionalPluginsSection(props) {
+			const { optionalPlugins: api, t } = props;
+			const [bundles, setBundles] = (0, react.useState)(void 0);
+			const [loadError, setLoadError] = (0, react.useState)(void 0);
+			const [status, setStatus] = (0, react.useState)("loading");
+			const [busyId, setBusyId] = (0, react.useState)(void 0);
+			const [bulkBusy, setBulkBusy] = (0, react.useState)(false);
+			const [messages, setMessages] = (0, react.useState)({});
+			const [summary, setSummary] = (0, react.useState)(void 0);
+			const [reloadToken, setReloadToken] = (0, react.useState)(0);
+			(0, react.useEffect)(() => {
+				let cancelled = false;
+				setStatus("loading");
+				setLoadError(void 0);
+				api.listBundles().then((next) => {
+					if (cancelled) return;
+					setBundles(next);
+					setStatus("ready");
+				}, (error) => {
+					if (cancelled) return;
+					setLoadError(errorText(error));
+					setStatus("error");
+				});
+				return () => {
+					cancelled = true;
+				};
+			}, [api, reloadToken]);
+			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;
+				setBusyId(id);
+				setMessages((current) => {
+					const { [id]: _ignored, ...rest } = current;
+					return rest;
+				});
+				api.setBundleEnabled(bundle, enabled).then((result) => {
+					setBusyId(void 0);
+					setMessages((current) => ({
+						...current,
+						[id]: {
+							tone: result.application === "failed" ? "error" : "ok",
+							text: changeResultText(result.application, t, result.error?.diagnostic ?? result.error?.code)
+						}
+					}));
+					reload();
+				}, (error) => {
+					setBusyId(void 0);
+					setMessages((current) => ({
+						...current,
+						[id]: {
+							tone: "error",
+							text: changeResultText("error", t, errorText(error))
+						}
+					}));
+					reload();
+				});
+			};
+			const enableAll = () => {
+				setBulkBusy(true);
+				setSummary(void 0);
+				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)
+					};
+					setMessages(next);
+					setSummary(t("recommendedSummary", {
+						applied: result.applied,
+						restart: result.restartRequired,
+						failed: result.failed,
+						skipped: result.skipped
+					}));
+					setBulkBusy(false);
+					reload();
+				});
+			};
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(OptionalPluginsView, {
+				rows,
+				status,
+				loadError,
+				busyId,
+				bulkBusy,
+				messages,
+				summary,
+				onToggle: toggle,
+				onEnableRecommended: enableAll,
+				onRetry: reload,
+				t
+			});
+		}
+		/** Pure view of the one-time activation guidance. */
+		function OptionalPluginsActivationView(props) {
+			const { count, onOpen, onDismiss, t } = props;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+				"data-optional-activation": true,
+				style: {
+					display: "flex",
+					gap: 10,
+					alignItems: "center",
+					flexWrap: "wrap",
+					border: `1px solid ${COLOR_BORDER$1}`,
+					borderRadius: 12,
+					padding: "10px 12px",
+					background: COLOR_SURFACE$1,
+					color: COLOR_TEXT$2
+				},
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						style: { fontSize: 13 },
+						children: t("guidanceTitle", { count })
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						type: "button",
+						style: buttonStyle$1(true),
+						onClick: onOpen,
+						children: t("guidanceOpen")
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						type: "button",
+						style: buttonStyle$1(),
+						onClick: onDismiss,
+						children: t("guidanceDismiss")
+					})
+				]
+			});
+		}
+		/** One-time guidance shown after dsh-pstack itself is switched on. */
+		function OptionalPluginsActivation(props) {
+			const { optionalPlugins: api, t, onDismiss, onOpenDetails } = props;
+			const [count, setCount] = (0, react.useState)(void 0);
+			(0, react.useEffect)(() => {
+				if (guidanceDismissed(browserStorage())) {
+					setCount(0);
+					return;
+				}
+				let cancelled = false;
+				api.listBundles().then((bundles) => {
+					if (cancelled) return;
+					setCount(remainingRecommendedCount(optionalPluginRows(bundles)));
+				}, () => {
+					if (cancelled) return;
+					setCount(0);
+				});
+				return () => {
+					cancelled = true;
+				};
+			}, [api]);
+			(0, react.useEffect)(() => {
+				if (count !== void 0 && count > 0) dismissGuidance(browserStorage());
+			}, [count]);
+			if (count === void 0 || count === 0) return null;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(OptionalPluginsActivationView, {
+				count,
+				onOpen: () => {
+					dismissGuidance(browserStorage());
+					onOpenDetails();
+				},
+				onDismiss: () => {
+					dismissGuidance(browserStorage());
+					onDismiss();
+				},
+				t
+			});
+		}
+		// src/client/state.ts
+		/** The implicit value of a role absent from the file. */
+		function inheritRoute(alias = "inherit-parent") {
+			return {
+				kind: "inherit",
+				alias
+			};
+		}
+		/** Copy every role into an editable draft, falling back to `inherit-parent`. */
+		function draftsFromSnapshot(snapshot) {
+			const drafts = {};
+			for (const role of snapshot.roles) drafts[role.key] = role.routes.length === 0 ? [inheritRoute()] : role.routes.map((route) => ({ ...route }));
+			return drafts;
+		}
+		/** The exact save payload one card sends. */
+		function saveRequestFor(key, routes) {
+			return {
+				key,
+				routes: routes.map((route) => ({ ...route }))
+			};
+		}
+		/** Display text of one route, matching the role-file grammar. */
+		function formatRoute(route) {
+			if (route.kind === "inherit") return route.alias;
+			return route.effort === void 0 ? `${route.provider}/${route.model}` : `${route.provider}/${route.model} [${route.effort}]`;
+		}
+		/** Replace one route in place. */
+		function replaceRoute(routes, index, route) {
+			return routes.map((current, position) => position === index ? route : current);
+		}
+		/** Append one route, defaulting to `inherit-parent` for a new list entry. */
+		function appendRoute(routes) {
+			return [...routes, inheritRoute()];
+		}
+		/** Remove one route without ever leaving a list role empty. */
+		function removeRoute(routes, index) {
+			if (routes.length <= 1) return [...routes];
+			return routes.filter((_route, position) => position !== index);
+		}
+		/** Provider entries in catalogue order. */
+		function providerChoices(catalogue) {
+			return catalogue?.providers ?? [];
+		}
+		/** The models one provider advertises, or an empty list when the provider is gone. */
+		function modelChoices(catalogue, provider) {
+			return catalogue?.providers.find((entry) => entry.provider === provider)?.models ?? [];
+		}
+		/** One model's declared efforts. */
+		function effortChoices(catalogue, provider, model) {
+			return modelChoices(catalogue, provider).find((entry) => entry.id === model)?.efforts ?? [];
+		}
+		/** Client-side shape check; the Host validates providers and efforts on save. */
+		function draftIssues(role, routes) {
+			if (routes.length === 0) return ["keep at least one route"];
+			if (role.shape === "single" && routes.length !== 1) return ["a single-route role needs exactly one route"];
+			return [];
+		}
+		// src/client/locales.ts
+		const NS$1 = "pstackRoles";
+		/** Source dictionary: its key set is the contract every locale must satisfy. */
+		const base$1 = {
+			title: "Role model configuration",
+			subtitle: "Edit $DSH_HOME/pstack-models.mdc. Saving a role changes only that role.",
+			file: "File",
+			status: "Status",
+			statusMissing: "missing",
+			statusLoaded: "loaded",
+			statusUnreadable: "unreadable",
+			budget: "Budget",
+			fileIssues: "File issues",
+			line: "Line {line}",
+			role: "Role",
+			configuredLine: "line {line}",
+			notConfigured: "not configured",
+			inheritParent: "inherit-parent",
+			auto: "auto",
+			provider: "Provider",
+			unavailable: "unavailable",
+			model: "Model",
+			effort: "Effort",
+			effortUnset: "not set",
+			effortDefault: "default ({effort})",
+			effortBaselineTitle: "Effort adapts to the task",
+			effortBaselineIntro: "This is the starting level. It can move up or down as the task changes in difficulty; it is not fixed.",
+			addRoute: "Add route",
+			removeRoute: "Remove route",
+			save: "Save",
+			saving: "Saving…",
+			saved: "Saved",
+			reset: "Reset",
+			resetting: "Resetting…",
+			loadFailed: "Could not read the role configuration: {message}",
+			retry: "Retry",
+			loading: "Loading role configuration…",
+			unreadableBody: "This file cannot be edited until it becomes readable: {reason}",
+			noCatalogue: "The live model directory is unavailable; provider and model lists are empty.",
+			saveRejected: "Save rejected: {reason}",
+			roleIssues: "Role file issue: {message}",
+			catalogueUnavailable: "Model directory unavailable",
+			truncated: "The model directory was truncated; some providers or models are not listed.",
+			roleFeatureRefactoringName: "Feature & refactoring",
+			roleFeatureRefactoringDescription: "For new features and code refactoring.",
+			roleBugFixName: "Bug fix",
+			roleBugFixDescription: "For diagnosing and fixing defects.",
+			rolePerfIssueName: "Performance",
+			rolePerfIssueDescription: "For investigating and fixing performance issues.",
+			roleHillclimbName: "Hillclimb",
+			roleHillclimbDescription: "For iterative improvements guided by measurable results.",
+			roleJudgmentAndProseName: "Judgment & prose",
+			roleJudgmentAndProseDescription: "For judgment calls, writing, and refining prose.",
+			roleHardestTasksName: "Hardest tasks",
+			roleHardestTasksDescription: "For complex design, concurrency, algorithms, and other difficult tasks.",
+			roleHowExplorerName: "How · explorer",
+			roleHowExplorerDescription: "For exploring code and tracing how a system works.",
+			roleHowExplainerName: "How · explainer",
+			roleHowExplainerDescription: "For explaining architecture and runtime behavior.",
+			roleWhyInvestigatorsName: "Why · investigators",
+			roleWhyInvestigatorsDescription: "For gathering evidence about decisions and their rationale.",
+			roleWhySynthesizerName: "Why · synthesizer",
+			roleWhySynthesizerDescription: "For synthesizing evidence into a cited explanation.",
+			roleReflectToolingName: "Reflect · tooling",
+			roleReflectToolingDescription: "For reviewing tooling lessons from the current session.",
+			roleReflectJudgmentDivergentSynthesizerName: "Reflect · judgment & synthesis",
+			roleReflectJudgmentDivergentSynthesizerDescription: "For reviewing judgments, challenging conclusions, and synthesizing lessons.",
+			roleArenaRunnersName: "Arena · runners",
+			roleArenaRunnersDescription: "For generating competing candidates in parallel.",
+			roleArenaCrossJudgePoolName: "Arena · judges",
+			roleArenaCrossJudgePoolDescription: "For independently comparing Arena candidates.",
+			roleSwarmWorkersName: "Swarm · workers",
+			roleSwarmWorkersDescription: "For parallel implementation and verification tasks.",
+			roleArchitectRunnersName: "Architect · runners",
+			roleArchitectRunnersDescription: "For proposing competing designs before implementation.",
+			roleInterrogateReviewersName: "Interrogate · reviewers",
+			roleInterrogateReviewersDescription: "For adversarial review of changes and designs."
+		};
+		/** Role keys map to the exact locale keys that name and describe them. */
+		const roleCopyKeys = {
+			"feature, refactoring": {
+				name: "roleFeatureRefactoringName",
+				description: "roleFeatureRefactoringDescription"
+			},
+			"bug-fix": {
+				name: "roleBugFixName",
+				description: "roleBugFixDescription"
+			},
+			"perf-issue": {
+				name: "rolePerfIssueName",
+				description: "rolePerfIssueDescription"
+			},
+			hillclimb: {
+				name: "roleHillclimbName",
+				description: "roleHillclimbDescription"
+			},
+			"judgment and prose": {
+				name: "roleJudgmentAndProseName",
+				description: "roleJudgmentAndProseDescription"
+			},
+			"hardest tasks": {
+				name: "roleHardestTasksName",
+				description: "roleHardestTasksDescription"
+			},
+			"how explorer": {
+				name: "roleHowExplorerName",
+				description: "roleHowExplorerDescription"
+			},
+			"how explainer": {
+				name: "roleHowExplainerName",
+				description: "roleHowExplainerDescription"
+			},
+			"why investigators": {
+				name: "roleWhyInvestigatorsName",
+				description: "roleWhyInvestigatorsDescription"
+			},
+			"why synthesizer": {
+				name: "roleWhySynthesizerName",
+				description: "roleWhySynthesizerDescription"
+			},
+			"reflect tooling": {
+				name: "roleReflectToolingName",
+				description: "roleReflectToolingDescription"
+			},
+			"reflect judgment, divergent, synthesizer": {
+				name: "roleReflectJudgmentDivergentSynthesizerName",
+				description: "roleReflectJudgmentDivergentSynthesizerDescription"
+			},
+			"arena runners": {
+				name: "roleArenaRunnersName",
+				description: "roleArenaRunnersDescription"
+			},
+			"arena cross-judge pool": {
+				name: "roleArenaCrossJudgePoolName",
+				description: "roleArenaCrossJudgePoolDescription"
+			},
+			"swarm workers": {
+				name: "roleSwarmWorkersName",
+				description: "roleSwarmWorkersDescription"
+			},
+			"architect runners": {
+				name: "roleArchitectRunnersName",
+				description: "roleArchitectRunnersDescription"
+			},
+			"interrogate reviewers": {
+				name: "roleInterrogateReviewersName",
+				description: "roleInterrogateReviewersDescription"
+			}
+		};
+		/** Complete dictionaries, one entry per supported locale. */
+		const catalogs$1 = {
+			en: base$1,
+			zh: {
+				title: "角色模型配置",
+				subtitle: "编辑 $DSH_HOME/pstack-models.mdc。每次保存只改动你保存的那个角色。",
+				file: "文件",
+				status: "状态",
+				statusMissing: "缺失",
+				statusLoaded: "已加载",
+				statusUnreadable: "不可读",
+				budget: "预算",
+				fileIssues: "文件问题",
+				line: "第 {line} 行",
+				role: "角色",
+				configuredLine: "第 {line} 行",
+				notConfigured: "未配置",
+				inheritParent: "继承父级",
+				auto: "自动",
+				provider: "提供方",
+				unavailable: "不可用",
+				model: "模型",
+				effort: "推理强度",
+				effortUnset: "未指定",
+				effortDefault: "默认（{effort}）",
+				effortBaselineTitle: "推理强度随任务难度调整",
+				effortBaselineIntro: "这里选择的是起步值，实际强度会根据任务难度上下浮动，不是固定值。",
+				addRoute: "添加路由",
+				removeRoute: "删除路由",
+				save: "保存",
+				saving: "保存中…",
+				saved: "已保存",
+				reset: "重置",
+				resetting: "重置中…",
+				loadFailed: "无法读取角色配置：{message}",
+				retry: "重试",
+				loading: "正在读取角色配置…",
+				unreadableBody: "文件可读之前无法编辑：{reason}",
+				noCatalogue: "实时模型目录不可用，提供方与模型列表为空。",
+				saveRejected: "保存被拒绝：{reason}",
+				roleIssues: "角色文件问题：{message}",
+				catalogueUnavailable: "模型目录不可用",
+				truncated: "模型目录已截断；部分提供方或模型未显示。",
+				roleFeatureRefactoringName: "功能开发与重构",
+				roleFeatureRefactoringDescription: "用于新功能开发和代码重构。",
+				roleBugFixName: "缺陷修复",
+				roleBugFixDescription: "用于定位并修复缺陷。",
+				rolePerfIssueName: "性能优化",
+				rolePerfIssueDescription: "用于排查并解决性能问题。",
+				roleHillclimbName: "迭代优化",
+				roleHillclimbDescription: "用于根据可量化的结果持续改进。",
+				roleJudgmentAndProseName: "判断与文字",
+				roleJudgmentAndProseDescription: "用于需要判断、写作或润色的任务。",
+				roleHardestTasksName: "高难度任务",
+				roleHardestTasksDescription: "用于复杂设计、并发、算法等高难度任务。",
+				roleHowExplorerName: "How · 代码探索",
+				roleHowExplorerDescription: "用于探索代码，梳理系统的工作方式。",
+				roleHowExplainerName: "How · 原理讲解",
+				roleHowExplainerDescription: "用于解释架构和运行流程。",
+				roleWhyInvestigatorsName: "Why · 证据调查",
+				roleWhyInvestigatorsDescription: "用于调查决策依据并收集证据。",
+				roleWhySynthesizerName: "Why · 证据综合",
+				roleWhySynthesizerDescription: "用于综合证据，形成有出处的解释。",
+				roleReflectToolingName: "Reflect · 工具复盘",
+				roleReflectToolingDescription: "用于复盘当前会话中的工具使用经验。",
+				roleReflectJudgmentDivergentSynthesizerName: "Reflect · 判断与综合",
+				roleReflectJudgmentDivergentSynthesizerDescription: "用于复盘判断、挑战结论并综合经验。",
+				roleArenaRunnersName: "Arena · 候选方案",
+				roleArenaRunnersDescription: "用于并行生成相互竞争的候选方案。",
+				roleArenaCrossJudgePoolName: "Arena · 交叉评审",
+				roleArenaCrossJudgePoolDescription: "用于独立比较 Arena 的候选方案。",
+				roleSwarmWorkersName: "Swarm · 并行执行",
+				roleSwarmWorkersDescription: "用于并行执行实现和验证任务。",
+				roleArchitectRunnersName: "Architect · 方案设计",
+				roleArchitectRunnersDescription: "用于在实现前并行提出候选设计。",
+				roleInterrogateReviewersName: "Interrogate · 对抗评审",
+				roleInterrogateReviewersDescription: "用于对改动或设计进行对抗性评审。"
+			}
+		};
+		/** Localized role name and usage, keyed by the exact role-file key. */
+		function rolePresentation(key, t) {
+			const copy = roleCopyKeys[key];
+			return {
+				name: t(copy.name),
+				description: t(copy.description)
+			};
+		}
+		// src/client/RoleSettingsPage.tsx
+		/** Role configuration section inside the bundle configuration dialog for `$DSH_HOME/pstack-models.mdc`. */
+		const COLOR_TEXT$1 = "var(--dsw-alias-label-primary)";
+		const COLOR_SECONDARY = "var(--dsw-alias-label-secondary)";
+		const COLOR_CAPTION = "var(--dsw-alias-label-caption)";
+		const COLOR_BORDER = "var(--dsw-alias-border-l3)";
+		const COLOR_SURFACE = "var(--dsw-alias-bg-layer-1)";
+		const COLOR_ERROR = "var(--dsw-alias-state-error-primary)";
+		const COLOR_SUCCESS = "var(--dsw-alias-state-success-primary)";
+		const COLOR_WARN = "var(--dsw-alias-state-warn-primary)";
+		const FONT_CODE = "var(--dsh-font-family-code)";
+		function statusColor(status) {
+			if (status === "loaded") return COLOR_SUCCESS;
+			if (status === "unreadable") return COLOR_ERROR;
+			return COLOR_WARN;
+		}
+		function buttonStyle(primary = false) {
+			return {
+				border: `1px solid ${primary ? "transparent" : COLOR_BORDER}`,
+				borderRadius: 8,
+				padding: "5px 12px",
+				cursor: "pointer",
+				font: "inherit",
+				background: primary ? "var(--dsw-alias-brand-primary)" : "transparent",
+				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`,
+				width: fullWidth ? "100%" : 0,
+				minWidth: 0,
+				height: 34,
+				padding: "5px 8px",
+				boxSizing: "border-box",
+				border: `1px solid ${COLOR_BORDER}`,
+				borderRadius: 8,
+				background: COLOR_SURFACE,
+				color: COLOR_TEXT$1,
+				font: "inherit",
+				lineHeight: "22px",
+				textOverflow: "ellipsis"
+			};
+		}
+		function statusLabel(t, status) {
+			if (status === "loaded") return t("statusLoaded");
+			if (status === "unreadable") return t("statusUnreadable");
+			return t("statusMissing");
+		}
+		function routeSelection(route) {
+			return route.kind === "inherit" ? `__inherit__:${route.alias}` : route.provider;
+		}
+		function fromSelection(selection) {
+			if (selection === "__inherit__:inherit-parent") return inheritRoute("inherit-parent");
+			if (selection === "__inherit__:auto") return inheritRoute("auto");
+			return {
+				kind: "route",
+				provider: selection,
+				model: ""
+			};
+		}
+		function RoleRouteRow(props) {
+			const { role, index, route, routes, catalogue, readOnly, onChange, onRemove, t } = props;
+			const providers = providerChoices(catalogue);
+			const models = route.kind === "route" ? modelChoices(catalogue, route.provider) : [];
+			const efforts = route.kind === "route" ? effortChoices(catalogue, route.provider, route.model) : [];
+			const providerMissing = route.kind === "route" && !providers.some((entry) => entry.provider === route.provider);
+			const modelMissing = route.kind === "route" && !models.some((entry) => entry.id === route.model) && route.model !== "";
+			const effortMissing = route.kind === "route" && route.effort !== void 0 && route.effort !== "" && !efforts.includes(route.effort);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				style: {
+					display: "grid",
+					gap: 8
+				},
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
+						"aria-label": `${role.key} ${t("provider")}`,
+						value: routeSelection(route),
+						disabled: readOnly,
+						onChange: (event) => {
+							const next = fromSelection(event.target.value);
+							if (next.kind === "route") {
+								const firstModel = modelChoices(catalogue, next.provider)[0];
+								return onChange(index, {
+									...next,
+									model: firstModel?.id ?? "",
+									...firstModel?.defaultEffort === void 0 ? {} : { effort: firstModel.defaultEffort }
+								});
+							}
+							onChange(index, next);
+						},
+						style: fieldStyle(0, true),
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+								value: "__inherit__:inherit-parent",
+								children: t("inheritParent")
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+								value: "__inherit__:auto",
+								children: t("auto")
+							}),
+							providers.map((provider) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+								value: provider.provider,
+								children: provider.name === provider.provider ? provider.provider : `${provider.name} (${provider.provider})`
+							}, provider.provider)),
+							providerMissing ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+								value: route.provider,
+								children: `${route.provider} (${t("unavailable")})`
+							}) : null
+						]
+					}),
+					route.kind === "route" ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						style: {
+							display: "flex",
+							gap: 8,
+							alignItems: "center",
+							flexWrap: "wrap"
+						},
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
+							"aria-label": `${role.key} ${t("model")}`,
+							value: route.model,
+							disabled: readOnly,
+							onChange: (event) => {
+								const model = event.target.value;
+								const entry = models.find((candidate) => candidate.id === model);
+								onChange(index, {
+									kind: "route",
+									provider: route.provider,
+									model,
+									...entry?.defaultEffort === void 0 ? {} : { effort: entry.defaultEffort }
+								});
+							},
+							style: fieldStyle(220),
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+									value: "",
+									disabled: true,
+									children: t("model")
+								}),
+								models.map((model) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+									value: model.id,
+									children: model.id
+								}, model.id)),
+								modelMissing ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+									value: route.model,
+									children: route.model
+								}) : null
+							]
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
+							"aria-label": `${role.key} ${t("effort")}`,
+							value: route.effort ?? "",
+							disabled: readOnly,
+							onChange: (event) => {
+								const effort = event.target.value;
+								onChange(index, {
+									kind: "route",
+									provider: route.provider,
+									model: route.model,
+									...effort === "" ? {} : { effort }
+								});
+							},
+							style: fieldStyle(140),
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+									value: "",
+									children: t("effortUnset")
+								}),
+								efforts.map((effort) => {
+									const defaultEffort = models.find((candidate) => candidate.id === route.model)?.defaultEffort === effort;
+									return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+										value: effort,
+										children: defaultEffort ? t("effortDefault", { effort }) : effort
+									}, effort);
+								}),
+								effortMissing ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+									value: route.effort,
+									children: route.effort
+								}) : null
+							]
+						})]
+					}) : null,
+					routes.length > 1 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						type: "button",
+						style: {
+							...dangerButtonStyle(),
+							justifySelf: "start"
+						},
+						onClick: () => onRemove(index),
+						disabled: readOnly,
+						children: t("removeRoute")
+					}) : null
+				]
+			});
+		}
+		function RoleCard(props) {
+			const { role, routes, catalogue, busy, readOnly, message, onRouteChange, onAddRoute, onRemoveRoute, onSave, onReset, t } = props;
+			const issues = draftIssues(role, routes);
+			const roleText = rolePresentation(role.key, t);
+			const canReset = routes.length !== 1 || routes[0]?.kind !== "inherit" || routes[0]?.alias !== "inherit-parent";
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+				style: {
+					border: `1px solid ${COLOR_BORDER}`,
+					borderRadius: 12,
+					padding: 14,
+					display: "grid",
+					gap: 10,
+					background: COLOR_SURFACE
+				},
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("header", {
+						style: {
+							display: "grid",
+							gap: 5
+						},
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							style: {
+								display: "flex",
+								gap: 10,
+								alignItems: "baseline",
+								flexWrap: "wrap"
+							},
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("strong", {
+									style: {
+										color: COLOR_TEXT$1,
+										fontSize: 14
+									},
+									children: roleText.name
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", {
+									style: {
+										color: COLOR_CAPTION,
+										fontFamily: FONT_CODE,
+										fontSize: 11
+									},
+									children: role.key
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									style: {
+										color: COLOR_CAPTION,
+										fontSize: 12
+									},
+									children: role.configured ? t("configuredLine", { line: role.line ?? "?" }) : t("notConfigured")
+								})
+							]
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+							style: {
+								margin: 0,
+								color: COLOR_SECONDARY,
+								fontSize: 12,
+								lineHeight: 1.5
+							},
+							children: roleText.description
+						})]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", {
+						style: {
+							color: COLOR_SECONDARY,
+							fontFamily: FONT_CODE,
+							fontSize: 12
+						},
+						children: readOnly ? t("statusUnreadable") : routes.map((route) => formatRoute(route)).join(" · ")
+					}),
+					role.issues.map((issue, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						style: {
+							color: COLOR_ERROR,
+							fontSize: 12
+						},
+						children: t("roleIssues", { message: issue })
+					}, `${issue}-${index}`)),
+					readOnly ? null : routes.map((route, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RoleRouteRow, {
+						role,
+						index,
+						route,
+						routes,
+						catalogue,
+						readOnly,
+						onChange: onRouteChange,
+						onRemove: onRemoveRoute,
+						t
+					}, index)),
+					issues.map((issue, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						style: {
+							color: COLOR_ERROR,
+							fontSize: 12
+						},
+						children: issue
+					}, `${issue}-${index}`)),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("footer", {
+						style: {
+							display: "flex",
+							gap: 8,
+							alignItems: "center",
+							flexWrap: "wrap"
+						},
+						children: [
+							role.shape === "list" && !readOnly ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								style: buttonStyle(),
+								onClick: onAddRoute,
+								disabled: busy,
+								children: t("addRoute")
+							}) : null,
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								style: buttonStyle(true),
+								onClick: onSave,
+								disabled: readOnly || busy || issues.length > 0,
+								children: busy ? t("saving") : t("save")
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								style: buttonStyle(),
+								onClick: onReset,
+								disabled: readOnly || busy || !canReset,
+								children: busy ? t("resetting") : t("reset")
+							}),
+							message === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								style: {
+									color: message.tone === "ok" ? COLOR_SUCCESS : COLOR_ERROR,
+									fontSize: 12
+								},
+								children: message.text
+							})
+						]
+					})
+				]
+			});
+		}
+		function RoleEffortNote({ t }) {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+				style: {
+					border: `1px solid ${COLOR_BORDER}`,
+					borderRadius: 12,
+					padding: "12px 14px",
+					display: "grid",
+					gap: 6,
+					background: COLOR_SURFACE,
+					color: COLOR_SECONDARY,
+					fontSize: 12,
+					lineHeight: 1.5
+				},
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("strong", {
+					style: {
+						color: COLOR_TEXT$1,
+						fontSize: 13
+					},
+					children: t("effortBaselineTitle")
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					style: { margin: 0 },
+					children: t("effortBaselineIntro")
+				})]
+			});
+		}
+		/** Pure view: all rendering decisions are explicit props. */
+		function RoleSettingsView(props) {
+			const { snapshot, catalogue, drafts, busyKey, messages, loadError, onRetry, t } = props;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				style: {
+					display: "grid",
+					gap: 16,
+					padding: "4px 0 20px",
+					color: COLOR_TEXT$1
+				},
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("header", {
+						style: {
+							display: "grid",
+							gap: 6
+						},
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+							style: {
+								margin: 0,
+								fontSize: 16
+							},
+							children: t("title")
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+							style: {
+								margin: 0,
+								color: COLOR_SECONDARY,
+								fontSize: 13,
+								lineHeight: 1.5
+							},
+							children: t("subtitle")
+						})]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(RoleEffortNote, { t }),
+					snapshot === null ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						style: {
+							display: "flex",
+							gap: 10,
+							alignItems: "center",
+							color: COLOR_SECONDARY
+						},
+						children: [loadError === void 0 ? t("loading") : t("loadFailed", { message: loadError }), loadError === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+							type: "button",
+							style: buttonStyle(),
+							onClick: onRetry,
+							children: t("retry")
+						})]
+					}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+							style: {
+								border: `1px solid ${COLOR_BORDER}`,
+								borderRadius: 12,
+								padding: 14,
+								display: "grid",
+								gap: 6,
+								background: COLOR_SURFACE
+							},
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									style: {
+										display: "flex",
+										gap: 8,
+										alignItems: "baseline",
+										flexWrap: "wrap"
+									},
+									children: [
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+											style: {
+												fontSize: 12,
+												color: COLOR_CAPTION
+											},
+											children: t("file")
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", {
+											style: {
+												fontFamily: FONT_CODE,
+												fontSize: 12,
+												overflowWrap: "anywhere"
+											},
+											children: snapshot.path
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+											style: {
+												fontSize: 12,
+												padding: "1px 8px",
+												borderRadius: 999,
+												border: `1px solid ${statusColor(snapshot.status)}`,
+												color: statusColor(snapshot.status)
+											},
+											children: statusLabel(t, snapshot.status)
+										})
+									]
+								}),
+								snapshot.budget === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									style: {
+										fontSize: 12,
+										color: COLOR_SECONDARY
+									},
+									children: [
+										t("budget"),
+										": ",
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", {
+											style: { fontFamily: FONT_CODE },
+											children: snapshot.budget
+										})
+									]
+								}),
+								snapshot.status === "unreadable" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									style: {
+										fontSize: 12,
+										color: COLOR_ERROR
+									},
+									children: t("unreadableBody", { reason: snapshot.reason ?? "" })
+								}) : null
+							]
+						}),
+						snapshot.issues.length === 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+							style: {
+								display: "grid",
+								gap: 4
+							},
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("strong", {
+								style: { fontSize: 13 },
+								children: t("fileIssues")
+							}), snapshot.issues.map((issue, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								style: {
+									color: COLOR_ERROR,
+									fontSize: 12
+								},
+								children: issue.line === void 0 ? issue.message : `${t("line", { line: issue.line })}: ${issue.message}`
+							}, `${issue.message}-${index}`))]
+						}),
+						catalogue === void 0 || catalogue.providers.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							style: {
+								color: COLOR_WARN,
+								fontSize: 12
+							},
+							children: t("noCatalogue")
+						}) : catalogue.truncated ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							style: {
+								color: COLOR_CAPTION,
+								fontSize: 12
+							},
+							children: t("truncated")
+						}) : null,
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							style: {
+								display: "grid",
+								gap: 10
+							},
+							children: snapshot.roles.map((role) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RoleCard, {
+								role,
+								routes: drafts[role.key] ?? [inheritRoute()],
+								catalogue,
+								busy: busyKey === role.key,
+								readOnly: !snapshot.canSave,
+								message: messages[role.key],
+								onRouteChange: (index, route) => props.onRouteChange(role.key, index, route),
+								onAddRoute: () => props.onAddRoute(role.key),
+								onRemoveRoute: (index) => props.onRemoveRoute(role.key, index),
+								onSave: () => props.onSave(role.key),
+								onReset: () => props.onReset(role.key),
+								t
+							}, role.key))
+						})
+					] })
+				]
+			});
+		}
+		function remoteError(error) {
+			if (typeof error === "object" && error !== null && "message" in error) return String(error.message);
+			return String(error);
+		}
+		/** Section container: owns loading, drafts, and the two Remote calls. */
+		function RoleSettingsPage(props) {
+			const { api, t } = props;
+			const [snapshot, setSnapshot] = (0, react.useState)(null);
+			const [catalogue, setCatalogue] = (0, react.useState)(void 0);
+			const [drafts, setDrafts] = (0, react.useState)({});
+			const [messages, setMessages] = (0, react.useState)({});
+			const [busyKey, setBusyKey] = (0, react.useState)(void 0);
+			const [loadError, setLoadError] = (0, react.useState)(void 0);
+			const [reloadToken, setReloadToken] = (0, react.useState)(0);
+			(0, react.useEffect)(() => {
+				let cancelled = false;
+				setLoadError(void 0);
+				Promise.all([api.status(), api.catalogue()]).then(([nextSnapshot, nextCatalogue]) => {
+					if (cancelled) return;
+					setSnapshot(nextSnapshot);
+					setCatalogue(nextCatalogue);
+					setDrafts(draftsFromSnapshot(nextSnapshot));
+				}, (error) => {
+					if (cancelled) return;
+					setLoadError(remoteError(error));
+				});
+				return () => {
+					cancelled = true;
+				};
+			}, [api, reloadToken]);
+			const updateRole = (key, next) => {
+				setDrafts((current) => ({
+					...current,
+					[key]: next
+				}));
+				setMessages((current) => {
+					const { [key]: _ignored, ...rest } = current;
+					return rest;
+				});
+			};
+			const save = (key, routes) => {
+				setBusyKey(key);
+				setMessages((current) => {
+					const { [key]: _ignored, ...rest } = current;
+					return rest;
+				});
+				api.save(saveRequestFor(key, routes)).then((result) => {
+					setBusyKey(void 0);
+					if (!result.ok) {
+						setMessages((current) => ({
+							...current,
+							[key]: {
+								tone: "error",
+								text: t("saveRejected", { reason: result.reason })
+							}
+						}));
+						return;
+					}
+					setSnapshot(result.snapshot);
+					setDrafts((current) => ({
+						...current,
+						[key]: draftsFromSnapshot(result.snapshot)[key] ?? [inheritRoute()]
+					}));
+					setMessages((current) => ({
+						...current,
+						[key]: {
+							tone: "ok",
+							text: t("saved")
+						}
+					}));
+				}, (error) => {
+					setBusyKey(void 0);
+					setMessages((current) => ({
+						...current,
+						[key]: {
+							tone: "error",
+							text: t("saveRejected", { reason: remoteError(error) })
+						}
+					}));
+				});
+			};
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RoleSettingsView, {
+				snapshot,
+				catalogue,
+				drafts,
+				busyKey,
+				messages,
+				loadError,
+				onRetry: () => setReloadToken((value) => value + 1),
+				onRouteChange: (key, index, route) => {
+					const current = drafts[key] ?? [inheritRoute()];
+					updateRole(key, replaceRoute(current, index, route));
+				},
+				onAddRoute: (key) => updateRole(key, appendRoute(drafts[key] ?? [inheritRoute()])),
+				onRemoveRoute: (key, index) => updateRole(key, removeRoute(drafts[key] ?? [inheritRoute()], index)),
+				onSave: (key) => save(key, drafts[key] ?? [inheritRoute()]),
+				onReset: (key) => save(key, [inheritRoute()]),
+				t
+			});
+		}
+		// src/client/PstackBundleConfigDialog.tsx
+		/**
+		* Configure action and Settings-style dialog for the dsh-pstack bundle detail
+		* page.
+		*
+		* The bundle's configuration used to render inline on the detail page. It now
+		* opens from the detail page header through `plugins.detail.actions`: the
+		* action renders only for the dsh-pstack bundle, and the dialog keeps the
+		* plugin manager's page untouched while it is open.
+		*/
+		const COLOR_TEXT = "var(--dsw-alias-label-primary)";
+		const overlayStyle = {
+			position: "fixed",
+			inset: 0,
+			zIndex: 1e3,
+			display: "flex",
+			alignItems: "center",
+			justifyContent: "center"
+		};
+		const maskStyle = {
+			position: "absolute",
+			inset: 0,
+			background: "var(--dsw-alias-bg-mask-1)",
+			backdropFilter: "var(--dsw-mask-blur)"
+		};
+		const panelStyle = {
+			position: "relative",
+			zIndex: 1,
+			display: "grid",
+			gridTemplateColumns: "204px minmax(0, 1fr)",
+			gridTemplateRows: "auto minmax(0, 1fr)",
+			gridTemplateAreas: "'title header' 'nav options'",
+			width: 800,
+			height: "min(800px, calc(100vh - 48px))",
+			maxWidth: "calc(100vw - 48px)",
+			borderRadius: "var(--dsw-radius-panel)",
+			overflow: "hidden",
+			background: "var(--dsw-alias-bg-layer-2)",
+			boxShadow: "var(--dsw-elevation-prominent)",
+			color: COLOR_TEXT
+		};
+		const navTitleStyle = {
+			gridArea: "title",
+			padding: "22px 12px 8px 24px",
+			fontSize: 16,
+			lineHeight: "24px",
+			fontWeight: 500,
+			color: COLOR_TEXT
+		};
+		const navStyle = {
+			gridArea: "nav",
+			minWidth: 0,
+			minHeight: 0,
+			display: "flex",
+			flexDirection: "column",
+			padding: "10px 12px 0",
+			boxSizing: "border-box"
+		};
+		const navListStyle = {
+			display: "flex",
+			flexDirection: "column",
+			gap: 4,
+			minHeight: 0,
+			overflowY: "auto"
+		};
+		const navLabelStyle = {
+			flex: 1,
+			minWidth: 0,
+			overflow: "hidden",
+			whiteSpace: "nowrap",
+			textOverflow: "ellipsis"
+		};
+		const headerStyle = {
+			gridArea: "header",
+			display: "flex",
+			alignItems: "flex-start",
+			justifyContent: "flex-end",
+			height: 54,
+			padding: "20px 14px 8px 10px",
+			boxSizing: "border-box"
+		};
+		const closeStyle = {
+			display: "inline-flex",
+			alignItems: "center",
+			justifyContent: "center",
+			width: 28,
+			height: 28,
+			padding: 0,
+			border: "none",
+			borderRadius: "var(--dsw-radius-sm)",
+			background: "transparent",
+			cursor: "pointer",
+			color: COLOR_TEXT
+		};
+		const optionsStyle = {
+			gridArea: "options",
+			minWidth: 0,
+			minHeight: 0,
+			padding: "0 24px 24px",
+			overflowY: "auto"
+		};
+		function actionButtonStyle() {
+			return {
+				display: "inline-flex",
+				alignItems: "center",
+				gap: 6,
+				height: 28,
+				padding: "0 12px",
+				border: "0.5px solid transparent",
+				borderRadius: "var(--dsw-radius-sm)",
+				boxShadow: "inset 0 0 0 var(--dsh-hairline-width, 0.5px) var(--dsw-alias-border-l3)",
+				background: "transparent",
+				color: COLOR_TEXT,
+				cursor: "pointer",
+				font: "inherit",
+				fontSize: 12,
+				lineHeight: "18px",
+				whiteSpace: "nowrap"
+			};
+		}
+		function navCellStyle(active) {
+			return {
+				display: "flex",
+				alignItems: "center",
+				gap: 8,
+				height: 40,
+				padding: "9px 16px 9px 12px",
+				boxSizing: "border-box",
+				border: "none",
+				borderRadius: "var(--dsw-radius-md)",
+				background: active ? "var(--dsw-specific-sidebar-nav-item-active)" : "transparent",
+				cursor: "pointer",
+				fontFamily: "inherit",
+				fontSize: 14,
+				lineHeight: "22px",
+				fontWeight: 400,
+				color: COLOR_TEXT,
+				textAlign: "left"
+			};
+		}
+		/** Header action that opens the configuration dialog for the dsh-pstack bundle only. */
+		function PstackBundleConfigAction(props) {
+			const [open, setOpen] = (0, react.useState)(false);
+			if (props.subject.kind !== "bundle" || props.subject.pkg.name !== "dsh-pstack") return null;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(PstackConfigureButton, {
+				t: props.t,
+				onClick: () => setOpen(true)
+			}), open ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(PstackBundleConfigDialog, {
+				api: props.api,
+				optionalPlugins: props.optionalPlugins,
+				rolesT: props.rolesT,
+				pluginsT: props.t,
+				onClose: () => setOpen(false)
+			}) : null] });
+		}
+		function GearIcon() {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("svg", {
+				width: "14",
+				height: "14",
+				viewBox: "0 0 24 24",
+				fill: "none",
+				stroke: "currentColor",
+				strokeWidth: "1.8",
+				strokeLinecap: "round",
+				strokeLinejoin: "round",
+				"aria-hidden": "true",
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("circle", {
+					cx: "12",
+					cy: "12",
+					r: "3"
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 1 1-2.83 2.83l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-4 0v-.09a1.65 1.65 0 0 0-1-1.51 1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 1 1-2.83-2.83l.06-.06a1.65 1.65 0 0 0 .33-1.82 1.65 1.65 0 0 0-1.51-1H3a2 2 0 0 1 0-4h.09a1.65 1.65 0 0 0 1.51-1 1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 1 1 2.83-2.83l.06.06a1.65 1.65 0 0 0 1.82.33h.09a1.65 1.65 0 0 0 1-1.51V3a2 2 0 0 1 4 0v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 1 1 2.83 2.83l-.06.06a1.65 1.65 0 0 0-.33 1.82v.09a1.65 1.65 0 0 0 1.51 1H21a2 2 0 0 1 0 4h-.09a1.65 1.65 0 0 0-1.51 1z" })]
+			});
+		}
+		/** Small outlined button that opens the dialog. */
+		function PstackConfigureButton(props) {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+				type: "button",
+				"data-pstack-configure-action": true,
+				style: actionButtonStyle(),
+				onClick: props.onClick,
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(GearIcon, {}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: props.t("configureAction") })]
+			});
+		}
+		/** Portaled container: owns the active section and the Escape key. */
+		function PstackBundleConfigDialog(props) {
+			const [active, setActive] = (0, react.useState)("plugins");
+			const { onClose } = props;
+			(0, react.useEffect)(() => {
+				const onKeyDown = (event) => {
+					if (event.key === "Escape") onClose();
+				};
+				document.addEventListener("keydown", onKeyDown);
+				return () => document.removeEventListener("keydown", onKeyDown);
+			}, [onClose]);
+			return (0, react_dom.createPortal)(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(PstackBundleConfigDialogView, {
+				...props,
+				active,
+				onSelect: (section) => setActive(section)
+			}), document.body);
+		}
+		function CloseIcon() {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
+				width: "14",
+				height: "14",
+				viewBox: "0 0 14 14",
+				"aria-hidden": "true",
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", {
+					d: "M2 2l10 10M12 2L2 12",
+					stroke: "currentColor",
+					strokeWidth: "1.5",
+					strokeLinecap: "round"
+				})
+			});
+		}
+		/** Pure view of the Settings-style modal: mask, centered card, nav rail, and section body. */
+		function PstackBundleConfigDialogView(props) {
+			const { active, onSelect, onClose, api, optionalPlugins, rolesT, pluginsT } = props;
+			const titleId = (0, react.useId)();
+			const sections = [{
+				id: "plugins",
+				label: pluginsT("configurePluginsSection")
+			}, {
+				id: "roles",
+				label: pluginsT("configureRolesSection")
+			}];
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				style: overlayStyle,
+				role: "presentation",
+				"data-pstack-config-dialog": true,
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					style: maskStyle,
+					"aria-hidden": "true",
+					onClick: onClose
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					role: "dialog",
+					"aria-modal": "true",
+					"aria-labelledby": titleId,
+					style: panelStyle,
+					children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							id: titleId,
+							style: navTitleStyle,
+							children: pluginsT("configureTitle")
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("nav", {
+							"aria-label": pluginsT("configureSections"),
+							style: navStyle,
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								style: navListStyle,
+								children: sections.map((section) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									style: navCellStyle(section.id === active),
+									"aria-current": section.id === active ? "true" : void 0,
+									autoFocus: section.id === active,
+									"data-pstack-config-section-tab": section.id,
+									onClick: () => onSelect(section.id),
+									children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										style: navLabelStyle,
+										children: section.label
+									})
+								}, section.id))
+							})
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							style: headerStyle,
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								"aria-label": pluginsT("configureClose"),
+								style: closeStyle,
+								onClick: onClose,
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CloseIcon, {})
+							})
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							style: optionsStyle,
+							"data-pstack-config-section": active,
+							children: active === "plugins" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(OptionalPluginsSection, {
+								optionalPlugins,
+								t: pluginsT
+							}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RoleSettingsPage, {
+								api,
+								t: rolesT
+							})
+						})
+					]
+				})]
+			});
+		}
+		// src/client/optional-plugins-locales.ts
+		const NS = "pstackPlugins";
+		/** Complete dictionaries, one entry per supported locale. */
+		const catalogs = {
+			en: {
+				configureAction: "Configure",
+				configureTitle: "Configure dsh-pstack",
+				configureSections: "Configuration sections",
+				configurePluginsSection: "Recommended plugins",
+				configureRolesSection: "Role configuration",
+				configureClose: "Close",
+				optionalPluginsTitle: "Recommended plugins",
+				optionalPluginsSubtitle: "Optional DSH plugins that complete pstack flows. Nothing is enabled automatically; turn on only what you need.",
+				groupSessions: "Sessions and isolation",
+				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}",
+				optionalRetry: "Retry",
+				optionalRefresh: "Refresh",
+				enableRecommended: "Enable recommended plugins",
+				enablingRecommended: "Enabling recommended plugins…",
+				recommendedSummary: "{applied} applied, {restart} need a restart, {failed} failed, {skipped} skipped",
+				recommendedHint: "Default recommendations: {ids}.",
+				listSeparator: ", ",
+				enablePlugin: "Enable",
+				disablePlugin: "Disable",
+				pluginWorking: "Working…",
+				pluginStatusEnabled: "enabled",
+				pluginStatusOff: "off",
+				pluginStatusMissing: "missing",
+				pluginStatusUnsupportedPlatform: "unsupported-platform",
+				pluginStatusError: "error",
+				resultApplied: "Applied",
+				resultRestartRequired: "Restart required",
+				resultFailed: "Failed: {reason}",
+				resultOverridden: "Overridden by a higher layer",
+				resultCancelled: "Cancelled",
+				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.",
+				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.",
+				opt03Title: "Browser verification",
+				opt03Detail: "Browser navigation, input, screenshots, and ARIA snapshots; pick one provider and a supported model.",
+				opt04Title: "Computer use",
+				opt04Detail: "macOS desktop clicking, typing, screenshots, and permission pages in a PTC Session.",
+				opt05Title: "Persistent terminal",
+				opt05Detail: "Six global terminal tools keep a shell or REPL alive across calls for CLI and TUI verification.",
+				opt06Title: "Session search",
+				opt06Detail: "Five read-only tools search and trace earlier Sessions with the same cwd.",
+				opt07Title: "MCP client",
+				opt07Detail: "Mounts MCP servers as mcp__<server>__<tool> for /why and /teach evidence work.",
+				opt08Title: "Agent Teams",
+				opt08Detail: "Lead and teammate roles, a shared task board, and nine team tools; conflicts with pstack_subagent.",
+				opt09Title: "Ralph loop",
+				opt09Detail: "A foreground ralph loop starts a fresh child each round for /autonomous-run."
+			},
+			zh: {
+				configureAction: "配置",
+				configureTitle: "配置 dsh-pstack",
+				configureSections: "配置分区",
+				configurePluginsSection: "推荐插件",
+				configureRolesSection: "角色配置",
+				configureClose: "关闭",
+				optionalPluginsTitle: "推荐插件",
+				optionalPluginsSubtitle: "补全 pstack 流程的可选 DSH 插件。页面不会自动启用任何插件，只按需开启。",
+				groupSessions: "会话与隔离",
+				groupVerification: "验证与证据",
+				groupMultiAgent: "多代理",
+				recommendedTag: "推荐",
+				suggestedTag: "GitHub PR 用户建议",
+				conflictTag: "冲突",
+				optionalLoading: "正在读取可选插件状态…",
+				optionalLoadFailed: "无法读取可选插件状态：{message}",
+				optionalRetry: "重试",
+				optionalRefresh: "刷新",
+				enableRecommended: "一键启用推荐项",
+				enablingRecommended: "正在启用推荐项…",
+				recommendedSummary: "成功 {applied} 项，需重启 {restart} 项，失败 {failed} 项，跳过 {skipped} 项",
+				recommendedHint: "默认推荐 {ids}。",
+				listSeparator: "、",
+				enablePlugin: "启用",
+				disablePlugin: "关闭",
+				pluginWorking: "处理中…",
+				pluginStatusEnabled: "已启用",
+				pluginStatusOff: "未启用",
+				pluginStatusMissing: "缺失",
+				pluginStatusUnsupportedPlatform: "平台不支持",
+				pluginStatusError: "错误",
+				resultApplied: "已生效",
+				resultRestartRequired: "需要重启",
+				resultFailed: "失败：{reason}",
+				resultOverridden: "被更高层覆盖",
+				resultCancelled: "已取消",
+				conflictWarning: "不要在同一 profile 中同时启用 Agent Teams 与 pstack_subagent：Agent Teams 会禁用 subagent 和 subagent_fork，并替换子代理控制。",
+				nonBundleGuidance: "非 bundle 项：请按 DSH 文档配置，本页不提供开关。",
+				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。",
+				opt03Title: "浏览器验证",
+				opt03Detail: "提供浏览器导航、输入、截图和 ARIA 快照；需选择一个提供方和受支持的模型。",
+				opt04Title: "桌面操作",
+				opt04Detail: "在 PTC Session 中操作 macOS 应用，支持点击、输入、截图与权限页。",
+				opt05Title: "常驻终端",
+				opt05Detail: "六个全局终端工具让 shell 或 REPL 跨调用保持存活，服务 CLI 与 TUI 验证。",
+				opt06Title: "会话搜索",
+				opt06Detail: "五个只读工具按相同 cwd 搜索和追踪历史 Session。",
+				opt07Title: "MCP 客户端",
+				opt07Detail: "挂载 MCP server，工具以 mcp__<server>__<tool> 出现在 /why 和 /teach 的证据调查中。",
+				opt08Title: "Agent Teams",
+				opt08Detail: "Lead/teammate 角色、共享任务板和九个团队工具；与 pstack_subagent 冲突。",
+				opt09Title: "Ralph 循环",
+				opt09Detail: "前台 ralph 循环每轮启动新子代理，服务 /autonomous-run。"
+			}
+		};
+		// src/client/index.ts
+		/** Browser services this plugin needs before `apply` runs. */
+		const inject = [
+			"remote",
+			"slots",
+			"locale",
+			"remote.pluginManager"
+		];
+		/** Mount the Remote contribution and register the bundle configuration action and activation guidance. */
+		async function apply(ctx) {
+			const disposeRemote = await ctx.remote.$mount(pstackRolesRemote);
+			ctx.effect(() => ctx.locale.register(NS$1, { ...catalogs$1 }), "pstack-roles.locale");
+			ctx.effect(() => ctx.locale.register(NS, { ...catalogs }), "pstack-plugins.locale");
+			const pluginManager = ctx.remote.pluginManager;
+			const optionalPlugins = {
+				listBundles: async () => {
+					const result = await pluginManager.listBundles();
+					if (!result.ok) throw result.error;
+					return result.value;
+				},
+				setBundleEnabled: async (name, enabled) => {
+					const result = await pluginManager.setBundleEnabled(name, enabled);
+					if (!result.ok) throw result.error;
+					return result.value;
+				}
+			};
+			ctx.inject(["remote.pstackRoles"], (scope) => {
+				const namespace = scope.remote.pstackRoles;
+				const api = {
+					status: async () => {
+						const result = await namespace.status();
+						if (!result.ok) throw result.error;
+						return result.value;
+					},
+					catalogue: async () => {
+						const result = await namespace.catalogue();
+						if (!result.ok) throw result.error;
+						return result.value;
+					},
+					save: async (request) => {
+						const result = await namespace.save(request);
+						if (!result.ok) return {
+							ok: false,
+							reason: result.error.message
+						};
+						return result.value;
+					}
+				};
+				scope.slots.inject("plugins.detail.actions", () => scope.slots.register({
+					name: "plugins.detail.actions",
+					id: "dsh-pstack",
+					locale: NS,
+					inject: () => ({
+						api,
+						optionalPlugins,
+						rolesT: ctx.locale.bind(NS$1)
+					})
+				}, PstackBundleConfigAction));
+				scope.slots.inject("plugins.bundle.activation", () => scope.slots.register({
+					name: "plugins.bundle.activation",
+					key: "dsh-pstack",
+					locale: NS,
+					inject: () => ({ optionalPlugins })
+				}, OptionalPluginsActivation));
+			});
+			return disposeRemote;
+		}
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.mjs.map