dsh-engramory 0.2.2 → 0.2.5

package/README.md

@@ -115,6 +115,16 @@ newline, so an index sitting exactly at the cap stays writable.
   skill registry). The test mock now mirrors the reflective-context access rules, and
   the guard's decision table stays covered by `node --test` (28 cases, run in
   Engramory's CI).
+- **Checked against the dsh you are likely running, not only the one it was written
+  on.** `tests/dsh_e2e/run.py` in the Engramory repo installs a dsh release into a
+  throwaway prefix, adds this plugin with `dsh plugin add`, and drives one headless
+  task against a scripted stand-in for the DeepSeek API: a 260-line write and an edit
+  past the cap must come back refused by this guard with nothing reaching the disk, a
+  small write must land byte for byte, the skill must be advertised, every tool dsh
+  offers must already be classified (a new one could write past the cap), and removal
+  must leave a profile that still boots. The releases it passed on are listed in
+  `package.json` under `dsh.compatibility.dshReleases`; a unit test rejects a
+  `compatible` there without a recorded run of the same plugin version and code.
 - dsh is a developer preview and its plugin API can change. This plugin deliberately
   touches only `ctx.tools.guard()` and a reactive `ctx.inject(['skills'], …)` child
   that registers the skill, so it stays cheap to fix.

package/README.zh-CN.md

@@ -103,6 +103,13 @@ dsh plugin --profile <名字> add dsh-engramory
   内置的 `@deepseek-ai/cordis` 解析器验过(注册表存在、不存在、以及晚挂载三种情况下的激活)。
   测试用的 mock 现在会照着反射式上下文的访问规则来,守卫的判决表则由 `node --test`
   持续覆盖(28 个用例,在 Engramory 的 CI 里跑)。
+- **验的是你大概率正在用的 dsh,不只是写它时的那一版。** Engramory 仓库里的
+  `tests/dsh_e2e/run.py` 会把指定的 dsh 版本装进临时目录,用 `dsh plugin add` 装上本插件,
+  再对着一个脚本化的 DeepSeek API 替身跑一次 headless 任务:260 行的整文件写入、把索引撑过
+  上限的 edit,都必须被本守卫拒绝,而且磁盘上什么都没变;小写入必须逐字节落盘;skill 必须出现
+  在发给模型的技能目录里;dsh 提供的每个工具都必须已经归过类(没归类的新工具可能绕过上限写文件);卸载后
+  profile 必须还能启动。通过的版本逐个写在 `package.json` 的 `dsh.compatibility.dshReleases`
+  里;没有同一插件版本、同一份代码的通过记录,单元测试就不接受把它标成 `compatible`。
 - dsh 目前是开发者预览版,插件 API 可能变化。本插件刻意只碰 `ctx.tools.guard()` 和一个
   注册 skill 的响应式 `ctx.inject(['skills'], …)` 子上下文,所以要跟着改也很便宜。
 

package/index.js

@@ -97,11 +97,20 @@ export function apply(ctx, config = {}) {
         name: 'engramory',
         description:
           'Curated file-based long-term memory: recall through MEMORY.md at the start of ' +
-          'a task, save durable user/feedback/project/reference facts, and sync before ' +
-          'compacting or opening a fresh thread.',
+          'a task, save durable user/feedback/project/reference facts, run a curation ' +
+          'checkpoint when a task finishes, and sync before compacting or opening a ' +
+          'fresh thread. A turn that starts no work — a greeting, an acknowledgement — ' +
+          'is not a task and needs none of this, but never judge that by length: a ' +
+          'one-word reply continuing work underway inherits that task.',
         whenToUse:
           'Starting or resuming work, learning something durable worth a future session, ' +
-          'or approaching a compact/clear/new-thread boundary.',
+          'finishing a task — including one that leaves nothing worth saving, since the ' +
+          'checkpoint is still a decision to make — or approaching a ' +
+          'compact/clear/new-thread boundary. Not for a bare greeting, ' +
+          'acknowledgement, or reaction, which starts no task — but a terse reply ' +
+          'that continues work underway does, and material already in hand (a ' +
+          'pasted diff to review) does not make work a non-task. Unsure? Treat it ' +
+          'as a task.',
         source: 'runtime',
         content: skill,
       }))
