ICCuse/dsh-premise-guard

中文 | English

Post-compaction premise-drift guard. After a compaction/summary event, it extracts distinctive literal anchors (file paths, quoted literals, key=value pairs, error codes) from the shadowed span's text, checks whether the committed summary still contains them, and — when a critical anchor vanished — injects a one-shot notice into the next step telling the model what it may have lost and how to recover it from the append-only log.

Why

Recall-oriented designs (recallable-compaction, session-query tools) make shadowed content reachable when suspected. Nothing says "you just dropped a key fact". This guard turns the compaction summary into a checked handoff: the model learns the moment a path, value, or error string it was relying on is no longer in the summarized context.

How it works

Hook	Role
session/event (compaction/summary)	Re-derives the shadowed span's text from shadowedSeqs (the log keeps every byte), extracts anchors, and compares against event.data.summary.
agent/pre-step	Injects one notice (plugin source) naming up to maxAnchors vanished anchors and the shadowed seq range, once per alarm; a new user prompt skips delivery.

Anchor extraction is deterministic and pure — no LLM calls, no new storage.

Config

Field	Default	Meaning
maxAnchors	5	Vanished anchors named in one notice.
minAnchorLength	6	Anchors shorter than this are never critical.
maxNoticeChars	400	Notice text cap.

All three must be integers >= 1; misconfiguration throws at plugin load.

Install

Not on npm yet - install from this repository:

npm install github:ICCuse/dsh-premise-guard
# or: pnpm add github:ICCuse/dsh-premise-guard

Then mount the bundle (declared in package.json 'dsh.bundle'):

- id: dsh-premise-guard
  name: 'dsh-premise-guard'

Or, once published, 'dsh plugin --profile web add dsh-premise-guard'.