Content-addressed timeline, canon and character-knowledge evidence for DeepSeek Harness
Server defines 6 tools with explicit schemas and descriptions. However, descriptions are domain-specific and terse (avg ~80 chars), lacking LLM-optimized guidance on WHEN to use each tool or HOW to interpret results. Parameter descriptions exist but are minimal ('Narrative manifest JSON text'). No output schemas documented. Tools lack error recovery guidance. Naming is consistent (verb_noun pattern) but domain-jargon-heavy ('narrative_ledger_*', 'dsh_narrative_ledger_*'), which may confuse LLMs unfamiliar with narrative ledger concepts. No tool annotations (readOnlyHint, destructiveHint). One tool (dsh_narrative_ledger_verify) is marked WRITE but lacks confirmation/dry-run pattern.
Inspect story revision, entity/predicate schema and canon source hashes without returning prose.
Project active fact IDs and character knowledge IDs through a sequence number without returning canon prose.
Verify ordered events, canon hashes, fact lifecycle, contradictions and character knowledge; write one content-addressed structural report.
Inspect an inline narrative manifest without filesystem access or prose.
Project inline structural state through a sequence without filesystem access or prose.
Verify inline event structure and spoiler-safe projection; canon source bytes remain explicitly unobserved.
No output schemas documented. Tools return JSON but LLMs cannot predict field names, types, or structure. Downstream tool chaining is impossible without trial-and-error.
Descriptions lack LLM-optimized guidance. 'Inspect an inline narrative manifest without filesystem access or prose' (80 chars) does not explain WHEN to call this vs dsh_narrative_ledger_inspect, or what 'prose' means. Baseline: 194 chars avg for A+ tools.
dsh_narrative_ledger_verify is marked WRITE but lacks confirmation/dry-run pattern. Agents cannot preview changes before committing. No error recovery guidance if verification fails.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 53 | 2025-06-18+ | v2 |
Parameter descriptions are minimal. 'Workspace-relative path to narrative manifest file' does not explain format, constraints, or what happens if file is missing. No guidance on error recovery.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). LLMs cannot infer which tools are safe to retry or which modify state without reading descriptions.