@lmzhen/dsh-evolution-settings-ui 0.6.1

package/README.md

@@ -0,0 +1,19 @@
+# @lmzhen/dsh-evolution-settings-ui
+
+Web settings cards for the evolution family's parameter namespaces. The Host half registers nothing: the namespaces belong to the plugins that own them (evolution-review, memory-files, tool-memory, evolution-curator, tool-skill-manage), and this package's browser half claims one card per namespace in the keyed `settings.plugin.item` slot.
+
+## What a card does
+
+Each card renders the namespace's user-writable (E3) fields with their current value, a source badge, a write control and a revert control. Writes go through the client settings scope (`set`/`unset`), which carries the revision it read as the write's fence; a field whose key is present in the raw user section reads as a user override even when its value equals the deployment value.
+
+The field list is GENERATED from the parameter registry (`packages/scripts/gen-param-client-view.mjs` writes `src/client/generated-params.ts`), so the browser half cannot name a parameter the Host does not register. Regenerate after every registry edit; the family gate runs the generator with `--check`.
+
+## Build
+
+The browser half ships as the client module system's lazy CJS factory artifact (`lib/client.js`): `packages/scripts/build-client.mjs` runs tsdown for a CommonJS body and wraps it in `window.__ModuleLoader__.load({ id, factory })`, because the platform's own client bundle preset is not published for packages outside its repository. The Host half builds with the family's normal `packages/scripts/build-lib.mjs`.
+
+## Known limitations and deferred work
+
+- Card copy lives in this package's own dictionary (`src/client/messages.ts`) and reaches components through the inject face; the platform locale seat is not bound yet (an outside package cannot declare an in-repo locale namespace type).
+- The cards render plain controls with class names and no stylesheet: the family ships no CSS build step for client packages yet.
+- Only E3 (user-writable) rows are rendered; deployment tiers are reported by `/evolution params` and the doctor divergence section instead.

package/lib/client.js

