@openvulcan/dsh-vulcancode 0.4.0 → 0.4.4

package/node_modules/@openvulcan/dsh-vulcan-answers/lib/committed-fiber.d.ts

@@ -0,0 +1,18 @@
+/**
+ * React links each committed fiber to its work-in-progress alternate and the root's active tree.
+ * React 将已提交的 Fiber 与工作中的副本关联，并由根节点指向当前生效的树。
+ */
+export interface Fiber {
+    readonly tag: number;
+    readonly memoizedProps: unknown;
+    readonly return: Fiber | null;
+    readonly child: Fiber | null;
+    readonly sibling: Fiber | null;
+    readonly alternate: Fiber | null;
+    readonly stateNode: unknown;
+}
+/**
+ * Given a DOM-owned fiber, return its committed path from the element to the root, or undefined if detached.
+ * 给定 DOM 节点持有的 Fiber，返回它从元素到根节点的已提交路径，节点脱离时返回 undefined。
+ */
+export declare function committedFiberPath(fiber: Fiber): readonly Fiber[] | undefined;

package/node_modules/@openvulcan/dsh-vulcan-answers/lib/committed-fiber.js

@@ -0,0 +1,62 @@
+// React's HostRoot tag identifies the owner of the committed tree.
+// React 的 HostRoot 标记标识已提交树的所有者。
+const HOST_ROOT = 3;
+/**
+ * Given a DOM-owned fiber, return its committed path from the element to the root, or undefined if detached.
+ * 给定 DOM 节点持有的 Fiber，返回它从元素到根节点的已提交路径，节点脱离时返回 undefined。
+ */
+export function committedFiberPath(fiber) {
+    // A bailout can share children across alternates, leaving their return pointers on the previous tree.
+    // React 跳过重渲染时，两个副本可能共用子节点，子节点的父指针仍指向上一轮的树。
+    const candidates = new Set();
+    // Follow both copies upward so the later search only visits possible ancestors of this element.
+    // 沿两个副本向上收集节点，让后续搜索只访问该元素可能的祖先。
+    const pending = [fiber];
+    // The root state is shared across alternates and identifies the currently committed root.
+    // 两个根副本共用根状态，其中记录当前已提交的根节点。
+    let root;
+    for (const candidate of pending) {
+        if (candidates.has(candidate))
+            continue;
+        candidates.add(candidate);
+        if (candidate.tag === HOST_ROOT) {
+            // Require the root's current pointer to identify one of its own fiber copies.
+            // 根状态的 current 必须指向该根节点的两个副本之一。
+            const state = candidate.stateNode;
+            if (typeof state === 'object' && state !== null && 'current' in state) {
+                if (state.current === candidate)
+                    root = candidate;
+                else if (candidate.alternate !== null && state.current === candidate.alternate)
+                    root = candidate.alternate;
+            }
+            continue;
+        }
+        if (candidate.return !== null)
+            pending.push(candidate.return);
+        if (candidate.alternate !== null)
+            pending.push(candidate.alternate);
+    }
+    /**
+     * Return the path from the requested fiber to this committed ancestor, if this branch owns it.
+     * 若此分支包含目标 Fiber，返回目标 Fiber 到当前已提交祖先的路径。
+     */
+    function findPath(parent) {
+        if (parent === fiber || parent === fiber.alternate)
+            return [parent];
+        // Only the committed parent's child list establishes membership in the current tree.
+        // 只有已提交父节点的子节点列表能确定节点是否属于当前树。
+        for (let child = parent.child; child !== null; child = child.sibling) {
+            if (!candidates.has(child))
+                continue;
+            // A candidate reached from the root is committed. Verify that its branch reaches the element.
+            // 从根节点走到的候选节点已提交，再确认该分支能到达目标元素。
+            const path = findPath(child);
+            if (path !== undefined) {
+                path.push(parent);
+                return path;
+            }
+        }
+        return undefined;
+    }
+    return root === undefined ? undefined : findPath(root);
+}

package/node_modules/@openvulcan/dsh-vulcan-answers/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openvulcan/dsh-vulcan-answers",
-  "version": "0.4.0",
+  "version": "0.4.4",
   "description": "Interactive answers for DeepSeek Harness: the model answers with VulcanCode ui-* components, rendered in the chat.",
   "license": "MIT",
   "icon": "./assets/answers-icon.png",

package/node_modules/@openvulcan/dsh-vulcan-luaskills/lib/client.js

@@ -303,6 +303,12 @@ window.__ModuleLoader__.load({
 			        locale: i18n_1.NAMESPACE,
 			        inject: () => ({ view }),
 			    }, ({ t, view: injected }) => (0, jsx_runtime_1.jsx)(settings_1.SettingsPage, { view: injected, t: t })));
