Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 10 additions & 6 deletions docs/adapters/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ project `.kimi-code/skills/`), then runs `/skill:better-harness`.
| Kimi Code | Analysis-capable source-local host | `.kimi-plugin/plugin.json` | `scripts/agent-customize/providers/kimi.mjs` | `scripts/session-analysis/platforms/kimi.mjs` | self-contained HTML + Markdown | `AGENTS.md` + `~/.kimi-code/skills` + project `.kimi-code/skills`/`.kimi/skills` + `~/.kimi-code/mcp.json` | `harness evidence-bundle --platform kimi` -> validated `html` render |
| WorkBuddy | Analysis-capable source-local host | none (skills install into `~/.workbuddy/skills`) | `scripts/agent-customize/providers/workbuddy.mjs` | `scripts/session-analysis/platforms/workbuddy.mjs` | self-contained HTML + Markdown | `~/.workbuddy` `AGENTS.md` + identity files + `.agents` + `AGENTS.md` | `session-analysis --platform workbuddy sources` -> validated `html` render |
| Grok | Analysis-capable source-local host | none (skills install into `~/.grok/skills`) | `scripts/agent-customize/providers/grok.mjs` | `scripts/session-analysis/platforms/grok.mjs` | self-contained HTML + Markdown | `~/.grok` + `.grok` + `.agents` + `AGENTS.md` | `session-analysis --platform grok sources` -> skill symlink -> validated `html` render |
| DeepSeek Harness (DSH) | Partial session-evidence adapter (developer preview) | none / unavailable | unavailable | `scripts/session-analysis/platforms/dsh.mjs`; `dsh-v1` for DSH `dsh-v0.1.0-rc.7` session format `0`, raw `.jsonl` and feature-detected `.jsonl.zstd` | unavailable; no report route | unavailable | read-only `node scripts/session-analysis.mjs sources --platform dsh --workspace <path> [--dsh-home <dir>]` or `node scripts/session-analysis.mjs facts --platform dsh --workspace <path> [--dsh-home <dir>]` |
| DeepSeek Harness (DSH) | Partial session-evidence adapter (developer preview) | none / unavailable | unavailable | `scripts/session-analysis/platforms/dsh.mjs`; `dsh-v1` for the audited format-0 session-evidence slice from DSH `dsh-v0.1.0-rc.7` and `dsh-v0.1.0-rc.8`, raw `.jsonl` and feature-detected `.jsonl.zstd` | unavailable; no report route | unavailable | read-only `node scripts/session-analysis.mjs sources --platform dsh --workspace <path> [--dsh-home <dir>]` or `node scripts/session-analysis.mjs facts --platform dsh --workspace <path> [--dsh-home <dir>]` |

## Read-only Plugin Lifecycle

Expand Down Expand Up @@ -198,13 +198,17 @@ edit host settings, or register an `apply` path.
`<home>/sessions`. Discovery is read-only and accepts only the fixed nested
`session.jsonl` or `session.jsonl.zstd` layout. Workspace qualification uses
only the format-0 header's absolute `cwd`; the lossy project directory is not
workspace evidence. Better Harness reports adapter metadata `dsh-v1` and
supports native DSH session format `0` pinned to `dsh-v0.1.0-rc.7`. The host
is registered only for the `sessionAnalysis` capability.
workspace evidence. Better Harness reports adapter metadata `dsh-v1`; its
format-0 session-evidence slice is validated against `dsh-v0.1.0-rc.7` and
`dsh-v0.1.0-rc.8`, including RC8 interrupted assistant messages and the
required team-event vocabulary. The host is registered only for the
`sessionAnalysis` capability; team events are validated and accounted, not
projected as team analytics.
Known-but-unsupported events and unknown ignorable events are explicitly
accounted for. Unknown required events, malformed records, identity drift,
and unsupported versions fail closed; an open trailing turn remains
incomplete. Bounded source distinctions are retained without copying
committed corruption, and unsupported versions fail closed; an uncommitted
raw row or incomplete final Zstandard frame preserves only the prior
committed prefix and remains incomplete. Bounded source distinctions are retained without copying
arbitrary plugin data or inferring plugin ownership, causality, or faults.
Compressed artifacts are concatenated independently checksummed Zstandard
frames and are scanned and decompressed one complete frame at a time. The
Expand Down
23 changes: 14 additions & 9 deletions docs/docs/hosts/adapter-matrix.md
Original file line number Diff line number Diff line change
Expand Up @@ -121,12 +121,15 @@ smoke is observed.
### DeepSeek Harness (DSH) {#deepseek-harness-dsh}

DSH coverage is a developer-preview, JSONL-only session slice, with Better
Harness adapter metadata `dsh-v1` and native session format `0` pinned to DSH
`dsh-v0.1.0-rc.7`. Home resolution is strictly `--dsh-home` over `DSH_HOME`
over `~/.dsh`; the only source root is `<home>/sessions`. The adapter reads the
fixed nested `session.jsonl` or `session.jsonl.zstd` layout without writing or
repairing artifacts, and it qualifies a workspace only from the header's
absolute `cwd`. DSH is registered only for the `sessionAnalysis` capability.
Harness adapter metadata `dsh-v1`. Its format-0 session-evidence slice is
validated against DSH `dsh-v0.1.0-rc.7` and `dsh-v0.1.0-rc.8`, including RC8
interrupted assistant messages and required team-event vocabulary. Team events
are validated and accounted, not projected as team analytics. Home resolution
is strictly `--dsh-home` over `DSH_HOME` over `~/.dsh`; the only source root is
`<home>/sessions`. The adapter reads the fixed nested `session.jsonl` or
`session.jsonl.zstd` layout without writing or repairing artifacts, and it
qualifies a workspace only from the header's absolute `cwd`. DSH is registered
only for the `sessionAnalysis` capability.

Compressed artifacts are concatenated independently checksummed Zstandard
frames and are validated and decompressed one complete frame at a time. The
Expand All @@ -135,9 +138,11 @@ feature-detected. When it is unavailable, including Node.js 23.0 through 23.7,
compressed evidence is reported unavailable while independent raw JSONL
evidence remains readable; no fallback dependency is installed.
Known-but-unsupported and unknown ignorable events are accounted
for, while unknown required events, malformed data, identity drift, and
unsupported versions fail closed. Open trailing turns remain incomplete, and
the adapter does not infer plugin ownership, causality, or faults.
for, while unknown required events, committed corruption, identity drift, and
unsupported versions fail closed. Uncommitted final raw rows and structurally
incomplete final Zstandard frames preserve only the prior committed prefix and
remain incomplete. The adapter does not infer plugin ownership, causality, or
faults.

The implemented source-checkout smoke boundary is read-only:

Expand Down
Loading