@geml/dsh-plugin 1.0.2 → 1.0.4

package/LICENSE

@@ -1,28 +1,27 @@
-MIT License
-
-Copyright (c) 2026 GEML contributors
-
-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.
-
----
-
-NOTE: This MIT license covers the *code* in this repository (geml-parser/,
-integrations/geml-viewer/, integrations/geml-check-action/, docs/examples/
-tooling). The *specification* documents are licensed separately under
-CC-BY-4.0 — see LICENSE-spec.md.
+MIT License
+
+Copyright (c) 2026 GEML contributors
+
+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.
+
+---
+
+NOTE: This MIT license covers the *code* in this repository (geml-parser/,
+integrations/geml-viewer/, integrations/geml-check-action/, playground/). The *specification* documents are licensed separately under
+CC-BY-4.0 — see LICENSE-spec.md.

package/README.md

@@ -1,69 +1,69 @@
-# @geml/dsh-plugin — GEML for DeepSeek Harness
-
-English | [中文](README.zh.md)
-
-This plugin brings **Agent-Native** document handling to the harness. Multi-turn
-work drowns in token bloat — whole files read in, whole files written back,
-content growing verbose and drifting from the truth.
-[GEML](https://github.com/geml-spec/geml) exposes a document as **addressable
-blocks** an LLM can reason about and edit precisely: one section in, one section
-back, at a fraction of the tokens, leaving the context window for the actual
-work. A built-in **reference** mechanism keeps a **single source of truth**, so
-facts stop fragmenting across copies and an agent maintains docs at zero
-overhead.
-
-The bundle ships three things:
-
-- **The GEML MCP server** — one `@deepseek-ai/dsh-mcp-client` row running
-  `npx -y @geml/geml mcp --root .`, confined to the session's project
-  directory. The model sees `mcp__geml__geml_get`, `mcp__geml__geml_set`,
-  `mcp__geml__geml_check` and friends, so it edits one block at a time instead
-  of rewriting files.
-- **The authoring skill** (`skills/geml/`) — golden rules, validation loop, and
-  a sectioned reference (`references/authoring.geml`) the agent pulls one topic
-  at a time.
-- **The code-graph skill** (`skills/geml-code-graph/`) — build, view, update and
-  navigate a project's call graph: who calls X, what X calls, impact paths, with
-  the graph rendered in the browser.
-
-The bundle carries no code of its own — both plugins it configures ship inside
-the dsh installation, and the skills are Markdown. Nothing is built at install
-time, so no `allowBuilds` approval is involved either way.
-
-## Install
-
-```sh
-dsh plugin --profile web add @geml/dsh-plugin
-```
-
-Verify the layer without booting, then boot:
-
-```sh
-dsh --profile web --dump-config   # shows a "# == @geml/dsh-plugin" layer
-dsh --profile web
-```
-
-`dsh plugin --profile web remove @geml/dsh-plugin` removes both the
-dependency and the layer.
-
-## Configuration
-
-Both rows are ordinary configuration: override them by `id` in your profile's
-`cordis.patch.yml`, restating every key the row needs. Point `mcp-geml` at a
-pinned CLI version, for instance:
-
-```yaml
-- id: mcp-geml
-  name: '@deepseek-ai/dsh-mcp-client'
-  config:
-    serverName: geml
-    transport: stdio
-    command: npx
-    args: ['-y', '@geml/geml', 'mcp', '--root', '.']
-```
-
-A global `geml` on PATH works as well — `command: geml`, dropping the `npx`
-arguments.
-
-The CLI and the same skills for Claude Code instead: `npx -y @geml/geml skill
-install`, or the plugin under [`../claude-plugin`](../claude-plugin).
+# @geml/dsh-plugin — GEML for DeepSeek Harness
+
+English | [中文](README.zh.md)
+
+This plugin brings **Agent-Native** document handling to the harness. Multi-turn
+work drowns in token bloat — whole files read in, whole files written back,
+content growing verbose and drifting from the truth.
+[GEML](https://github.com/geml-spec/geml) exposes a document as **addressable
+blocks** an LLM can reason about and edit precisely: one section in, one section
+back, at a fraction of the tokens, leaving the context window for the actual
+work. A built-in **reference** mechanism keeps a **single source of truth**, so
+facts stop fragmenting across copies and an agent maintains docs at zero
+overhead.
+
+The bundle ships three things:
+
+- **The GEML MCP server** — one `@deepseek-ai/dsh-mcp-client` row running
+  `npx -y @geml/geml mcp --root .`, confined to the session's project
+  directory. The model sees `mcp__geml__geml_get`, `mcp__geml__geml_set`,
+  `mcp__geml__geml_check` and friends, so it edits one block at a time instead
+  of rewriting files.
+- **The authoring skill** (`skills/geml/`) — golden rules, validation loop, and
+  a sectioned reference (`references/authoring.geml`) the agent pulls one topic
+  at a time.
+- **The code-graph skill** (`skills/geml-code-graph/`) — build, view, update and
+  navigate a project's call graph: who calls X, what X calls, impact paths, with
+  the graph rendered in the browser.
+
+The bundle carries no code of its own — both plugins it configures ship inside
+the dsh installation, and the skills are Markdown. Nothing is built at install
+time, so no `allowBuilds` approval is involved either way.
+
+## Install
+
+```sh
+dsh plugin --profile web add @geml/dsh-plugin
+```
+
+Verify the layer without booting, then boot:
+
+```sh
+dsh --profile web --dump-config   # shows a "# == @geml/dsh-plugin" layer
+dsh --profile web
+```
+
+`dsh plugin --profile web remove @geml/dsh-plugin` removes both the
+dependency and the layer.
+
+## Configuration
+
+Both rows are ordinary configuration: override them by `id` in your profile's
+`cordis.patch.yml`, restating every key the row needs. Point `mcp-geml` at a
+pinned CLI version, for instance:
+
+```yaml
+- id: mcp-geml
+  name: '@deepseek-ai/dsh-mcp-client'
+  config:
+    serverName: geml
+    transport: stdio
+    command: npx
+    args: ['-y', '@geml/geml', 'mcp', '--root', '.']
+```
+
+A global `geml` on PATH works as well — `command: geml`, dropping the `npx`
+arguments.
+
+The CLI and the same skills for Claude Code instead: `npx -y @geml/geml skill
+install`, or the plugin under [`../claude-plugin`](../claude-plugin).

package/README.zh.md

@@ -1,60 +1,60 @@
-# @geml/dsh-plugin — DeepSeek Harness 上的 GEML
-
-[English](README.md) | 中文
-
-本插件为 harness 提供 **Agent-Native** 的文档处理能力。多轮交互最容易被 Token
-膨胀拖垮——整篇读进来、整篇写回去，内容越滚越臃肿，也越来越偏离事实。
-[GEML](https://github.com/geml-spec/geml) 把文档呈现为**可寻址的块**，让 LLM
-能精准理解与改写：取一个小节、写回一个小节，Token 只需零头，宝贵的上下文窗口
-留给真正的工作。内建的**引用机制**维持**单一数据源（Single Source of
-Truth）**，事实不再散落成互相漂移的副本，Agent 可以零负担地读写与维护。
-
-这个 bundle 带三样东西：
-
-- **GEML MCP server** —— 一行 `@deepseek-ai/dsh-mcp-client`，运行
-  `npx -y @geml/geml mcp --root .`，限定在会话自己的项目目录内。模型看到的是
-  `mcp__geml__geml_get`、`mcp__geml__geml_set`、`mcp__geml__geml_check` 等工具，
-  于是一次改一个块，而不是重写整个文件。
-- **写作技能**（`skills/geml/`）—— 黄金规则、校验闭环，以及一份分节的参考文档
-  （`references/authoring.geml`），Agent 按需取其中一节。
-- **代码图谱技能**（`skills/geml-code-graph/`）—— 构建、查看、更新和浏览项目的
-  调用图：谁调用了 X、X 调用了谁、影响路径，并在浏览器里渲染出图。
-
-这个 bundle 自身不含任何代码——它配置的两个插件都随 dsh 安装自带，技能则是
-Markdown。安装时不构建任何东西，因此完全不涉及 `allowBuilds` 构建授权。
-
-## 安装
-
-```sh
-dsh plugin --profile web add @geml/dsh-plugin
-```
-
-先不启动、只验证这一层，再启动：
-
-```sh
-dsh --profile web --dump-config   # 应能看到 "# == @geml/dsh-plugin" 这一层
-dsh --profile web
-```
-
-`dsh plugin --profile web remove @geml/dsh-plugin` 会同时移除依赖和这一层。
-
-## 配置
-
-两行都是普通配置：在你 profile 的 `cordis.patch.yml` 里按 `id` 覆盖即可，注意
-要把该行需要的每个键都重新写全。例如把 `mcp-geml` 钉到某个 CLI 版本：
-
-```yaml
-- id: mcp-geml
-  name: '@deepseek-ai/dsh-mcp-client'
-  config:
-    serverName: geml
-    transport: stdio
-    command: npx
-    args: ['-y', '@geml/geml', 'mcp', '--root', '.']
-```
-
-用 PATH 上的全局 `geml` 也可以——把 `command` 改成 `geml`，去掉 `npx` 那几个
-参数。
-
-想要 CLI 和同一套技能用在 Claude Code 上：`npx -y @geml/geml skill install`，
-或使用 [`../claude-plugin`](../claude-plugin) 下的插件。
+# @geml/dsh-plugin — DeepSeek Harness 上的 GEML
+
+[English](README.md) | 中文
+
+本插件为 harness 提供 **Agent-Native** 的文档处理能力。多轮交互最容易被 Token
+膨胀拖垮——整篇读进来、整篇写回去，内容越滚越臃肿，也越来越偏离事实。
+[GEML](https://github.com/geml-spec/geml) 把文档呈现为**可寻址的块**，让 LLM
+能精准理解与改写：取一个小节、写回一个小节，Token 只需零头，宝贵的上下文窗口
+留给真正的工作。内建的**引用机制**维持**单一数据源（Single Source of
+Truth）**，事实不再散落成互相漂移的副本，Agent 可以零负担地读写与维护。
+
+这个 bundle 带三样东西：
+
+- **GEML MCP server** —— 一行 `@deepseek-ai/dsh-mcp-client`，运行
+  `npx -y @geml/geml mcp --root .`，限定在会话自己的项目目录内。模型看到的是
+  `mcp__geml__geml_get`、`mcp__geml__geml_set`、`mcp__geml__geml_check` 等工具，
+  于是一次改一个块，而不是重写整个文件。
+- **写作技能**（`skills/geml/`）—— 黄金规则、校验闭环，以及一份分节的参考文档
+  （`references/authoring.geml`），Agent 按需取其中一节。
+- **代码图谱技能**（`skills/geml-code-graph/`）—— 构建、查看、更新和浏览项目的
+  调用图：谁调用了 X、X 调用了谁、影响路径，并在浏览器里渲染出图。
+
+这个 bundle 自身不含任何代码——它配置的两个插件都随 dsh 安装自带，技能则是
+Markdown。安装时不构建任何东西，因此完全不涉及 `allowBuilds` 构建授权。
+
+## 安装
+
+```sh
+dsh plugin --profile web add @geml/dsh-plugin
+```
+
+先不启动、只验证这一层，再启动：
+
+```sh
+dsh --profile web --dump-config   # 应能看到 "# == @geml/dsh-plugin" 这一层
+dsh --profile web
+```
+
+`dsh plugin --profile web remove @geml/dsh-plugin` 会同时移除依赖和这一层。
+
+## 配置
+
+两行都是普通配置：在你 profile 的 `cordis.patch.yml` 里按 `id` 覆盖即可，注意
+要把该行需要的每个键都重新写全。例如把 `mcp-geml` 钉到某个 CLI 版本：
+
+```yaml
+- id: mcp-geml
+  name: '@deepseek-ai/dsh-mcp-client'
+  config:
+    serverName: geml
+    transport: stdio
+    command: npx
+    args: ['-y', '@geml/geml', 'mcp', '--root', '.']
+```
+
+用 PATH 上的全局 `geml` 也可以——把 `command` 改成 `geml`，去掉 `npx` 那几个
+参数。
+
+想要 CLI 和同一套技能用在 Claude Code 上：`npx -y @geml/geml skill install`，
+或使用 [`../claude-plugin`](../claude-plugin) 下的插件。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geml/dsh-plugin",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Agent-Native document handling for DSH — addressable blocks let an agent read and edit one section instead of the whole file. Ships the geml MCP server and the authoring and code-graph skills.",
   "license": "MIT",
   "homepage": "https://github.com/geml-spec/geml",