@@ -0,0 +1,335 @@
+window.__ModuleLoader__.load({
+	id: "@lmzhen/dsh-evolution-settings-ui",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react = require("react");
+		//#region src/client/generated-params.ts
+		const CLIENT_PARAM_SECTIONS = [
+			{
+				namespace: "evolution-curator",
+				fields: [
+					{
+						id: "curatorIntervalHours",
+						group: "curator",
+						doc: "Minimum hours between deterministic curation passes."
+					},
+					{
+						id: "staleAfterDays",
+						group: "curator",
+						doc: "Inactive days before a skill counts as stale."
+					},
+					{
+						id: "archiveAfterDays",
+						group: "curator",
+						doc: "Inactive days before a stale skill is archived (must be >= staleAfterDays)."
+					},
+					{
+						id: "qualityWarnStaleAfterDays",
+						group: "curator",
+						doc: "Age at which a low quality score starts warning."
+					},
+					{
+						id: "minIdleHours",
+						group: "curator",
+						doc: "Idle hours required before an automatic curation pass runs."
+					},
+					{
+						id: "minIdleFailOpen",
+						group: "curator",
+						doc: "Let the idle gate open when the activity probe is unavailable."
+					},
+					{
+						id: "llmReview",
+						group: "curator",
+						doc: "Enable the LLM nomination pass on top of the deterministic lifecycle."
+					},
+					{
+						id: "curatorReviewMaxTokens",
+						group: "curator",
+						doc: "Token budget of the curator LLM review."
+					},
+					{
+						id: "curatorReviewTimeoutMs",
+						group: "curator",
+						doc: "Wall-clock bound of the curator LLM review."
+					},
+					{
+						id: "healthSoftBodyChars",
+						group: "curator",
+						doc: "Body character line the health view judges against."
+					},
+					{
+						id: "healthStampDensityPerKb",
+						group: "curator",
+						doc: "Stamp density per KB that flags log-like content in a body."
+					},
+					{
+						id: "healthChurnMinPatches",
+						group: "curator",
+						doc: "Patches without a read that flag a write-ghost skill."
+					}
+				]
+			},
+			{
+				namespace: "evolution-memory",
+				fields: [
+					{
+						id: "memoryChars",
+						group: "memory",
+						doc: "Character budget the memory store enforces for MEMORY.md."
+					},
+					{
+						id: "userChars",
+						group: "memory",
+						doc: "Character budget the memory store enforces for USER.md."
+					},
+					{
+						id: "addDatePrefix",
+						group: "memory",
+						doc: "Prefix stored memory entries with their date heading."
+					},
+					{
+						id: "maxConsolidationFailures",
+						group: "memory",
+						doc: "Consolidation failures one turn tolerates before the tool gives up."
+					}
+				]
+			},
+			{
+				namespace: "evolution-review",
+				fields: [
+					{
+						id: "reviewSkillInterval",
+						group: "review",
+						doc: "Activity units between skill-review injections."
+					},
+					{
+						id: "reviewMemoryInterval",
+						group: "review",
+						doc: "Activity units between memory-review injections."
+					},
+					{
+						id: "skillReviewTrigger",
+						group: "review",
+						doc: "Which channel may inject a skill review (cadence, completion, both)."
+					},
+					{
+						id: "skillReviewCompletionMinToolCalls",
+						group: "review",
+						doc: "Tool calls a task needs before the completion channel injects."
+					},
+					{
+						id: "reviewEnabled",
+						group: "review",
+						doc: "Master switch for the review plugin."
+					},
+					{
+						id: "reviewMode",
+						group: "review",
+						doc: "Run the review in the parent session (inject) or on a subagent."
+					},
+					{
+						id: "reviewWakeInject",
+						group: "review",
+						doc: "Deliver the deferred review as a waking follow-up message."
+					}
+				]
+			},
+			{
+				namespace: "evolution-skills",
+				fields: [
+					{
+						id: "skillContentChars",
+						group: "write-caps",
+						doc: "Character cap on a SKILL.md body (tighten-only)."
+					},
+					{
+						id: "maxSkillFileBytes",
+						group: "write-caps",
+						doc: "Byte cap on one support file (tighten-only)."
+					},
+					{
+						id: "maxSkillNameLength",
+						group: "write-caps",
+						doc: "Character cap on a skill name (tighten-only)."
+					},
+					{
+						id: "maxDescriptionLength",
+						group: "write-caps",
+						doc: "Character cap on a skill description (tighten-only)."
+					},
+					{
+						id: "descriptionStrict",
+						group: "write-caps",
+						doc: "Refuse a description over the authoring bar instead of advising."
+					},
+					{
+						id: "strictCrossSource",
+						group: "write-caps",
+						doc: "Refuse writes whose catalog entry resolves outside the family."
+					},
+					{
+						id: "citationPolicy",
+						group: "write-caps",
+						doc: "Refuse a move that would leave a dangling reference, or verify it."
+					},
+					{
+						id: "supportFileCharPolicy",
+						group: "write-caps",
+						doc: "Warn about an oversize support file, or refuse the write."
+					}
+				]
+			},
+			{
+				namespace: "evolution-tool-memory",
+				fields: [{
+					id: "entryPreviewChars",
+					group: "memory",
+					doc: "Characters of one memory entry shown in a tool result preview."
+				}]
+			}
+		];
+		//#endregion
+		//#region src/client/ParamCard.ts
+		/**
+		* One namespace's parameter card.
+		*
+		* Structural local types on purpose: this package is distributed outside the
+		* platform repository and a value import of another plugin is forbidden, so the
+		* settings scope and its snapshot are declared by the shape the renderer hands
+		* over (`getSnapshot`/`subscribe`, status/value/user/writable).
+		*/
+		/** One cell's text: absent reads as a dash, containers as JSON. */
+		function format(value) {
+			if (value === void 0) return "—";
+			if (typeof value === "string") return value;
+			return JSON.stringify(value);
+		}
+		/** Parse one typed value the way the command surface does: JSON, else raw text. */
+		function parse(draft) {
+			const text = draft.trim();
+			try {
+				return JSON.parse(text);
+			} catch {
+				return text;
+			}
+		}
+		/** Whether a value is a plain section object. */
+		function isSection(value) {
+			return typeof value === "object" && value !== null && !Array.isArray(value);
+		}
+		/** One parameter row: current value, source badge, write and reset controls. */
+		function FieldRow(props) {
+			const [draft, setDraft] = (0, react.useState)("");
+			return (0, react.createElement)("div", { className: "evolution-param-row" }, (0, react.createElement)("code", null, props.field.id), (0, react.createElement)("span", { className: "evolution-param-value" }, format(props.value)), (0, react.createElement)("span", { className: "evolution-param-source" }, props.overridden ? props.t("overridden") : props.t("deployment")), (0, react.createElement)("input", {
+				value: draft,
+				disabled: props.disabled,
+				placeholder: props.field.doc,
+				onChange: (event) => {
+					setDraft(event.target.value);
+				}
+			}), (0, react.createElement)("button", {
+				disabled: props.disabled || draft.trim() === "",
+				onClick: () => {
+					props.write(props.field.id, parse(draft));
+				}
+			}, props.t("apply")), props.overridden ? (0, react.createElement)("button", {
+				disabled: props.disabled,
+				onClick: () => {
+					props.clear(props.field.id);
+				}
+			}, props.t("reset")) : null);
+		}
+		/**
+		* Render one namespace's card.
+		* @param props - the card data, its callbacks, and the bound section hook.
+		* @returns the card.
+		*/
+		function ParamCard(props) {
+			const { t, fields, write, clear } = props;
+			const snapshot = props.useParamSection((state) => state);
+			if (snapshot.status === "loading") return (0, react.createElement)("p", null, t("loading"));
+			if (snapshot.status === "unavailable") return (0, react.createElement)("p", null, t("unavailable"));
+			const user = isSection(snapshot.user) ? snapshot.user : {};
+			const value = isSection(snapshot.value) ? snapshot.value : {};
+			const disabled = !snapshot.writable;
+			return (0, react.createElement)("section", { className: "evolution-params" }, (0, react.createElement)("h4", null, t("title") + " — " + props.namespace), disabled ? (0, react.createElement)("p", null, t("readonly")) : null, fields.length === 0 ? (0, react.createElement)("p", null, t("empty")) : fields.map((field) => (0, react.createElement)(FieldRow, {
+				key: field.id,
+				field,
+				value: value[field.id],
+				overridden: Object.hasOwn(user, field.id),
+				disabled,
+				t,
+				write,
+				clear
+			})));
+		}
+		//#endregion
+		//#region src/client/messages.ts
+		/**
+		* Copy for the evolution parameter cards.
+		*
+		* The bundle carries its own dictionary: this package is distributed outside the
+		* platform repository, whose typed locale seats are declared per in-repo
+		* namespace. Components never inline a string — the card receives `t` through its
+		* inject face, which is where a locale-service binding would plug in later.
+		*/
+		/** Message keys the cards render. */
+		const MESSAGES = {
+			title: "Evolution parameters",
+			overridden: "user override",
+			deployment: "deployment value",
+			loading: "reading the settings document…",
+			unavailable: "this namespace is not served by the Host (its owning plugin row is not mounted)",
+			readonly: "the settings document is read-only in this session (memory mode)",
+			apply: "Apply",
+			reset: "Reset to deployment",
+			empty: "no writable field in this namespace"
+		};
+		/**
+		* Resolve one message.
+		* @param key - the message key.
+		* @returns the copy this bundle carries.
+		*/
+		function message(key) {
+			return MESSAGES[key];
+		}
+		//#endregion
+		//#region src/client/index.ts
+		/** Required client services: the slot registry and the settings transport. */
+		const inject = ["slots", "settingsScope"];
+		/**
+		* Register one card per generated namespace section.
+		* @param ctx - client cordis context.
+		*/
+		function apply(ctx) {
+			const seam = ctx;
+			seam.slots.inject("settings.plugin.item", function* () {
+				for (const section of CLIENT_PARAM_SECTIONS) {
+					const scope = seam.settingsScope.bind({ namespace: section.namespace });
+					const source = scope;
+					const face = () => ({
+						namespace: section.namespace,
+						fields: section.fields,
+						t: (key) => message(key),
+						write: (field, value) => scope.set(field, value),
+						clear: (field) => scope.unset(field),
+						hooks: { paramSection: source }
+					});
+					yield seam.slots.register({
+						name: "settings.plugin.item",
+						key: section.namespace,
+						inject: face
+					}, ParamCard);
+				}
+			});
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+
+		return module.exports;
+	}
+});

