Skip to content

Commit 996fd3d

Browse files
authored
Merge pull request #97 from Cobb04/fix/dsh-rc8-session-evidence
fix(session-analysis): qualify and harden DSH evidence for rc.8
2 parents a73519b + 53534b2 commit 996fd3d

11 files changed

Lines changed: 1218 additions & 115 deletions

docs/adapters/README.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ project `.kimi-code/skills/`), then runs `/skill:better-harness`.
4444
| 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 |
4545
| 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 |
4646
| 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 |
47-
| 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>]` |
47+
| 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>]` |
4848

4949
## Read-only Plugin Lifecycle
5050

@@ -198,13 +198,17 @@ edit host settings, or register an `apply` path.
198198
`<home>/sessions`. Discovery is read-only and accepts only the fixed nested
199199
`session.jsonl` or `session.jsonl.zstd` layout. Workspace qualification uses
200200
only the format-0 header's absolute `cwd`; the lossy project directory is not
201-
workspace evidence. Better Harness reports adapter metadata `dsh-v1` and
202-
supports native DSH session format `0` pinned to `dsh-v0.1.0-rc.7`. The host
203-
is registered only for the `sessionAnalysis` capability.
201+
workspace evidence. Better Harness reports adapter metadata `dsh-v1`; its
202+
format-0 session-evidence slice is validated against `dsh-v0.1.0-rc.7` and
203+
`dsh-v0.1.0-rc.8`, including RC8 interrupted assistant messages and the
204+
required team-event vocabulary. The host is registered only for the
205+
`sessionAnalysis` capability; team events are validated and accounted, not
206+
projected as team analytics.
204207
Known-but-unsupported events and unknown ignorable events are explicitly
205208
accounted for. Unknown required events, malformed records, identity drift,
206-
and unsupported versions fail closed; an open trailing turn remains
207-
incomplete. Bounded source distinctions are retained without copying
209+
committed corruption, and unsupported versions fail closed; an uncommitted
210+
raw row or incomplete final Zstandard frame preserves only the prior
211+
committed prefix and remains incomplete. Bounded source distinctions are retained without copying
208212
arbitrary plugin data or inferring plugin ownership, causality, or faults.
209213
Compressed artifacts are concatenated independently checksummed Zstandard
210214
frames and are scanned and decompressed one complete frame at a time. The

docs/docs/hosts/adapter-matrix.md

Lines changed: 14 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -121,12 +121,15 @@ smoke is observed.
121121
### DeepSeek Harness (DSH) {#deepseek-harness-dsh}
122122

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

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

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

0 commit comments

Comments
 (0)