dsh-plugin-longgraph

Readme

# dsh-plugin-longgraph

English · [简体中文](README.zh-CN.md)

Community **DeepSeek Harness** plugin that registers the longgraph authoring
skills on `ctx.skills`.

> Community plugin. Not affiliated with or maintained by DeepSeek AI.

This package is **DeepSeek Harness only**. It does not install or launch
nodes on any other product.

[longgraph](https://github.com/levi-qiao/longgraph-skill) is a prompt
library for long-horizon agent work: an executor node, a ledger, and a
clean-context supervisor connected by a one-way directives edge. Each
node owns one timer. There is no wake edge between them. This plugin
does not add an agent runtime — it exposes that library through the
Harness skill seam.

## Skills

After the plugin loads, `ctx.skills.list()` / `snapshot()` advertise:

| Name | Role |
| --- | --- |
| `longgraph` | Fit check, then hand off to `loop-graph` |
| `loop-graph` | Interview → compile `.longgraph/<date-slug>/` → launch or print DSH prompts |
| `loop-converge` | Code-convergence preset, then the same compile |

`get` / the model-facing `skill({ name })` path returns the full instruction
body. `resourceBase` points at the packaged skill directory so templates
and [`references/deepseek-harness.md`](skills/loop-graph/references/deepseek-harness.md)
resolve.

## Install

DeepSeek Harness is in developer preview. This plugin pins
`@deepseek-ai/dsh-skill` `>=0.1.0-rc.5 <0.2.0` and is tested against
the public `0.1.0-rc.6` line.

### Profile bundle (recommended)

```sh
dsh plugin --profile web add github:levi-qiao/dsh-plugin-longgraph
dsh --profile web
```

Then invoke `skill({ name: "longgraph" })` (or `loop-graph` /
`loop-converge`).

`package.json` declares `dsh.bundle.patch`. The shipped
`cordis.patch.yml` inserts one row named `dsh-plugin-longgraph`. Profile
composition applies that layer before the profile's own patch.

Pin a git commit when you want a frozen install:

```sh
dsh plugin --profile web add github:levi-qiao/dsh-plugin-longgraph#<commit>
```

Git installs fetch source, so `prepare` runs `tsdown`. With pnpm 10+, add
the package to the profile `pnpm-workspace.yaml` build allowlist if pnpm
blocks `prepare`, then retry.

### Direct Cordis row

```yaml
- id: longgraph-skills
  name: dsh-plugin-longgraph
```

The plugin `inject`s `skills` and calls `ctx.skills.registerProvider`.
It has no runtime config.

## Timers on DeepSeek Harness

Two independent **root sessions**, two `schedule_create` clocks:

- `every_seconds` floor is 300 (five minutes).
- Schedule is session-local — both sessions must stay live.
- A busy session waits until idle, then `followup()`. The timer does not
  interrupt a fire.
- Never `followup()` / `inject()` the other session. The executor reads
  new directives on its next fire.

See [the host reference](skills/loop-graph/references/deepseek-harness.md).

## Compatibility

| Peer | Range |
| --- | --- |
| `@deepseek-ai/cordis` | `>=4.0.1 <5` |
| `@deepseek-ai/dsh-skill` | `>=0.1.0-rc.5 <0.2.0` |

Harness remains a developer preview. Compatibility-breaking changes will
require a new plugin version.

## Development

```sh
pnpm install
pnpm typecheck
pnpm test
pnpm build
pnpm integration
```

`pnpm test` loads the shipped `apply` against a real `@deepseek-ai/dsh-skill`
`SkillRegistry` and reads the packaged `SKILL.md` files. `pnpm integration`
boots the same plugin through the public Cordis Loader.

## What this is not

- Not a DeepSeek AI product and not an official Harness bundle.
- Not a replacement for `dsh-agent-loop`, Schedule, Jobs, or the Web UI.
- Not a multi-host skill pack. The sibling
  [longgraph-skill](https://github.com/levi-qiao/longgraph-skill) repo
  remains the multi-host prompt library.

## License

[MIT](LICENSE) © 2026 levi-qiao