dongsheng123132/dsh-narrative-ledger
30Last commit Aug 14, 2026
dsh-narrative-ledger DSH plugin
DSH Narrative Ledger is a DSH plugin that provides a content-addressed, immutable ledger for story events and facts. It verifies event sequences, fact assertions, character knowledge, and detects contradictions, all without modifying manuscript prose. The plugin outputs deterministic JSON reports with SHA-256 read-back.
How to install the dsh-narrative-ledger DSH plugin
dsh plugin --profile web add github:dongsheng123132/dsh-narrative-ledgerCopying does not run this command. Review the repository and version before installing the dsh-narrative-ledger DSH plugin.
dsh-narrative-ledger DSH plugin data source
dsh-narrative-ledger DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-narrative-ledger DSH plugin can do
- Verifies content-addressed external canon sources without copying manuscript prose
- Enforces contiguous immutable event sequence and monotonic story time
- Detects single-value contradictions (e.g., two simultaneous locations)
- Tracks character knowledge acquired only through witnessing or participating in scenes
- Provides spoiler-safe projection at a given sequence number, returning only fact and knowledge IDs
- Generates deterministic content-addressed JSON reports with atomic publication and SHA-256 read-back
Where the dsh-narrative-ledger DSH plugin fits
- Validate story event chronology and causality in a narrative project
- Detect inconsistent character knowledge or fact retractions
- Generate auditable evidence of narrative continuity for team reviews
- Produce spoiler-safe projections to share partial story state without revealing secrets
- Integrate with CI pipelines to automatically verify narrative consistency on changes
Who the dsh-narrative-ledger DSH plugin is for
- Developers building interactive narratives on DeepSeek Harness
- Narrative designers requiring machine-verifiable story continuity
- Teams managing complex story worlds with many characters and facts
dsh-narrative-ledger DSH plugin limitations
- Read-only ledger: cannot write or modify story prose, chapters, or prompts
- Does not execute shell commands or make network requests
- Paths must remain inside workspaceRoot; symlinks are rejected
- Only explicit artifactDir may be written to (for reports)
- Requires Node.js 22+ and a DeepSeek Harness environment
dsh-narrative-ledger DSH plugin: from the repository README
Quoted from the dongsheng123132/dsh-narrative-ledger README, the upstream source of the dsh-narrative-ledger DSH plugin. Copyright remains with the original authors.
A read-only, verifiable story-state ledger for [DeepSeek Harness](https://github.com/deepseek-ai/DeepSeek-Harness). It is not a novel generator or writing-prompt wrapper. Existing tools such as Novel Director and InkOS manage writing workflows and rich story state; this plugin is the complementary evidence layer for machine-checkable continuity. ## What it verifies - content-addressed external canon sources without copying manuscript prose into reports; - contiguous immutable event sequence and monotonic story time; - explicit fact assertion and retraction with resolvable subject, predicate, value and source IDs; - single-value contradictions such as two simultaneous locations or mutually exclusive states; - character knowledge acquired only by witnessing an assertion or participating in a scene that communicates an active fact; - spoiler-safe projection at a sequence number, returning only fact IDs and knowledge IDs; - stale/missing canon, inactive fact communication and invalid retraction disclosure; - deterministic content-addressed JSON reports with atomic publication and SHA-256 read-back. The ledger rejects prose-, chapter-, draft-, prompt- and secret-shaped fields. Paths
Read the full READMERepository license: MIT
dsh-narrative-ledger DSH plugin questions
How do I install DSH Narrative Ledger?
Run the following command in your terminal: `dsh plugin --profile web add github:dongsheng123132/dsh-narrative-ledger`. This will install the plugin and make its tools available in your DeepSeek Harness environment. Make sure you have Node.js 22+ and DSH installed beforehand.
Can I use this plugin to write or edit story content?
No, DSH Narrative Ledger is a read-only ledger. It does not modify manuscript prose, chapters, drafts, or prompts. Its purpose is to verify and report on narrative continuity using predefined event and fact files. To write story content, you need other tools like Novel Director or InkOS.
What verification rules does the ledger enforce?
The ledger enforces several rules: event sequence must be contiguous and immutable; story time must be monotonic; fact assertions and retractions must have resolvable subject, predicate, value, and source IDs; character knowledge can only be acquired through witnessing or participating in scenes; single-value contradictions (e.g., two simultaneous locations) are detected; and all reports are deterministic with SHA-256 checksums.
How do I verify a narrative project with this plugin?
Use the `dsh-narrative-ledger verify` command with required arguments: specify workspace root, manifest file, events file, and artifact directory. For example: `dsh-narrative-ledger verify --workspace-root examples/basic --manifest narrative.manifest.json --events events.jsonl --artifact-dir artifacts`. The plugin will output a JSON report showing verification results.
Does this plugin support network requests or shell commands?
No, the plugin runs no shell commands and makes no network requests. All processing is local and file-based. This ensures security and reproducibility. The only file system write is to the explicitly specified artifact directory for reports.