dsh-instructions-policy 0.6.1 → 0.6.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.en.md +22 -0
  2. package/README.md +22 -0
  3. package/package.json +5 -2
package/README.en.md CHANGED
@@ -149,6 +149,23 @@ dsh plugin --profile web remove dsh-instructions-policy
149
149
 
150
150
  After uninstalling, the redirect disappears and DSH returns to the default instruction loader; instruction messages already written to session logs stay in the history.
151
151
 
152
+ ## Optional manual acceptance
153
+
154
+ To confirm the plugin is actually taking effect, download the [acceptance fixture](https://github.com/Angel-Hair/dsh-instructions-policy/releases/latest/download/instructions-fixture.zip) and follow the steps below. (The plugin itself does not depend on this fixture.)
155
+
156
+ <details>
157
+ <summary>Expand the manual acceptance steps</summary>
158
+
159
+ 1. Extract it into a standalone directory. (The parent directory must not contain files that could interfere with the test, such as `.git` or `AGENTS.md`.)
160
+ 2. In DSH, create a new task and choose the `/sub` directory under the extracted `/instructions-fixture`.
161
+ 3. Send the sample instruction below to the **AI session in that workspace**, or follow the A–F scenarios in the packaged `VERIFY.md`. (**Setting the reasoning effort to Low/High is recommended to avoid unnecessary cost.**)
162
+
163
+ Sample instruction:
164
+
165
+ > This session is for testing the `dsh-instructions-policy` plugin and is currently a fresh session. Current settings: [root file on/off/custom], [user-global root file on/off], [subdirectory append on/off]. Please confirm whether the state is correct. (Note: you only need to report the state; you do not need to fully understand how the plugin works.)
166
+
167
+ </details>
168
+
152
169
  ## Configuration
153
170
 
154
171
  <details>
@@ -198,6 +215,9 @@ Defaults live in [cordis.patch.yml](cordis.patch.yml). To change them, override
198
215
 
199
216
  ## Feedback
200
217
 
218
+ <details>
219
+ <summary>Expand the feedback</summary>
220
+
201
221
  The plugin ships no logging of its own: it keeps zero runtime dependencies and writes no files. Diagnostics go through DSH's logger to the terminal running `dsh web` (Cordis' console logger). There is no log directory under `~/.dsh`, and the session JSONL records session events only, not logger output — so the "logs" a report needs are those terminal lines.
202
222
 
203
223
  When filing an issue, include:
@@ -216,6 +236,8 @@ When filing an issue, include:
216
236
 
217
237
  Bar for a report: **reproducible** (steps), **versioned** (DSH + plugin + OS), **logged** (terminal output + `/instructions show`), **differential** (expected vs actual).
218
238
 
239
+ </details>
240
+
219
241
  ## License
220
242
 
221
243
  Released under the [Mozilla Public License 2.0](LICENSE); copyright and Exhibit A notice are in [NOTICE](NOTICE).
package/README.md CHANGED
@@ -148,6 +148,23 @@ dsh plugin --profile web remove dsh-instructions-policy
148
148
 
149
149
  卸载后重定向消失,DSH 恢复官方默认的指令加载;已经写进会话日志的指令消息仍留在历史里。
150
150
 
151
+ ## 可选的手工验收
152
+
153
+ 如果想确认插件功能是否真的生效,可以下载 [验收夹具](https://github.com/Angel-Hair/dsh-instructions-policy/releases/latest/download/instructions-fixture.zip),并按以下步骤测试。(插件本身不依赖这个夹具)
154
+
155
+ <details>
156
+ <summary>点击展开手工验收步骤</summary>
157
+
158
+ 1. 解压到一个独立目录。(父目录里不含有任意如 `.git`、`AGENTS.md` 等干扰测试的文件)
159
+ 2. DSH 新建工作区选解压出来的 `/instructions-fixture` 下的 `/sub` 目录。
160
+ 3. 参考下面给出的样本给**该工作区的AI会话**发送指令,或者按包内 `VERIFY.md` 执行 A–F 场景。(**建议思考强度设置为Low/High,以免造成不必要的开销**)
161
+
162
+ 参考指令:
163
+
164
+ > 本会话用于测试 `dsh-instructions-policy` 插件,目前为初始会话。当前设置为[开启/关闭根文件/自定义根文件],[开启/关闭]用户级根文件,[开启/关闭]子目录追加。你确认下状态对不对。(注意!你只需要汇报状况,不需要完全理解插件原理)
165
+
166
+ </details>
167
+
151
168
  ## 配置
152
169
 
153
170
  <details>
@@ -197,6 +214,9 @@ dsh plugin --profile web remove dsh-instructions-policy
197
214
 
198
215
  ## 反馈问题
199
216
 
217
+ <details>
218
+ <summary>点击展开约定目录</summary>
219
+
200
220
  本插件没有引入日志系统:它保持零运行时依赖、不写任何文件,诊断信息都通过 DSH 的 logger 输出到启动 `dsh web` 的终端(Cordis 的 console logger)。`~/.dsh` 下没有日志目录,会话 JSONL 也只记录会话事件、不含 logger 输出,所以反馈时需要的"日志"就是那段终端输出。
201
221
 
202
222
  提 issue 时请附上:
@@ -215,6 +235,8 @@ dsh plugin --profile web remove dsh-instructions-policy
215
235
 
216
236
  反馈标准:**能复现**(有步骤)、**有版本**(DSH + 插件 + OS)、**有输出**(终端日志 + `/instructions show`)、**有差异**(预期 vs 实际)。
217
237
 
238
+ </details>
239
+
218
240
  ## 许可
219
241
 
220
242
  本项目以 [Mozilla Public License 2.0](LICENSE) 授权;版权信息与 Exhibit A 声明见 [NOTICE](NOTICE)。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-instructions-policy",
3
- "version": "0.6.1",
3
+ "version": "0.6.5",
4
4
  "description": "Session-scoped policy for DSH workspace instructions: choose the root AGENTS.md, toggle user-global instructions, toggle subdirectory discovery.",
5
5
  "keywords": [
6
6
  "dsh",
@@ -39,7 +39,10 @@
39
39
  "build": "tsc -p tsconfig.build.json && node scripts/copy-client.mjs",
40
40
  "typecheck": "tsc -p tsconfig.json",
41
41
  "prepare": "tsc -p tsconfig.build.json && node scripts/copy-client.mjs",
42
- "test": "node tests/policy.test.mjs && node tests/projection.test.mjs && node tests/client.test.mjs && node tests/contract.test.mjs"
42
+ "test": "node tests/policy.test.mjs && node tests/projection.test.mjs && node tests/client.test.mjs && node tests/contract.test.mjs",
43
+ "fixture:check": "node scripts/fixture.mjs check",
44
+ "fixture:prepare": "node scripts/fixture.mjs prepare",
45
+ "fixture:pack": "node scripts/fixture.mjs pack"
43
46
  },
44
47
  "devDependencies": {
45
48
  "@types/node": "^24.3.0",