dsh-llmwiki

When a dsh agent must persist external evidence, link synthesized pages back to their sources, and retrieve information entirely offline, dsh-llmwiki provides a deterministic local substrate. Inspired by Karpathy's llm-wiki.md concept, it separates storage, retrieval, and structural integrity from the agent's semantic judgment: the agent decides what to keep and how to organize it, while the plugin guarantees that the data is reproducible, verifiable, and auditable on the local filesystem.

Its core capabilities rest on four pillars. Source records are identified by their SHA-256 content hash and are never mutated or deleted once written. Markdown page frontmatter must reference existing source IDs, creating a traceable link between synthesized content and its evidence. Search ranks page sections by a deterministic BM25-style score over a derived index that rebuilds itself when stale, yielding reproducible results. Structural lint validates files, links, canonical format, and index state without making any semantic judgment. Every read and write stays on the local filesystem; symbolic links are rejected, paths are confined to the wiki root, and no service, tool, command, or catalog operation ever makes a model or network call.

It suits developers building local knowledge bases inside dsh agent workflows, teams that need an agent to persist cited evidence and support offline retrieval, and anyone who values deterministic behavior where identical inputs always produce identical outputs. The plugin does not perform content moderation or automatic summarization; semantic curation and page organization remain the responsibility of the agent's system or user instructions.