package/lib/index.js

@@ -0,0 +1,18 @@
+//#region lib/types/index.js
+/**
+* Host half of the evolution settings-UI package: it registers NOTHING.
+*
+* The cards are the browser half (`./client`). The Host halves that own the
+* settings namespaces are the plugins themselves (evolution-review, memory-files,
+* tool-memory, evolution-curator, tool-skill-manage), so this row carries no
+* service and no behaviour: disabling it removes the cards and nothing else.
+* @module @lmzhen/dsh-evolution-settings-ui
+*/
+const name = "evolution-settings-ui";
+/** No Host dependency: the row exists so the Loader discovers the package's
+* `dsh.client` manifest and serves `./client` to the page. */
+const inject = [];
+/** Intentionally empty: the Host half owns no state and no registration. */
+function apply() {}
+//#endregion
+export { apply, inject, name };

package/lib/types/client/ParamCard.d.ts

@@ -0,0 +1,35 @@
+/**
+ * One namespace's parameter card.
+ *
+ * Structural local types on purpose: this package is distributed outside the
+ * platform repository and a value import of another plugin is forbidden, so the
+ * settings scope and its snapshot are declared by the shape the renderer hands
+ * over (`getSnapshot`/`subscribe`, status/value/user/writable).
+ */
+import { type ReactNode } from 'react';
+import type { ClientParamField } from './generated-params.ts';
+import type { MessageKey } from './messages.ts';
+import type { ParamSectionSnapshot, ParamSectionSource } from './seam.ts';
+/** Injected face: plain data and callbacks, plus the hook seat. */
+export interface ParamCardFace {
+    namespace: string;
+    fields: readonly ClientParamField[];
+    t: (key: MessageKey) => string;
+    write: (field: string, value: unknown) => Promise<void>;
+    clear: (field: string) => Promise<void>;
+    hooks: {
+        paramSection: ParamSectionSource;
+    };
+}
+/** Props the renderer binds for one card: the inject face plus its hook seat. */
+export type ParamCardProps = ParamCardFace & {
+    /** Bound from `hooks.paramSection` by the renderer. */
+    readonly useParamSection: <T>(selector: (state: ParamSectionSnapshot) => T) => T;
+};
+/**
+ * Render one namespace's card.
+ * @param props - the card data, its callbacks, and the bound section hook.
+ * @returns the card.
+ */
+export declare function ParamCard(props: ParamCardProps): ReactNode;
+//# sourceMappingURL=ParamCard.d.ts.map

