@skyf0xx/hedgehog-core-deepseek-harness 0.2.7 → 0.2.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/agents/harness-eng.md
CHANGED
|
@@ -90,15 +90,16 @@ overlay points straight at raw `.ts` source.
|
|
|
90
90
|
advisory only — never wire it into a `verify` command, and never let
|
|
91
91
|
it block a layer.
|
|
92
92
|
|
|
93
|
-
**Pin, exactly:** `@deepseek-ai/dsh` and `@deepseek-ai/dsh-tools`
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
93
|
+
**Pin, exactly:** `@deepseek-ai/dsh` and `@deepseek-ai/dsh-tools` share one
|
|
94
|
+
pin; `@deepseek-ai/cordis` is versioned **independently**, not on DSH's rc
|
|
95
|
+
cadence — do not assume the three share one version just because two of
|
|
96
|
+
them do. See `workspace/package.json` for the exact pinned versions
|
|
97
|
+
currently in effect.
|
|
97
98
|
|
|
98
99
|
## Report friction aggressively
|
|
99
100
|
|
|
100
|
-
DSH
|
|
101
|
-
|
|
101
|
+
Given DSH's pace of change (see root `CLAUDE.md`'s constants section),
|
|
102
|
+
call `hedgehog friction add "<note>" [--task <task-id>]` prominently and
|
|
102
103
|
often — every time you hit a breaking rc change, undocumented CLI
|
|
103
104
|
behavior, an `apply(ctx)` signature that doesn't match the skill's
|
|
104
105
|
catalog, or a manifest shape that's shifted from what's documented. This
|
|
@@ -208,10 +209,12 @@ the layer.
|
|
|
208
209
|
it at its source — the Correction Protocol, not a workaround layered on
|
|
209
210
|
top.
|
|
210
211
|
- You may be one of several agents building concurrently, each holding a
|
|
211
|
-
lease on its own task and scoped to its own ALLOWED SCOPE
|
|
212
|
-
outside your scope changing while you work is
|
|
213
|
-
likely another plugin's
|
|
214
|
-
not a stray edit to fix
|
|
212
|
+
lease on its own task and scoped to its own ALLOWED SCOPE by `hedgehog
|
|
213
|
+
claim` — a file outside your scope changing while you work is most
|
|
214
|
+
likely another plugin's task (given the module axis this core builds
|
|
215
|
+
along), not a stray edit to fix, but scopes aren't guaranteed disjoint:
|
|
216
|
+
if you're unsure whether a change is really outside your task, report
|
|
217
|
+
it rather than assuming. Never edit, revert, or "clean up" a file
|
|
215
218
|
outside your own scope, and never run a repo-wide command (a formatter
|
|
216
219
|
over the whole workspace, `pnpm -r` with side effects, a codemod) unless
|
|
217
220
|
it is exactly the packet's VERIFICATION command — it doesn't respect
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@skyf0xx/hedgehog-core-deepseek-harness",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.9",
|
|
4
4
|
"description": "Hedgehog's deepseek-harness core: a pinned DSH/Cordis plugin workspace, a tool-plugin generator, and the skills that drive building DeepSeek Harness plugins with Hedgehog's build discipline.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"scripts": {
|
|
@@ -8,10 +8,20 @@ description: Use whenever `harness-eng` is writing a DSH plugin's own TypeScript
|
|
|
8
8
|
`harness-eng` decides *which* shape a given plugin intent needs — that
|
|
9
9
|
judgment call belongs to the task, not to this skill. This skill covers
|
|
10
10
|
*how* to write each shape once chosen: the plugin's own TypeScript body,
|
|
11
|
-
catalogued against DSH's
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
11
|
+
catalogued against DSH's docs. It doesn't cover the bundle/manifest
|
|
12
|
+
wrapper (`package.json`'s `dsh.bundle`, `cordis.patch.yml`) that every
|
|
13
|
+
shape shares regardless of which one it implements — that's the
|
|
14
|
+
tool-plugin generator's concern, not this skill's.
|
|
15
|
+
|
|
16
|
+
**Verified against DSH tag `dsh-v0.1.0-rc.8`** (`docs/user/develop/framework/events.md`
|
|
17
|
+
and `service.md` at that tag), the same tag `workspace/package.json` pins
|
|
18
|
+
`@deepseek-ai/dsh` and `@deepseek-ai/dsh-tools` to. This is the one owning
|
|
19
|
+
statement of which DSH revision this skill's catalog was checked against —
|
|
20
|
+
every confirmed-event, confirmed-signature, and "doesn't exist" claim
|
|
21
|
+
below is only guaranteed true as of that tag. A re-pin to a newer `rc` or
|
|
22
|
+
stable tag needs this skill's claims re-checked against the new tag's own
|
|
23
|
+
docs before the pin line above is updated to match; don't bump the pin in
|
|
24
|
+
`workspace/package.json` without also re-verifying this file.
|
|
15
25
|
|
|
16
26
|
## v0.1 generator coverage: tool shape only
|
|
17
27
|
|
|
@@ -127,7 +137,7 @@ exposing a new callable. Registers on a Cordis event or a durable
|
|
|
127
137
|
session-event type via `ctx.on`, inside function-form `apply`.
|
|
128
138
|
|
|
129
139
|
**Confirmed Cordis-level events** (per `docs/user/develop/framework/events.md`
|
|
130
|
-
|
|
140
|
+
at the tag pinned above): `agent/step`, `agent/request`,
|
|
131
141
|
`agent/request-error`, `tools/result`, `session/event`.
|
|
132
142
|
|
|
133
143
|
**Confirmed durable session-event types** (delivered through the
|
|
@@ -197,7 +207,7 @@ confirmed event or a different shape instead.
|
|
|
197
207
|
A plugin that drives interactive input or contributes to the built-in Web
|
|
198
208
|
Client, rather than registering a tool or a passive hook. Per DSH's own
|
|
199
209
|
docs, this shape is real but less stable than the tool shape — the docs
|
|
200
|
-
|
|
210
|
+
at the tag pinned above describe it only at the level below, with no full
|
|
201
211
|
worked example:
|
|
202
212
|
|
|
203
213
|
- Registers on `session/event` the same way a hook plugin does (see
|
|
@@ -205,11 +215,11 @@ worked example:
|
|
|
205
215
|
step, tool-call, and compaction activity as it streams.
|
|
206
216
|
- Drives input via `agent.followup()` / `agent.steer()` — named in DSH's
|
|
207
217
|
docs as the mechanism a UI plugin uses to inject or redirect input, but
|
|
208
|
-
no full signature or code example for either call was present
|
|
209
|
-
|
|
218
|
+
no full signature or code example for either call was present at that
|
|
219
|
+
tag.
|
|
210
220
|
- Can contribute a `ConversationNodeDefinition` to the built-in Web
|
|
211
221
|
Client — named as a real extension point, but again with no worked
|
|
212
|
-
example
|
|
222
|
+
example at that tag.
|
|
213
223
|
|
|
214
224
|
**Honesty note:** treat `agent.followup()`, `agent.steer()`, and
|
|
215
225
|
`ConversationNodeDefinition` as confirmed to exist by name, but not
|
|
@@ -275,7 +285,7 @@ Dependency handling:
|
|
|
275
285
|
**Honesty note (correcting an assumption, not the docs):** this shape is
|
|
276
286
|
sometimes described as going through a `ctx.provide()` call. That call
|
|
277
287
|
does not appear anywhere in DSH's `docs/user/develop/framework/service.md`
|
|
278
|
-
|
|
288
|
+
at the tag pinned above — the only provisioning mechanism documented
|
|
279
289
|
there is extending `Service` and calling `super(ctx, name)`, as shown
|
|
280
290
|
above. Don't write `ctx.provide(...)` into a plugin on the assumption
|
|
281
291
|
it's the real API; use the `Service` subclass form, and if a future task
|
|
@@ -39,10 +39,11 @@ Everything under this package's `workspace/`, copied to the repo root:
|
|
|
39
39
|
`smoke`, `bundle`, `join`) every plugin intent runs through, one intent
|
|
40
40
|
per plugin.
|
|
41
41
|
- `package.json` — pinned dependencies: `@deepseek-ai/dsh` and
|
|
42
|
-
`@deepseek-ai/dsh-tools`
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
42
|
+
`@deepseek-ai/dsh-tools` share one pin, `@deepseek-ai/cordis` is pinned
|
|
43
|
+
independently of DSH's `rc` cadence — the three packages do not share
|
|
44
|
+
one tag, and the pin reflects that; don't "simplify" them onto a single
|
|
45
|
+
version during a later bump. See `workspace/package.json` for the exact
|
|
46
|
+
pinned versions currently in effect.
|
|
46
47
|
- `pnpm-workspace.yaml` — `packages: ["plugins/*"]`.
|
|
47
48
|
- `plugins/` — empty except for a `.gitkeep`. The first plugin lands
|
|
48
49
|
later, generated (not hand-written) by `pnpm generate:tool <name>`.
|
|
@@ -242,9 +242,9 @@ working by a command's exit code.
|
|
|
242
242
|
|
|
243
243
|
## Friction log
|
|
244
244
|
|
|
245
|
-
DSH
|
|
246
|
-
|
|
247
|
-
|
|
245
|
+
Given DSH's pace of change (root `CLAUDE.md`'s constants section), this is
|
|
246
|
+
one of the most frequently invoked instructions in this file, not a
|
|
247
|
+
footnote: **call
|
|
248
248
|
`hedgehog friction add "<note>" [--task <task-id>]` on any DSH breaking
|
|
249
249
|
change, undocumented CLI or manifest behavior, or a manifest shape that
|
|
250
250
|
shifted from what an earlier layer assumed** — a `--dump-config` flag
|