+			    // dsh 0.2.2 declares this optional slot. The injection waits on older hosts.
+			    // dsh 0.2.2 声明了此可选插槽，旧版宿主上的注入会保持等待。
+			    ctx.slots.inject('settings.section.icon', () => ctx.slots.register({
+			        name: 'settings.section.icon',
+			        id: shared_1.SETTINGS_SECTION,
+			    }, LuaSkillsIcon));
 			    ctx.slots.inject('main', () => ctx.slots.register({
 			        name: 'main',
 			        key: shared_1.PANEL_ID,
@@ -316,10 +322,13 @@ window.__ModuleLoader__.load({
 			        order: 20,
 			        locale: i18n_1.NAMESPACE,
 			        label: () => ctx.locale.bind(i18n_1.NAMESPACE)('panel'),
-			    }, PanelIcon));
+			    }, LuaSkillsIcon));
 			}
-			/** A Lua-style moon over a bracket pair: skills as code. */
-			function PanelIcon({ size }) {
+			/**
+			 * Render the LuaSkills moon and brackets at the size requested by either navigation slot.
+			 * 按设置或侧栏导航插槽要求的尺寸渲染 LuaSkills 的月亮与括号图标。
+			 */
+			function LuaSkillsIcon({ size }) {
 			    return ((0, jsx_runtime_1.jsxs)("svg", { width: size, height: size, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: 1.6, strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [(0, jsx_runtime_1.jsx)("circle", { cx: "12", cy: "12", r: "8.5" }), (0, jsx_runtime_1.jsx)("circle", { cx: "16.2", cy: "7.8", r: "2.1" }), (0, jsx_runtime_1.jsx)("path", { d: "M9.5 9.5 7 12l2.5 2.5M14.5 14.5 17 12" })] }));
 			}
 
@@ -363,7 +372,7 @@ window.__ModuleLoader__.load({
 			        });
 			        return () => { current = false; };
 			    }, [live?.state.kind, generation]);