package/lib/types/client/generated-params.d.ts

@@ -0,0 +1,20 @@
+/**
+ * GENERATED by packages/scripts/gen-param-client-view.mjs — do not edit.
+ *
+ * One card per settings namespace; fields are the E3 rows of the registry, so
+ * the browser half names exactly what the Host half registers.
+ */
+/** One field a card renders a control for. */
+export interface ClientParamField {
+    id: string;
+    group: string;
+    /** The registry summary, used as the field help text. */
+    doc: string;
+}
+/** One card: the settings namespace plus the fields it exposes. */
+export interface ClientParamSection {
+    namespace: string;
+    fields: readonly ClientParamField[];
+}
+export declare const CLIENT_PARAM_SECTIONS: readonly ClientParamSection[];
+//# sourceMappingURL=generated-params.d.ts.map

package/lib/types/client/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Browser half: one card per settings namespace the family registers.
+ *
+ * The join key is the namespace itself — the Host half of each owning plugin
+ * registers it, this half claims it in the keyed `settings.plugin.item` slot, and
+ * the configuration tab pairs them. A namespace the Host does not serve renders
+ * nothing, and a deployment that drops this row shows no cards at all: the pair
+ * carries no Host-side behaviour.
+ * @module @lmzhen/dsh-evolution-settings-ui/client
+ */
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+/** Required client services: the slot registry and the settings transport. */
+export declare const inject: string[];
+/**
+ * Register one card per generated namespace section.
+ * @param ctx - client cordis context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/messages.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Copy for the evolution parameter cards.
+ *
+ * The bundle carries its own dictionary: this package is distributed outside the
+ * platform repository, whose typed locale seats are declared per in-repo
+ * namespace. Components never inline a string — the card receives `t` through its
+ * inject face, which is where a locale-service binding would plug in later.
+ */
+/** Message keys the cards render. */
+export declare const MESSAGES: {
+    readonly title: "Evolution parameters";
+    readonly overridden: "user override";
+    readonly deployment: "deployment value";
+    readonly loading: "reading the settings document…";
+    readonly unavailable: "this namespace is not served by the Host (its owning plugin row is not mounted)";
+    readonly readonly: "the settings document is read-only in this session (memory mode)";
+    readonly apply: "Apply";
+    readonly reset: "Reset to deployment";
+    readonly empty: "no writable field in this namespace";
+};
+/** One message key. */
+export type MessageKey = keyof typeof MESSAGES;
+/**
+ * Resolve one message.
+ * @param key - the message key.
+ * @returns the copy this bundle carries.
+ */
+export declare function message(key: MessageKey): string;
+//# sourceMappingURL=messages.d.ts.map