@@ -364,10 +373,23 @@ function builtinSkillBody() {
     '',
     'One canonical store: `MEMORY.md` is an index of pointers, one line per memory;',
     'each fact lives in its own small markdown file beside it. Never put content in',
-    'the index, and never keep a second parallel store for handoffs.',
+    'the index, and never keep a second parallel store for handoffs. The ACTIVE',
+    'store is flat — the four type names are values of the `type:` field, not',
+    'subdirectories to create; `archive/` is the one reserved subdirectory, for',
+    'notes retired out of the index.',
     '',
     '## Recall',
     '',
+    'A turn, a message, or a session is NOT BY ITSELF a task: a greeting, an',
+    'acknowledgement, or a reaction starts none, so it gets no recall and no',
+    'checkpoint. A task is user-directed work whose CORRECT handling could depend',
+    'on what the store holds — read-only work (analysis, diagnosis, planning,',
+    'review)',
+    'counts, and changing a file is not required. HAVING THE MATERIAL IN HAND does',
+    'not make work a non-task: a diff pasted for review is still a task. NEVER INFER',
+    'THIS FROM LENGTH: a one-word reply that picks an option or carries on work',
+    'underway inherits that task. Still unclear? Treat it as a task.',
+    '',
     'At the start of a task, read the index and open only the notes whose hooks look',
     'relevant. Treat what you recall as background that may be stale: re-verify any',
     'file, flag, or version against the repo before acting on it.',
@@ -398,6 +420,21 @@ function builtinSkillBody() {
     '"the current version is X", the tip commit, or a passing test count will rot —',
     'record where to read those instead.',
     '',
+    'An unfinished task may keep AT MOST ONE live `project` note holding its goal,',
+    'status, decisions, constraints, blockers, and next step together — the single',
+    'exception to one-file-one-fact, and a ceiling rather than a quota: a task that',
+    'needs no resumable state keeps no note. Update it IN PLACE. Never a dated',
+    'series (`state-2026-01-15.md`, `state-2026-01-16.md`, …), never a second',
+    'handoff log indexed beside it, and retire its transient state once it ends.',
+    '',
+    '## When a task finishes',
+    '',
+    'Run one curation checkpoint. It is a judgement, not a write: promote what is',
+    'durable, retire the transient state the CURRENT task left on its own live',
+    '`project` note if it has one, and when nothing is worth keeping, write',
+    'nothing and say so. Never append a per-turn log TO THE STORE, and never touch',
+    'a file just to mark it fresh — a timestamp is not a memory.',
+    '',
     '## Sync',
     '',
     'Before a deliberate compact, clear, or new thread: scan the task, dedup and update,',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-engramory",
-  "version": "0.2.2",
+  "version": "0.2.5",
   "description": "Curated file-based long-term memory for DeepSeek Harness — human-readable markdown notes, one plain-file store shared across hosts (git-ignored when it lives inside a project repo), and a deterministic index cap enforced by ctx.tools.guard()",
   "keywords": [
     "dsh-plugin",
@@ -17,6 +17,15 @@
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "compatibility": {
+      "dsh": ">=0.1.0-rc.7 <0.2.0-0",
+      "dshReleases": {
+        "0.1.5-rc.3": "compatible",
+        "0.1.7-alpha.1": "compatible",
+        "0.1.7-alpha.2": "compatible",
+        "0.1.7-rc.1": "compatible"
+      }
     }
   },
   "exports": {
@@ -42,14 +51,6 @@
   "engines": {
     "node": ">=18"
   },
-  "peerDependencies": {
-    "@deepseek-ai/dsh-tools": ">=0.0.1-rc.1"
-  },
-  "peerDependenciesMeta": {
-    "@deepseek-ai/dsh-tools": {
-      "optional": false
-    }
-  },
   "publishConfig": {
     "access": "public"
   }