-			    return ((0, jsx_runtime_1.jsx)("div", { className: "vac vls-panel", children: (0, jsx_runtime_1.jsxs)("div", { className: "vac vac-page vls-panel-inner", children: [(0, jsx_runtime_1.jsxs)("div", { className: "vac-page-head", children: [(0, jsx_runtime_1.jsx)("h2", { children: t('panel') }), (0, jsx_runtime_1.jsx)("p", { className: "vac-lead", children: t('page.lead') })] }), live === undefined ? (0, jsx_runtime_1.jsx)("p", { className: "vac-hint", children: t('loading') }) : null, live === null ? (0, jsx_runtime_1.jsx)("div", { className: "vac-alert bad", children: t('unavailable') }) : null, live != null && !ready ? ((0, jsx_runtime_1.jsxs)("div", { className: "vls-banner warn", children: [(0, jsx_runtime_1.jsx)("p", { className: "vac-hint", children: live.state.kind === 'installing' || live.state.kind === 'starting' ? t(`runtime.${live.state.kind === 'starting' ? 'starting' : `phase.${live.state.phase}`}`) : t('page.needRuntime') }), (0, jsx_runtime_1.jsx)("button", { type: "button", className: "vac-btn primary", onClick: openSettings, children: t('page.openSettings') })] })) : null, (0, jsx_runtime_1.jsx)("div", { className: "vls-tabs", role: "tablist", children: ['installed', 'hub'].map(name => ((0, jsx_runtime_1.jsx)("button", { type: "button", role: "tab", "aria-selected": tab === name, className: tab === name ? 'vls-tab on' : 'vls-tab', onClick: () => { setTab(name); }, children: t(`tab.${name}`) }, name))) }), (0, jsx_runtime_1.jsx)("div", { hidden: tab !== 'installed', children: (0, jsx_runtime_1.jsx)(Installed, { skills: skills, error: skillsError, ready: ready, reload: reload, t: t }) }), (0, jsx_runtime_1.jsx)("div", { hidden: tab !== 'hub', children: (0, jsx_runtime_1.jsx)(Hub, { live: live ?? null, ready: ready, installed: skills ?? [], reload: reload, view: view, t: t }) })] }) }));
+			    return ((0, jsx_runtime_1.jsx)("div", { className: "vac vls-panel", children: (0, jsx_runtime_1.jsxs)("div", { className: "vac vac-page vls-panel-inner", "data-vulcan-settings-width": "full", children: [(0, jsx_runtime_1.jsxs)("header", { className: "vac-page-head", "data-vulcan-settings-header": true, children: [(0, jsx_runtime_1.jsx)("h2", { children: t('panel') }), (0, jsx_runtime_1.jsx)("p", { className: "vac-lead", children: t('page.lead') })] }), live === undefined ? (0, jsx_runtime_1.jsx)("p", { className: "vac-hint", children: t('loading') }) : null, live === null ? (0, jsx_runtime_1.jsx)("div", { className: "vac-alert bad", children: t('unavailable') }) : null, live != null && !ready ? ((0, jsx_runtime_1.jsxs)("div", { className: "vls-banner warn", children: [(0, jsx_runtime_1.jsx)("p", { className: "vac-hint", children: live.state.kind === 'installing' || live.state.kind === 'starting' ? t(`runtime.${live.state.kind === 'starting' ? 'starting' : `phase.${live.state.phase}`}`) : t('page.needRuntime') }), (0, jsx_runtime_1.jsx)("button", { type: "button", className: "vac-btn primary", onClick: openSettings, children: t('page.openSettings') })] })) : null, (0, jsx_runtime_1.jsx)("div", { className: "vls-tabs", role: "tablist", children: ['installed', 'hub'].map(name => ((0, jsx_runtime_1.jsx)("button", { type: "button", role: "tab", "aria-selected": tab === name, className: tab === name ? 'vls-tab on' : 'vls-tab', onClick: () => { setTab(name); }, children: t(`tab.${name}`) }, name))) }), (0, jsx_runtime_1.jsx)("div", { hidden: tab !== 'installed', children: (0, jsx_runtime_1.jsx)(Installed, { skills: skills, error: skillsError, ready: ready, reload: reload, t: t }) }), (0, jsx_runtime_1.jsx)("div", { hidden: tab !== 'hub', children: (0, jsx_runtime_1.jsx)(Hub, { live: live ?? null, ready: ready, installed: skills ?? [], reload: reload, view: view, t: t }) })] }) }));
 			}
 			function Installed({ skills, error, ready, reload, t }) {
 			    const [busy, setBusy] = (0, react_1.useState)(undefined);
@@ -594,7 +603,7 @@ window.__ModuleLoader__.load({
 			const shared_1 = require("./shared");
 			function SettingsPage({ view, t }) {
 			    const live = (0, runtime_1.useRuntime)(view);
-			    return ((0, jsx_runtime_1.jsxs)("div", { className: "vac vac-page", children: [(0, jsx_runtime_1.jsxs)("div", { className: "vac-page-head", children: [(0, jsx_runtime_1.jsx)("h2", { children: t('settingsPage.title') }), (0, jsx_runtime_1.jsx)("p", { className: "vac-lead", children: t('settingsPage.lead') })] }), live === undefined ? (0, jsx_runtime_1.jsx)("p", { className: "vac-hint", children: t('loading') })
+			    return ((0, jsx_runtime_1.jsxs)("div", { className: "vac vac-page", "data-vulcan-settings-width": "full", children: [(0, jsx_runtime_1.jsxs)("header", { className: "vac-page-head", "data-vulcan-settings-header": true, children: [(0, jsx_runtime_1.jsx)("h2", { children: t('settingsPage.title') }), (0, jsx_runtime_1.jsx)("p", { className: "vac-lead", children: t('settingsPage.lead') })] }), live === undefined ? (0, jsx_runtime_1.jsx)("p", { className: "vac-hint", children: t('loading') })
 			                : live === null ? (0, jsx_runtime_1.jsx)("div", { className: "vac-alert bad", children: t('unavailable') })
 			                    : ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(runtime_1.RuntimeSection, { view: view, live: live, t: t }), (0, jsx_runtime_1.jsx)(SettingsSection, { view: view, live: live, t: t })] }))] }));
 			}

package/node_modules/@openvulcan/dsh-vulcan-luaskills/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openvulcan/dsh-vulcan-luaskills",
-  "version": "0.4.0",
+  "version": "0.4.4",
   "description": "LuaSkills for DeepSeek Harness: skill tools for the model, the codekit default skill, VM settings and the LuaSkills Hub. The runtime is installed on demand.",
   "license": "MIT",
   "icon": "./assets/luaskills-icon.svg",

package/node_modules/@openvulcan/dsh-vulcan-memory/assets/markdown-memory-guide.md

@@ -14,6 +14,7 @@ Where it belongs:
 
 How to write:
 - Search first. Update or append to an existing node instead of adding a near duplicate, and merge duplicates that a receipt reports.
+- Batch operations run in order and commit all-or-nothing. For dependent edits to the same node, use separate calls and read its revision after each successful write.
 - Make each title state the fact itself ("Verify with targeted tests only"), not a topic ("Testing"), so catalog lines carry meaning.
 - One fact per node; keep bodies short and put details in child nodes (down to H4).
 - Correct or delete nodes that turn out to be wrong or outdated.

package/node_modules/@openvulcan/dsh-vulcan-memory/assets/memory-curator/SKILL.md

@@ -11,7 +11,7 @@ Long-term memory is three Markdown files of heading nodes: `user` (who the user
 
 1. Run `memory_outline` for all scopes. Note the budget lines from the last write receipt if you have one.
 2. Read candidate nodes with `memory_search` (by `ids`, or by patterns for suspected duplicates) before changing anything. Every change needs the node's current `expectedRevision`.
-3. Plan the changes, then apply them with as few `memory_write` calls as practical; one call applies up to 16 operations all-or-nothing.
+3. Batch independent changes in `memory_write`. One call applies up to 16 operations in order and commits all-or-nothing. For dependent edits to the same node, use separate calls and read its revision after each successful write.
 4. Report what changed: merged, moved, renamed, deleted, and anything you left for the user to decide.
 
 ## What to fix

package/node_modules/@openvulcan/dsh-vulcan-memory/lib/markdown/errors.d.ts

@@ -6,6 +6,13 @@ export declare class MemoryError extends Error {
     static invalid(message: string): MemoryError;
     static notFound(id: string): MemoryError;
     static revisionMismatch(id: string, expected: string, current: string): MemoryError;
+    /**
+     * Report a node's expected and staged revisions and its revision before the batch, if present.
+     * 报告节点的预期修订、暂存修订，以及该节点在批次前已有的修订。
+     * @returns A revision conflict that retains the existing tool and HTTP error kind.
+     * 返回沿用工具与 HTTP 错误类型的修订冲突。
+     */
+    static stagedRevisionMismatch(id: string, expected: string, staged: string, committed: string | undefined): MemoryError;
     static concurrent(path: string): MemoryError;
     static io(path: string, action: string, cause: unknown): MemoryError;
     static json(path: string, message: string): MemoryError;

package/node_modules/@openvulcan/dsh-vulcan-memory/lib/markdown/errors.js

@@ -15,6 +15,17 @@ export class MemoryError extends Error {
     static revisionMismatch(id, expected, current) {
         return new MemoryError('revision_mismatch', `Memory node \`${id}\` changed (expected revision ${expected}, current ${current}); read it again before writing.`);
     }
+    /**
+     * Report a node's expected and staged revisions and its revision before the batch, if present.
+     * 报告节点的预期修订、暂存修订，以及该节点在批次前已有的修订。
+     * @returns A revision conflict that retains the existing tool and HTTP error kind.
+     * 返回沿用工具与 HTTP 错误类型的修订冲突。
+     */
+    static stagedRevisionMismatch(id, expected, staged, committed) {
+        return new MemoryError('revision_mismatch', `Memory node \`${id}\` has staged revision ${staged} in this batch (expected ${expected}). ` +
+            `Committed revision before the batch: ${committed ?? 'none for this node ID'}. ` +
+            'Submit dependent edits in separate calls and read the node after each successful write.');
+    }
     static concurrent(path) {
         return new MemoryError('concurrent_modification', `Memory file \`${path}\` changed on disk while the write was prepared; retry the write.`);
     }

package/node_modules/@openvulcan/dsh-vulcan-memory/lib/markdown/index.d.ts

@@ -125,7 +125,7 @@ export declare const TOOL_SPECS: {
     };
     readonly write: {
         readonly name: "memory_write";
-        readonly description: "Change long-term memory with 1 to 16 operations applied all-or-nothing: create, replace, append, rename, move (across scopes and sections too) and delete. create needs a scope and exactly one of parentId, section or newSection. Every action except create needs the node's current expectedRevision from memory_search or memory_outline. Scopes: `user` describes who the user is; `space` holds rules and environment that hold for every project; `project` holds facts, decisions and constraints of this project only. The `base` section of space and project is injected in full every session, so keep it to a few critical, stable rules and put the rest in other sections. Write when the user asks you to remember something, corrects your approach, or a decision is made that the repository does not show. Make titles state the fact itself; bodies cannot contain H1-H4 headings.";
+        readonly description: "Change long-term memory with 1 to 16 operations applied in order and committed all-or-nothing: create, replace, append, rename, move (across scopes and sections too) and delete. create needs a scope and exactly one of parentId, section or newSection. Every action except create needs the node's current expectedRevision from memory_search or memory_outline. For dependent edits to the same node, use separate calls and read its revision after each successful write. Scopes: `user` describes who the user is; `space` holds rules and environment that hold for every project; `project` holds facts, decisions and constraints of this project only. The `base` section of space and project is injected in full every session, so keep it to a few critical, stable rules and put the rest in other sections. Write when the user asks you to remember something, corrects your approach, or a decision is made that the repository does not show. Make titles state the fact itself; bodies cannot contain H1-H4 headings.";
         readonly parameters: {
             readonly type: "object";
             readonly additionalProperties: false;

package/node_modules/@openvulcan/dsh-vulcan-memory/lib/markdown/index.js

@@ -89,7 +89,7 @@ export const TOOL_SPECS = {
     },
     write: {
         name: 'memory_write',
-        description: `Change long-term memory with 1 to ${MAX_OPERATIONS_PER_WRITE} operations applied all-or-nothing: create, replace, append, rename, move (across scopes and sections too) and delete. create needs a scope and exactly one of parentId, section or newSection. Every action except create needs the node's current expectedRevision from memory_search or memory_outline. Scopes: \`user\` describes who the user is; \`space\` holds rules and environment that hold for every project; \`project\` holds facts, decisions and constraints of this project only. The \`base\` section of space and project is injected in full every session, so keep it to a few critical, stable rules and put the rest in other sections. Write when the user asks you to remember something, corrects your approach, or a decision is made that the repository does not show. Make titles state the fact itself; bodies cannot contain H1-H4 headings.`,
+        description: `Change long-term memory with 1 to ${MAX_OPERATIONS_PER_WRITE} operations applied in order and committed all-or-nothing: create, replace, append, rename, move (across scopes and sections too) and delete. create needs a scope and exactly one of parentId, section or newSection. Every action except create needs the node's current expectedRevision from memory_search or memory_outline. For dependent edits to the same node, use separate calls and read its revision after each successful write. Scopes: \`user\` describes who the user is; \`space\` holds rules and environment that hold for every project; \`project\` holds facts, decisions and constraints of this project only. The \`base\` section of space and project is injected in full every session, so keep it to a few critical, stable rules and put the rest in other sections. Write when the user asks you to remember something, corrects your approach, or a decision is made that the repository does not show. Make titles state the fact itself; bodies cannot contain H1-H4 headings.`,
         parameters: {
             type: 'object',
             additionalProperties: false,

package/node_modules/@openvulcan/dsh-vulcan-memory/lib/markdown/operations.js

@@ -181,14 +181,33 @@ class WriteSession {
         const scopes = this.projectId === undefined ? ['user', 'space'] : ['user', 'space', 'project'];
         return scopes.flatMap(scope => this.scope(scope).document.views(scope));
     }
-    /** Find a node by id across scopes and check its revision. */
+    /**
+     * Find the staged node by id and compare its revision with the caller's token.
+     * 按标识查找批内暂存节点，并将其修订与调用方的令牌比较。
+     */
     locate(id, expectedRevision) {
         const view = this.allViews().find(candidate => candidate.id === id);
         if (view === undefined)
             throw MemoryError.notFound(id);
-        if (view.revision !== expectedRevision.trim())
+        if (view.revision === expectedRevision.trim())
+            return view;
+        // A rejected batch discards its staged documents. Search the original files in scope order,
+        // since a staged move can put the node in a different scope from its committed version.
+        // 被拒绝的批次会丢弃暂存文档。按层顺序查找原始文件，因为批内移动可能改变节点所在的层。
+        let committed;
+        for (const scope of SCOPES) {
+            const original = this.scopes.get(scope)?.original;
+            if (original === undefined)
+                continue;
+            const node = MemoryDocument.parse(original).views(scope).find(candidate => candidate.id === id);
+            if (node === undefined)
+                continue;
+            committed = node.revision;
+            break;
+        }
+        if (committed === view.revision)
             throw MemoryError.revisionMismatch(id, expectedRevision, view.revision);
-        return view;
+        throw MemoryError.stagedRevisionMismatch(id, expectedRevision, view.revision, committed);
     }
     apply(operation) {
         switch (operation.action) {

package/node_modules/@openvulcan/dsh-vulcan-memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openvulcan/dsh-vulcan-memory",
-  "version": "0.4.0",
+  "version": "0.4.4",
   "description": "Long-term Markdown memory for DeepSeek Harness, ported from VulcanCode: memory tools for the model, a per-conversation memory snapshot, the memory-curator skill and a memory page with import and export.",
   "license": "MIT",
   "icon": "./assets/memory-icon.png",

package/node_modules/@openvulcan/dsh-vulcan-reasoning/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenVulcan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.