package/lib/types/client/seam.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Structural view of the client seams this bundle uses.
+ *
+ * The package is distributed OUTSIDE the platform repository, so it declares the
+ * two seams it consumes instead of importing another plugin's values (forbidden
+ * by the client bundle-purity rule) or its types (which would drag the platform
+ * sources into this project). The shapes are the renderer's contract: a keyed
+ * `settings.plugin.item` registration, the inject face it hands back, and the
+ * per-namespace settings scope the write path fences with the revision it read.
+ * @module @lmzhen/dsh-evolution-settings-ui/client
+ */
+/** Snapshot of one settings namespace, as the client scope reports it. */
+export interface ParamSectionSnapshot {
+    status: 'loading' | 'ready' | 'unavailable';
+    value: Record<string, unknown> | undefined;
+    /** Raw user section: a key's PRESENCE marks the override, not its value. */
+    user: unknown;
+    writable: boolean;
+}
+/** The reactive source the renderer binds to a `use<Name>` seat. */
+export interface ParamSectionSource {
+    getSnapshot(): ParamSectionSnapshot;
+    subscribe(listener: () => void): () => void;
+}
+/** One namespace's write face. */
+export interface SettingsScopeLike {
+    set(field: string, value: unknown): Promise<void>;
+    unset(field: string): Promise<void>;
+}
+/** Registration options the keyed slot takes. */
+export interface SlotRegisterOptions {
+    name: 'settings.plugin.item';
+    /** The settings namespace this card edits — the slot's key. */
+    key: string;
+    inject: () => unknown;
+}
+/** The slice of the client context this plugin consumes. */
+export interface ClientSeam {
+    slots: {
+        inject(name: string, callback: () => Generator<unknown, void, unknown>): unknown;
+        register(options: SlotRegisterOptions, component: (props: never) => unknown): () => void;
+    };
+    settingsScope: {
+        bind(spec: {
+            namespace: string;
+        }): SettingsScopeLike;
+    };
+}
+//# sourceMappingURL=seam.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Host half of the evolution settings-UI package: it registers NOTHING.
+ *
+ * The cards are the browser half (`./client`). The Host halves that own the
+ * settings namespaces are the plugins themselves (evolution-review, memory-files,
+ * tool-memory, evolution-curator, tool-skill-manage), so this row carries no
+ * service and no behaviour: disabling it removes the cards and nothing else.
+ * @module @lmzhen/dsh-evolution-settings-ui
+ */
+export declare const name = "evolution-settings-ui";
+/** No Host dependency: the row exists so the Loader discovers the package's
+ * `dsh.client` manifest and serves `./client` to the page. */
+export declare const inject: string[];
+/** Intentionally empty: the Host half owns no state and no registration. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@lmzhen/dsh-evolution-settings-ui",
+  "description": "Web settings cards for the evolution family's parameter namespaces (community build)",
+  "version": "0.6.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lmzhen/dsh-evolution.git",
+    "directory": "packages/evolution-settings-ui"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/*.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "MIT",
+  "dsh": {
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-settings-plugins"
+      ]
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "react": "^18.2.0"
+  }
+}