zhaoyuntao-wl/dsh-plugin-thread

dsh-thread

Thread's deep-integration plugin for DeepSeek Harness — session memory with lineage for coding agents, using the base's native channels end to end.

What it does

• Lossless capture — subscribes to session/event; the full event stream lands in dual SQLite databases with stable origins (idempotent append).
• Structural delivery, three triggers — a first-turn anchor (project identity
  • behavior contract + status card), a re-anchor after every compaction, and a cross-agent state delta at every turn boundary. No per-turn card noise. The design follows the deterministic-log line of memory research (e.g. arXiv:2605.21997 “The Log is the Agent”); the compaction re-anchor targets the “Compaction Cliff” failure mode (arXiv:2608.22752).
• Native query tool — query_session_memory registered through ctx.tools.register into the model's tool schema, with filesystem-style navigation ls / cd / cat / grep. The embedded MCP server remains as a fallback channel. Retrieval is deterministic BM25 over the lossless stream (jieba word segmentation for Chinese) with citation pull-back — no embedding dependency by default; a hybrid layer can be added at the integration boundary (evaluated against the BM25 baseline on the eval suite, not bundled).
• Behavior-contract skill — a thread skill is registered into the base's skill catalog ("need details → call the tool") and injected at anchors, so the model does not rely on memory to know it has memory.
• Output recognition — write/edit tools on markdown documents register knowledge_assets with lineage edges on write; /thread-reg ast covers explicit registration.
• Explicit decision & preference channels — decisions are recorded through /thread-reg dec (user, --supersedes <id> for chain evolution) or the model's record_decision tool (the behavior contract instructs the model to call it when the user settles a decision or it commits to one). Preferences and lessons are recorded through /thread-reg fdb (auto-classified as correction when phrased as "don't"). Natural-language extraction of decisions/preferences is off — zero text-heuristic false positives; the lossless event stream remains the backstop for anything unrecorded. (Goal detection from short imperative messages and completion detection stay on, guarded against pasted/multi-line text.)
• Closing sediment + inbox — closing words sediment in-progress goals into todos; /thread-cfm is the single pending-work inbox: todos (t#id) and candidates (c#id) in one view — do completes/promotes (candidates accept a corrected text), cnl discards, cnl all clears both. The status card surfaces the top candidates so they cannot pile up silently.
• Behavior notes (1.0, stated plainly) — candidates are not produced automatically: natural-language extraction of decisions/preferences is off, so c# entries only ever hold pre-existing rows until the post-release extraction layer arrives; todos are produced actively (closing sediment + goal-completion self-healing). Decisions never expire on their own — close out time-bound ones with --supersedes. Goal completion detection is conservative (≥4 non-ASCII / ≥8 pure-ASCII overlap; short English goals are missed rather than mis-judged — abandon them with /thread-rev gol). See the Thread README "Honest boundaries" section for the full list.
• Resource cleanup — /thread-rev <ast|dec|fdb|gol> <ids|all> revokes registrations: decisions/preferences/assets are deleted (the event stream keeps the text), goals are abandoned through the state machine with their todos self-healed. Every structured row carries a visible #id on the status card, so memory stays human-editable end to end.
• Session isolation — /thread-iso / /thread-uniso, and /thread-pub <ast|dec|fdb|gol> <ids|all> shares rows produced while isolated.
• Optional active compaction — with THREAD_AUTO_COMPACT=1 the plugin monitors token pressure at turn boundaries and triggers compactNow silently; state re-anchors after every compaction either way.
• Dev probe, inert by default — the package ships a batch0-probe module used for contract smoke-testing during development; it is inert unless THREAD_B0_PROBE=1 is set, so normal sessions are unaffected.