@hraness/wordcell 0.22.0 → 0.22.2

package/README.md

@@ -3,8 +3,11 @@
 
 [![Agent Skill](https://raw.githubusercontent.com/hraness/wordcell/main/assets/agent-skill.svg)](https://github.com/hraness/wordcell/tree/main/skills/wordcell)
 
-A local knowledge base for coding agents. Save decisions in Markdown and recover
-the context behind your code. Give the next session only the context it needs.
+A local Markdown knowledge base with superpowers. Save decisions, sources, and
+plans as files you own, then recover them through exact and semantic search,
+typed relationships, backlinks, and Git history. Coding agents get the context
+behind your code, and the same record holds everything else you need to
+remember.
 
 Your files stay yours: read them in Obsidian or any editor, review changes in
 Git, and rebuild every index from the Markdown. Exact search and graph queries
@@ -15,15 +18,18 @@ optional remote reranking have [separate privacy boundaries](#privacy-and-bounda
 
 ## Why Wordcell
 
-- **Keep decisions with the work.** Link a plan to the notes that explain it,
-  attach those notes to a code path, and recover their Git history on request.
+- **Keep what you learn in files you own.** Write decisions, sources, and plans
+  in Markdown. Obsidian, Git, and Wordcell read the same record, and every
+  index rebuilds from the files.
+- **Find it by words or by meaning.** Exact search needs no model or account.
+  Optional local semantic search joins each match to current metadata, links,
+  and history instead of returning isolated text.
+- **Author the connections.** Wikilinks and typed relationships turn notes into
+  a queryable ontology. Backlinks, bounded graph proofs, and percolation
+  suggestions recover them without injecting edges you did not write.
+- **Ground coding agents in context.** Scope notes to repository paths, recover
+  the commits behind a note, and give the next session only what it needs.
   Only context you save becomes part of the record.
-- **Read what matters.** Start with a code path, search result, or linked note.
-  Get a limited set of summaries and open the sources you need, instead of
-  loading the whole vault into an agent conversation.
-- **Keep control of your knowledge.** Markdown and Git are the source of truth.
-  Use local search, export selected notes as a static site, and keep using the
-  files even without Wordcell.
 
 Plain Markdown may be enough for a small set of notes. QMD is a good fit for
 local document retrieval and also supplies Wordcell's optional semantic search.
@@ -36,14 +42,14 @@ Git evidence, and selective publishing. [Compare the tradeoffs](https://github.c
 The CLI and TypeScript SDK run with Bun. Install the versioned GitHub archive:
 
 ```sh
-bun add --global --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.22.0/hraness-wordcell-0.22.0.tgz
+bun add --global --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.22.2/hraness-wordcell-0.22.2.tgz
 wordcell --help
 ```
 
 Prefer npm? The same release is [mirrored there](https://www.npmjs.com/package/@hraness/wordcell):
 
 ```sh
-npm install --global --ignore-scripts @hraness/wordcell@0.22.0
+npm install --global --ignore-scripts @hraness/wordcell@0.22.2
 wordcell --help
 ```
 
@@ -85,7 +91,7 @@ After trying the CLI, install the public Agent Skill into a compatible agent,
 such as Claude Code, Codex, Cursor, or GitHub Copilot:
 
 ```sh
-bunx skills add hraness/wordcell#v0.22.0 --skill wordcell
+bunx skills add hraness/wordcell#v0.22.2 --skill wordcell
 ```
 
 Then ask:
@@ -248,14 +254,26 @@ Markdown, YAML frontmatter, explicit wikilinks, and Git hold the record. Open
 the same files in Obsidian, a text editor, or ordinary file-search tools.
 Application code does not need to import Wordcell or its vault.
 
-QMD supplies optional local search. [Oh](https://oh.computer), the Hraness
-record and memory kernel ([source](https://github.com/hraness/oh)), is embedded
-as a derived graph authority behind an engine-neutral port: only an explicit
+Wordcell is the Markdown knowledge base. [Oh](https://oh.computer) is the
+embedded memory framework that backs its named graph queries and source proofs.
+Markdown and Git remain authoritative. Query the graph immediately without an
+Oh account, service, or persisted database:
+
+```sh
+wordcell graph query --program backlinks --note notes/parser-contract --root kb --json
+```
+
+The result traces each returned link to its source note and revision. Only an explicit
 `wordcell graph rebuild --root kb` writes `.wordcell/oh.sqlite`, the file stays
 ignored and rebuildable, and nothing flows from the projection back into notes.
 Backlinks and typed relationships come from authored links. Percolation
 suggests connections for review and does not add inferred edges to notes.
 
+Wordcell search combines its own exact matching with optional QMD local search
+and optional hosted Jev reranking. Oh also offers memory retrieval for applications;
+its conversation-memory benchmark scores measure that separate path. They do not
+establish Wordcell's retrieval or answer quality. [How the integration works](https://github.com/hraness/wordcell/blob/main/docs/graph-authority.md#how-wordcell-and-oh-fit-together).
+
 Graph proofs explain a supported derivation from a specific source revision.
 They do not prove that a note is true or that a missing relationship cannot
 exist. [Graph queries and proof limits](https://github.com/hraness/wordcell/blob/main/docs/graph-authority.md).
@@ -265,7 +283,7 @@ exist. [Graph queries and proof limits](https://github.com/hraness/wordcell/blob
 Add the same immutable release to a Bun project:
 
 ```sh
-bun add --exact --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.22.0/hraness-wordcell-0.22.0.tgz
+bun add --exact --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.22.2/hraness-wordcell-0.22.2.tgz
 ```
 
 The SDK provides read-only vault sessions, metadata queries, search, graph
@@ -289,8 +307,13 @@ show the public imports and lifecycle.
 
 ## Documentation
 
+The documentation follows the Diataxis split: a tutorial to learn the loop,
+how-to guides for tasks, reference for exact interfaces, and explanation for
+the design. Browse it on the [documentation index](https://wordcell.io/docs).
+
 | Read next | Purpose |
 | --- | --- |
+| [Get started](https://github.com/hraness/wordcell/blob/main/docs/getting-started.md) | Learn the full loop on a first vault: save, find, connect, and publish one note. |
 | [Agent workflow](https://github.com/hraness/wordcell/blob/main/docs/agent-workflow.md) | Set up, query, maintain, and revise repository memory. |
 | [Installation and command reference](https://github.com/hraness/wordcell/blob/main/docs/reference.md) | Exact interfaces, SDK imports, optional adapters, and troubleshooting prerequisites. |
 | [Web capture](https://github.com/hraness/wordcell/blob/main/docs/capture.md) and [PDF capture](https://github.com/hraness/wordcell/blob/main/docs/pdf.md) | Save sources with provenance, assets, and explicit completeness limits. |

package/dist/authoring.js

@@ -12,12 +12,14 @@ import {
   listNoteRelations,
   normalizeRelationPredicate,
   noteRevision,
-  removeNoteRelation
-} from "./index-6sw24nvv.js";
+  removeNoteRelation,
+  updateNoteBody
+} from "./index-ecqpgr5y.js";
 import"./index-3rm7cz6h.js";
-import"./index-ekpwvbra.js";
+import"./index-qbssx940.js";
 import"./index-z1w83f81.js";
 export {
+  updateNoteBody,
   removeNoteRelation,
   noteRevision,
   normalizeRelationPredicate,

package/dist/{authority-1pgftmwq.js → authority-06eqhqam.js}

@@ -3,7 +3,7 @@ import {
   GRAPH_LIMITS,
   GraphAuthorityError,
   validateGraphQueryRequest
-} from "./index-11621h23.js";
+} from "./index-tf4wzjew.js";
 import {
   validateRepositoryScopeSelection
 } from "./index-06c9ctr6.js";
@@ -11,7 +11,7 @@ import"./index-5vwpzb5a.js";
 import {
   isCanonicalNoteId,
   isCanonicalRelationPredicate
-} from "./index-ekpwvbra.js";
+} from "./index-qbssx940.js";
 import"./index-z1w83f81.js";
 
 // src/oh/authority.ts

package/dist/benchmark.js

@@ -4,13 +4,13 @@ import {
   createSyntheticRankFusionFixture,
   evaluateRanking,
   evaluateRetrievalBenchmark
-} from "./index-qwgsmtsz.js";
-import"./index-gm9t95d9.js";
+} from "./index-n386evxj.js";
+import"./index-vnybgywh.js";
 import"./index-d13v9ckt.js";
 import"./index-48pz4jpc.js";
 import"./index-06c9ctr6.js";
 import"./index-5vwpzb5a.js";
-import"./index-ekpwvbra.js";
+import"./index-qbssx940.js";
 import"./index-z1w83f81.js";
 export {
   evaluateRetrievalBenchmark,

package/dist/cli.js

@@ -5,10 +5,10 @@ import {
   parseArguments,
   runExecutable,
   usage
-} from "./index-4ag64rc1.js";
+} from "./index-bw2r37z9.js";
 import"./index-bcknqxrq.js";
 import"./index-054mb7d3.js";
-import"./index-avbce90h.js";
+import"./index-bqtqeak3.js";
 import"./index-j4zgmzjr.js";
 import"./index-de2w8crk.js";
 import"./index-6jcz0m1c.js";
@@ -27,22 +27,22 @@ import"./index-mxxxytys.js";
 import"./index-23z4zxgg.js";
 import"./index-pj501bh1.js";
 import"./index-9rf81m0p.js";
-import"./index-e6p9e926.js";
-import"./index-2hf27mws.js";
+import"./index-1k595z6v.js";
+import"./index-q7tbg07z.js";
 import"./index-adx6khj5.js";
-import"./index-hcw140eb.js";
+import"./index-rr9kzq4n.js";
 import"./index-4j3tt0c3.js";
 import"./index-j70m75wd.js";
 import"./index-b88v3vtm.js";
-import"./index-t2bs9xdr.js";
-import"./index-nd6nynv2.js";
-import"./index-famy7fhs.js";
-import"./index-11621h23.js";
+import"./index-djrcc1yf.js";
+import"./index-jk1sgx36.js";
+import"./index-xv80vzfp.js";
+import"./index-tf4wzjew.js";
 import"./index-1gwbassd.js";
-import"./index-gm9t95d9.js";
+import"./index-vnybgywh.js";
 import"./index-1xxnjn0d.js";
-import"./index-0dqfnrz9.js";
-import"./index-1tm7bgx7.js";
+import"./index-hmw17zaa.js";
+import"./index-233z9wmn.js";
 import"./index-d13v9ckt.js";
 import"./index-48pz4jpc.js";
 import"./index-06c9ctr6.js";
@@ -52,16 +52,16 @@ import"./index-3agn8scn.js";
 import"./index-hya40gb2.js";
 import"./index-5vwpzb5a.js";
 import"./index-x3fthpsc.js";
-import"./index-6sw24nvv.js";
+import"./index-ecqpgr5y.js";
 import"./index-3rm7cz6h.js";
-import"./index-ekpwvbra.js";
+import"./index-qbssx940.js";
 import {
   __require
 } from "./index-z1w83f81.js";
 
 // src/cli.ts
 if (import.meta.main) {
-  const { standaloneSupportEnvironment, isUsefulSupportResult, runProductSupportCommand, showProductSupportInvitation } = await import("./support-mywv1em0.js");
+  const { standaloneSupportEnvironment, isUsefulSupportResult, runProductSupportCommand, showProductSupportInvitation } = await import("./support-p452p9c4.js");
   const env = standaloneSupportEnvironment();
   const args = process.argv.slice(2);
   if (args[0] === "support") {

package/dist/evaluation-builder.js

@@ -4,14 +4,14 @@ import {
   knowledgeBaseEvaluationRetrieverIds,
   openKnowledgeBaseEvaluation,
   verifyFrozenEvaluationSnapshot
-} from "./index-e6p9e926.js";
-import"./index-2hf27mws.js";
+} from "./index-1k595z6v.js";
+import"./index-q7tbg07z.js";
 import"./index-adx6khj5.js";
 import {
   indexSemanticVault,
   recommendedEmbeddingModel,
   recommendedEmbeddingModelSha256
-} from "./index-hcw140eb.js";
+} from "./index-rr9kzq4n.js";
 import"./index-4j3tt0c3.js";
 import"./index-j70m75wd.js";
 import {
@@ -19,24 +19,24 @@ import {
   MAX_EVALUATION_EVIDENCE_BYTES,
   MAX_EVALUATION_RESULTS_PER_QUERY
 } from "./index-b88v3vtm.js";
-import"./index-t2bs9xdr.js";
-import"./index-nd6nynv2.js";
-import"./index-famy7fhs.js";
-import"./index-11621h23.js";
+import"./index-djrcc1yf.js";
+import"./index-jk1sgx36.js";
+import"./index-xv80vzfp.js";
+import"./index-tf4wzjew.js";
 import {
   runGitCommand
 } from "./index-1gwbassd.js";
-import"./index-gm9t95d9.js";
+import"./index-vnybgywh.js";
 import"./index-1xxnjn0d.js";
 import {
   scanVault
-} from "./index-1tm7bgx7.js";
+} from "./index-233z9wmn.js";
 import"./index-d13v9ckt.js";
 import"./index-48pz4jpc.js";
 import"./index-06c9ctr6.js";
 import"./index-5vwpzb5a.js";
 import"./index-3rm7cz6h.js";
-import"./index-ekpwvbra.js";
+import"./index-qbssx940.js";
 import"./index-z1w83f81.js";
 
 // src/evaluation-builder.ts

package/dist/evaluation-kb.js

@@ -4,27 +4,27 @@ import {
   knowledgeBaseEvaluationRetrieverIds,
   openKnowledgeBaseEvaluation,
   verifyFrozenEvaluationSnapshot
-} from "./index-e6p9e926.js";
-import"./index-2hf27mws.js";
+} from "./index-1k595z6v.js";
+import"./index-q7tbg07z.js";
 import"./index-adx6khj5.js";
-import"./index-hcw140eb.js";
+import"./index-rr9kzq4n.js";
 import"./index-4j3tt0c3.js";
 import"./index-j70m75wd.js";
 import"./index-b88v3vtm.js";
-import"./index-t2bs9xdr.js";
-import"./index-nd6nynv2.js";
-import"./index-famy7fhs.js";
-import"./index-11621h23.js";
+import"./index-djrcc1yf.js";
+import"./index-jk1sgx36.js";
+import"./index-xv80vzfp.js";
+import"./index-tf4wzjew.js";
 import"./index-1gwbassd.js";
-import"./index-gm9t95d9.js";
+import"./index-vnybgywh.js";
 import"./index-1xxnjn0d.js";
-import"./index-1tm7bgx7.js";
+import"./index-233z9wmn.js";
 import"./index-d13v9ckt.js";
 import"./index-48pz4jpc.js";
 import"./index-06c9ctr6.js";
 import"./index-5vwpzb5a.js";
 import"./index-3rm7cz6h.js";
-import"./index-ekpwvbra.js";
+import"./index-qbssx940.js";
 import"./index-z1w83f81.js";
 export {
   verifyFrozenEvaluationSnapshot,

package/dist/graph-authority.js

@@ -5,17 +5,17 @@ import {
   queryGraph,
   rebuildGraph,
   verifyGraph
-} from "./index-famy7fhs.js";
+} from "./index-xv80vzfp.js";
 import {
   GRAPH_LIMITS,
   GraphAuthorityError,
   validateGraphQueryRequest
-} from "./index-11621h23.js";
-import"./index-1tm7bgx7.js";
+} from "./index-tf4wzjew.js";
+import"./index-233z9wmn.js";
 import"./index-06c9ctr6.js";
 import"./index-5vwpzb5a.js";
 import"./index-3rm7cz6h.js";
-import"./index-ekpwvbra.js";
+import"./index-qbssx940.js";
 import"./index-z1w83f81.js";
 export {
   verifyGraph,

package/dist/graph-percolation.js

@@ -1,15 +1,15 @@
 // @bun
 import {
   percolateWithGraph
-} from "./index-t2bs9xdr.js";
-import"./index-nd6nynv2.js";
-import"./index-famy7fhs.js";
-import"./index-11621h23.js";
-import"./index-1tm7bgx7.js";
+} from "./index-djrcc1yf.js";
+import"./index-jk1sgx36.js";
+import"./index-xv80vzfp.js";
+import"./index-tf4wzjew.js";
+import"./index-233z9wmn.js";
 import"./index-06c9ctr6.js";
 import"./index-5vwpzb5a.js";
 import"./index-3rm7cz6h.js";
-import"./index-ekpwvbra.js";
+import"./index-qbssx940.js";
 import"./index-z1w83f81.js";
 export {
   percolateWithGraph

package/dist/graph.js

@@ -18,7 +18,7 @@ import {
   replaceCatalog,
   searchableMarkdown,
   wikiLinks
-} from "./index-ekpwvbra.js";
+} from "./index-qbssx940.js";
 import"./index-z1w83f81.js";
 export {
   wikiLinks,

package/dist/{index-e6p9e926.js → index-1k595z6v.js}

@@ -2,7 +2,7 @@
 import {
   MAX_SEARCH_RESULTS,
   openKnowledgeBase
-} from "./index-2hf27mws.js";
+} from "./index-q7tbg07z.js";
 import {
   MAX_EVALUATION_EVIDENCE_BYTES,
   redactEvaluationMachinePaths
@@ -12,7 +12,7 @@ import {
 } from "./index-1gwbassd.js";
 import {
   scanVault
-} from "./index-1tm7bgx7.js";
+} from "./index-233z9wmn.js";
 import {
   MAX_REPOSITORY_MEMORY_DETAIL_LIMIT,
   MAX_REPOSITORY_MEMORY_GROUP_LIMIT,

package/dist/{index-1tm7bgx7.js → index-233z9wmn.js}

@@ -8,7 +8,7 @@ import {
   parseNote,
   renderCatalog,
   replaceCatalog
-} from "./index-ekpwvbra.js";
+} from "./index-qbssx940.js";
 
 // src/vault.ts
 import { randomUUID } from "crypto";

package/dist/{index-a6kbv718.js → index-76dbn6pe.js}

@@ -4,7 +4,7 @@ import {
 } from "./index-h170byqw.js";
 import {
   packUntrustedSearchContext
-} from "./index-2hf27mws.js";
+} from "./index-q7tbg07z.js";
 
 // src/workflows/decision-context.ts
 var decisionContextWorkflow = defineWorkflow({

package/dist/{index-avbce90h.js → index-bqtqeak3.js}

@@ -5,7 +5,7 @@ import {
   MAX_SEARCH_RESULTS,
   openKnowledgeBase,
   validateKnowledgeBaseSearchHistory
-} from "./index-2hf27mws.js";
+} from "./index-q7tbg07z.js";
 import {
   expandSearchRequest,
   parseSearchRules
@@ -15,10 +15,10 @@ import {
 } from "./index-1gwbassd.js";
 import {
   validateSearchQuery
-} from "./index-gm9t95d9.js";
+} from "./index-vnybgywh.js";
 import {
   scanVault
-} from "./index-1tm7bgx7.js";
+} from "./index-233z9wmn.js";
 import {
   validateQueryOptions
 } from "./index-48pz4jpc.js";
@@ -32,7 +32,7 @@ import {
   parseVaultKey,
   portfolioDocumentIdentity,
   portfolioVaultIdentity
-} from "./index-ekpwvbra.js";
+} from "./index-qbssx940.js";
 
 // src/portfolio.ts
 import { createHash as createHash2 } from "crypto";