# deepseek harness-plugins

**Repository Path**: pulind/deepseek-harness-plugins

## Basic Information

- **Project Name**: deepseek harness-plugins
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-01
- **Last Updated**: 2026-09-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# deepseek-memory

DeepSeek Harness (dsh) memory plugins: **short-term (session working memory)** and **long-term (cross-session durable memory)** systems, built as native Cordis plugins.

The long-term design is a layered model — per-session **episodes** consolidate into **knowledge** and **rules** — with deterministic consolidation on the session-end hot path and periodic LLM refinement for knowledge/rule evolution.

## Packages

| Package | Role |
|---|---|
| `packages/dsh-memory-core` | Domain model, zod record schemas, deterministic engine (dedup/conflict/confidence/decay), ranking, keys |
| `packages/dsh-memory-short-term` | Session working memory plugin: `memory_note` / `memory_recall` / `memory_clear` |
| `packages/dsh-memory-long-term` | Cross-session memory plugin: episodes + facts (knowledge/rules), consolidation, retrieval, confirmation gate, maintenance |

## Status

- **P0** (framework + conventions): in progress
- **P1** (short-term): scaffold verified, lifecycle tests + L1 cards
- **P2** (long-term deterministic layer): done
- **P3** (LLM periodic refinement): shipped (2026-09-01) — `memory_maintain` tool, maintenance pipeline, serial write tools, and `memory_remember` desensitization
- **P4** (external storage + scope isolation): shipped (2026-09-02) — optional PostgreSQL backend (`storage.backend: postgres`), per-project memory isolation via `.git`-root project hashing, and a default visible view of project + global + user

## Docs

- [Deployment guide](DEPLOY.md) — install the plugins into a dsh profile (verified commands)
- [Design spec](docs/superpowers/specs/2026-09-01-memory-system-design.md) — the approved architecture
- [P4 spec: external storage & scope isolation](docs/superpowers/specs/2026-09-02-p4-external-storage-and-scope-isolation-design.md) — PostgreSQL backend + project isolation
- [Implementation plans](docs/superpowers/plans/) — task-by-task plans
- [Research: agent memory survey](docs/research/agent_memory_research_report.md) — 33-paper overview
- [Research: short/long-term classification & conflicts](docs/research/agent_memory_classification_report.md)
- [Research: PISA deep dive](docs/research/pisa_deep_dive.md) — Piagetian adaptation for rule evolution

## Quick start

```sh
pnpm install
pnpm build && pnpm typecheck && pnpm test
```

To install the plugins into a dsh profile (`dsh` CLI required):

```sh
node scripts/dev-install.mjs            # install into $DSH_HOME/profiles/dev
node scripts/dev-install.mjs --remove   # uninstall
```