@hraness/wordcell 0.22.0 → 0.22.2

package/dist/portfolio.js

@@ -20,20 +20,20 @@ import {
   selectAuthorizedVaults,
   snapshotPortfolioRegistry,
   validateResolvedPortfolioVaults
-} from "./index-avbce90h.js";
-import"./index-2hf27mws.js";
+} from "./index-bqtqeak3.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-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";
@@ -50,7 +50,7 @@ import {
   parseVaultKey,
   portfolioDocumentIdentity,
   portfolioVaultIdentity
-} from "./index-ekpwvbra.js";
+} from "./index-qbssx940.js";
 import"./index-z1w83f81.js";
 export {
   validateResolvedPortfolioVaults,

package/dist/publish.js

@@ -10,8 +10,8 @@ import {
   publishVault,
   renderPublishReportText,
   serializeSiteFile
-} from "./index-0dqfnrz9.js";
-import"./index-1tm7bgx7.js";
+} from "./index-hmw17zaa.js";
+import"./index-233z9wmn.js";
 import"./index-d13v9ckt.js";
 import"./index-48pz4jpc.js";
 import"./index-06c9ctr6.js";
@@ -20,7 +20,7 @@ import"./index-66pshdtx.js";
 import"./index-3agn8scn.js";
 import"./index-5vwpzb5a.js";
 import"./index-x3fthpsc.js";
-import"./index-ekpwvbra.js";
+import"./index-qbssx940.js";
 import"./index-z1w83f81.js";
 export {
   serializeSiteFile,

package/dist/sdk.js

@@ -11,25 +11,25 @@ import {
   packUntrustedSearchContext,
   searchEvidenceRank,
   validateKnowledgeBaseSearchHistory
-} from "./index-2hf27mws.js";
+} from "./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-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 {
   validateKnowledgeBaseSearchHistory,

package/dist/search.js

@@ -6,12 +6,12 @@ import {
   fuseRankedCandidates,
   searchExactVault,
   validateSearchQuery
-} from "./index-gm9t95d9.js";
+} from "./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 {
   validateSearchQuery,

package/dist/semantic.js

@@ -14,14 +14,14 @@ import {
   searchSemanticVault,
   semanticDatabasePath,
   sha256EmbeddingModelFile
-} from "./index-hcw140eb.js";
-import"./index-gm9t95d9.js";
-import"./index-1tm7bgx7.js";
+} from "./index-rr9kzq4n.js";
+import"./index-vnybgywh.js";
+import"./index-233z9wmn.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 {
   sha256EmbeddingModelFile,

package/dist/{support-mywv1em0.js → support-p452p9c4.js}

@@ -2,12 +2,12 @@
 import {
   parseArguments as parseArguments2,
   parseUrlMetadataArguments
-} from "./index-4ag64rc1.js";
+} from "./index-bw2r37z9.js";
 import"./index-bcknqxrq.js";
 import {
   parsePdfArguments
 } from "./index-054mb7d3.js";
-import"./index-avbce90h.js";
+import"./index-bqtqeak3.js";
 import"./index-j4zgmzjr.js";
 import"./index-de2w8crk.js";
 import"./index-6jcz0m1c.js";
@@ -28,22 +28,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";
@@ -53,9 +53,9 @@ 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"./index-z1w83f81.js";
 
 // src/support.ts
@@ -65,7 +65,7 @@ import { maybeShowSupportInvitation, runSupportCommand } from "@hraness/support-
 var supportProfile = {
   id: "kb",
   name: "Wordcell",
-  valueProposition: "Support ongoing development of inspectable Markdown memory for coding agents.",
+  valueProposition: "Support ongoing development of inspectable Markdown memory.",
   updates: false
 };
 

package/dist/workflows/decision-context.js

@@ -1,27 +1,27 @@
 // @bun
 import {
   decisionContextWorkflow
-} from "../index-a6kbv718.js";
+} from "../index-76dbn6pe.js";
 import"../index-h170byqw.js";
-import"../index-2hf27mws.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-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 {
   decisionContextWorkflow

package/dist/workflows/index.js

@@ -1,7 +1,7 @@
 // @bun
 import {
   decisionContextWorkflow
-} from "../index-a6kbv718.js";
+} from "../index-76dbn6pe.js";
 import {
   explainChangeWorkflow
 } from "../index-e4fagfjz.js";
@@ -9,25 +9,25 @@ import {
   planRadarWorkflow
 } from "../index-rdd5f7jj.js";
 import"../index-h170byqw.js";
-import"../index-2hf27mws.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-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 {
   planRadarWorkflow,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hraness/wordcell",
-  "version": "0.22.0",
-  "description": "A local knowledge base for coding agents. Save decisions in Markdown and recover the context behind your code.",
+  "version": "0.22.2",
+  "description": "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.",
   "license": "MIT",
   "type": "module",
   "sideEffects": [
@@ -476,14 +476,15 @@
     "url-metadata:tool:build": "bun ./dist/cli.js url-metadata tool build",
     "url-metadata:tool:check": "bun ./dist/cli.js url-metadata tool check",
     "test:package": "bun run ./scripts/package-smoke.ts",
-    "check": "bun run check:effect && bun run check:workflows && bun run check:portfolio-inventory && bun run check:installed-command-docs && bun run typecheck && bun run build && bun run test:package && bun run test && bun run url-metadata:tool:check",
+    "check": "bun run check:worker && bun run check:effect && bun run check:workflows && bun run check:portfolio-inventory && bun run check:installed-command-docs && bun run typecheck && bun run build && bun run test:package && bun run test && bun run url-metadata:tool:check",
     "prepack": "bun run check",
     "check:effect": "bun run scripts/check-effect-policy.ts",
-    "kb:search": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.22.0/hraness-wordcell-0.22.0.tgz wordcell search --root kb --mode exact --rerank typesafe --rerank-limit 25",
-    "kb:search:local": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.22.0/hraness-wordcell-0.22.0.tgz wordcell search --root kb --mode exact"
+    "kb:search": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.22.1/hraness-wordcell-0.22.1.tgz wordcell search --root kb --mode exact --rerank typesafe --rerank-limit 25",
+    "kb:search:local": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.22.1/hraness-wordcell-0.22.1.tgz wordcell search --root kb --mode exact",
+    "check:worker": "tsc -p worker/tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@hraness/oh": "https://github.com/hraness/oh/releases/download/v0.10.8/hraness-oh-0.10.8.tgz",
+    "@hraness/oh": "https://github.com/hraness/oh/releases/download/v0.12.0/hraness-oh-0.12.0.tgz",
     "@steipete/sweet-cookie": "0.4.3",
     "@tobilu/qmd": "git+https://github.com/hraness/qmd.git#aa993dceb3ef8cfb71d470554ca437570f5a2b3c",
     "agent-browser": "0.32.3",

package/skills/wordcell/SKILL.md

@@ -35,7 +35,7 @@ selected.
 | Create or update an implementation plan, proposal, RFC, migration plan, execution audit, or phased checklist in the vault | [Write a durable plan](references/plan.md) and [use its structure](references/plan-structure.md) |
 | Review recurring ideas, promote concepts, or add and verify typed relationships | [Percolate concepts and relationships](references/percolate.md) |
 | Refresh or validate the catalog, graph, attachments, repository scopes, context mappings, or overall vault health | [Refresh and check the knowledge base](references/refresh.md) |
-| Publish a vault or a selected subsection as a hosted read-only static site with browser-local search | [Publish a static site](references/publish.md) |
+| Publish a vault or a selected subsection as a hosted read-only static site with browser-local search — locally via `wordcell publish`, or over the wordcell.io REST/MCP surface when no filesystem or Bun runtime is available | [Publish a static site](references/publish.md) |
 
 Read more than one primary reference only when the request spans those
 workflows. For example, saving a source and linking it from a maintained note
@@ -56,7 +56,7 @@ missing:
 ```sh
 command -v wordcell >/dev/null 2>&1 || {
   command -v bun >/dev/null 2>&1 || exit 1
-  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
 ```

package/skills/wordcell/references/publish.md

@@ -91,3 +91,37 @@ local build alone is not a live deployment.
 
 The full artifact contract and hosting options are in
 [the publishing guide](https://github.com/hraness/wordcell/blob/main/docs/publish.md).
+
+## Publish through wordcell.io when the CLI cannot run
+
+Agents on platforms without a filesystem or Bun runtime can publish the same
+`hraness.wordcell.site.v1` artifact through the hosted surface. It runs the
+identical projection server-side; published sites are public.
+
+```sh
+# Self-serve capability token (IP-limited; shown once — store it).
+TOKEN=$(curl -sf -X POST https://wordcell.io/api/v1/tokens \
+  -H 'content-type: application/json' -d '{"label":"my-agent"}' | jq -r .token)
+
+# Publish a vault as a files map: path -> utf8 string, {"base64":"..."}, or
+# {"upload":"<id>"} from POST /api/v1/uploads for larger assets.
+curl -sf -X PUT "https://wordcell.io/api/v1/sites/my-notes" \
+  -H "authorization: Bearer $TOKEN" -H 'content-type: application/json' \
+  -d '{"files":{"index.md":"# Notes\n","a.md":"# A\n"},"title":"My notes"}'
+# -> {"site":{"url":"https://wordcell.io/p/<key8>/my-notes/",...},"idempotent":false}
+```
+
+`GET /api/v1/sites` lists the token's sites and `DELETE /api/v1/sites/{slug}`
+unpublishes. Identical bytes republish idempotently without a revision bump;
+changed bytes sweep the superseded artifact. Deletes and republishes can take
+up to 60 seconds to propagate at the edge. MCP clients can instead point at the
+streamable-HTTP endpoint `POST https://wordcell.io/api/v1/mcp`, which exposes
+`create_token`, `publish_site`, `list_sites`, and `delete_site` tools over the
+same routes — `create_token` is unauthenticated so an MCP-only client can
+onboard itself. `GET /api/v1/openapi.json` describes the REST surface.
+
+The hosted surface carries the same selection semantics (`selection` mirrors
+the CLI selectors) and the same redaction warning: `publish: false` excludes a
+note, it does not erase text quoted elsewhere. Bounded inputs apply — at most
+256 files and 4 MiB inline per publish, 32 MiB per uploaded asset, 50 live
+sites per token.

package/skills/wordcell/references/refresh.md

@@ -126,6 +126,20 @@ After any note or link edit, run the refresh command again so derived state and
 wordcell check --root "$KB_ROOT"
 ```
 
+When the vault lives inside a repository and `KB_REPO` is set, add the advisory
+repository-state pass:
+
+```sh
+wordcell check --root "$KB_ROOT" --repo "$KB_REPO"
+```
+
+This compares every authored `repository_scopes` declaration with the current
+working tree and reports each current record whose declared path is now absent
+or unusable. It is advisory: the exit code does not change, and a terminal plan
+that names a removed path stays silent because that is valid authored history.
+Treat an absent-scope advisory as a note to reread against the code, not as a
+proven error; confirm the path in the repository before editing the note.
+
 Finish only when the graph check and any required agent-context check succeed,
 the configured catalog mode is satisfied, and broken or ambiguous links,
 relationships, and local attachments are resolved. Summarize deliberate

package/src/authoring-model.ts

@@ -89,6 +89,11 @@ export interface AuthoringOptions {
   readonly dependencies?: Partial<AuthoringDependencies>;
 }
 
+export interface UpdateNoteBodyOptions extends AuthoringOptions {
+  /** Exact revision read before preparing the replacement body. */
+  readonly expectedRevision: NoteRevision;
+}
+
 export class InvalidCanonicalNoteIdError extends TypeError {
   readonly noteId: string;
 
@@ -692,6 +697,30 @@ export function normalizedRequestedBody(body: string): string {
   return body.endsWith("\n") ? body : `${body}\n`;
 }
 
+/** Replace prose without serializing or modifying the authored frontmatter. */
+export function renderUpdatedNoteBody(
+  snapshot: Pick<NoteSnapshot, "content" | "relativePath">,
+  parts: FrontmatterParts,
+  body: string,
+): string {
+  if (typeof body !== "string") throw new TypeError("a note body must be a string");
+  if (Buffer.byteLength(body, "utf8") > MAX_NOTE_BYTES) {
+    throw new RangeError("the note body is too large for bounded authoring");
+  }
+  if (Buffer.from(body, "utf8").toString("utf8") !== body) {
+    throw new TypeError("a note body must contain well-formed Unicode");
+  }
+  const normalized = normalizedRequestedBody(body);
+  if (!parts.hadFrontmatter) {
+    if (frontmatter(normalized, snapshot.relativePath).hadFrontmatter) {
+      throw new TypeError("a body update cannot introduce frontmatter into a note");
+    }
+    return normalized;
+  }
+  const header = snapshot.content.slice(0, snapshot.content.length - parts.bodySuffix.length);
+  return `${header}${parts.newline}${parts.newline}${normalized}`;
+}
+
 export function renderCreatedNote(input: CreateNoteInput, documentId: string): string {
   const title = validateTitle(input.title);
   const type = validateType(input.type);

package/src/authoring-program.ts

@@ -3,13 +3,13 @@ import { Effect, Exit } from "effect";
 import {
   MAX_NOTE_BYTES, NoteRevisionConflictError, addRelationToParts, assertCompatibleCreate,
   assertExpected, canonicalNoteId, canonicalRelationTarget, checkedExpectedRevision,
-  frontmatter, isErrno, normalizeRelationPredicate, noteResult, pathFor, relationsFromParts,
-  removeRelationFromParts, renderCreatedNote, renderFrontmatter, revisionFor,
+  existingDocumentId, frontmatter, isErrno, normalizeRelationPredicate, noteResult, pathFor, relationsFromParts,
+  removeRelationFromParts, renderCreatedNote, renderFrontmatter, renderUpdatedNoteBody, requireRevision, revisionFor,
   sameQuarantinedSnapshot, sameSnapshot, withRecoveryPath,
 } from "./authoring-model.js";
 import type {
   AuthoringDependencies, AuthoringInstallContext, AuthoringOptions, CreateNoteInput,
-  DirectoryIdentity, NoteAuthoringResult, NoteRevision, NoteSnapshot, RecoveryLocation, Vault,
+  DirectoryIdentity, NoteAuthoringResult, NoteRevision, NoteSnapshot, RecoveryLocation, UpdateNoteBodyOptions, Vault,
 } from "./authoring-model.js";
 import type { NoteLock } from "./note-lock.js";
 import { parseDocumentId } from "./portfolio-identity.js";
@@ -276,3 +276,38 @@ export function editNoteRelationProgram(
     );
   });
 }
+
+export function updateNoteBodyProgram(
+  platform: AuthoringPlatform, root: string, idInput: string, body: string,
+  options: UpdateNoteBodyOptions,
+): Effect.Effect<NoteAuthoringResult, AuthoringFailure> {
+  return Effect.gen(function*() {
+    const id = yield* authoringSync(() => canonicalNoteId(idInput));
+    const expected = yield* authoringSync(() => {
+      if (typeof options?.expectedRevision !== "string") {
+        throw new TypeError("expectedRevision is required for a note body update");
+      }
+      return requireRevision(options.expectedRevision);
+    });
+    const vault = yield* authoringNative(() => platform.resolveVault(root));
+    const dependencies = yield* authoringSync(() => platform.dependenciesFor(options.dependencies));
+    return yield* authoringResource(
+      authoringNative(() => platform.acquireNoteLock(vault.root, id, options.lock)),
+      (lock) => Effect.gen(function*() {
+        yield* authoringNative(() => platform.recoverInterruptedAuthoring(vault, id, lock));
+        const source = yield* authoringNative(() => platform.readSnapshot(vault, id));
+        yield* authoringSync(() => assertExpected(source, expected));
+        const parts = yield* authoringSync(() => frontmatter(source.content, source.relativePath));
+        const identity = yield* authoringSync(() => existingDocumentId(parts));
+        if (identity.kind === "invalid") return yield* fail(new TypeError("the note has an invalid document_id"));
+        const documentId = identity.kind === "valid" ? identity.documentId : undefined;
+        const relations = yield* authoringSync(() => relationsFromParts(parts, source.relativePath));
+        const content = yield* authoringSync(() => renderUpdatedNoteBody(source, parts, body));
+        if (content === source.content) return yield* authoringSync(() => noteResult(source, relations, false, documentId));
+        const revision = yield* installNote(platform, vault, id, content, source, lock, dependencies);
+        return yield* authoringSync(() => noteResult({ relativePath: source.relativePath, revision }, relations, true, documentId));
+      }),
+      (lock) => authoringNative(() => lock.release()),
+    );
+  });
+}

package/src/authoring.ts

@@ -1,12 +1,12 @@
 import type {
   AuthoringOptions, CreateConceptNoteInput, CreateNoteInput, NoteAuthoringResult,
-  NoteRelation, NoteRevision,
+  NoteRelation, NoteRevision, UpdateNoteBodyOptions,
 } from "./authoring-model.js";
 import { canonicalNoteId, frontmatter, relationsFromParts } from "./authoring-model.js";
 import {
   assertNoInterruptedRecovery, nativeAuthoringPlatform, readSnapshot, resolveVault,
 } from "./authoring-platform.js";
-import { createNoteProgram, editNoteRelationProgram } from "./authoring-program.js";
+import { createNoteProgram, editNoteRelationProgram, updateNoteBodyProgram } from "./authoring-program.js";
 import { runAuthoring } from "./authoring-runtime.js";
 
 export {
@@ -15,7 +15,7 @@ export {
 } from "./authoring-model.js";
 export type {
   AuthoringDependencies, AuthoringInstallContext, AuthoringOptions,
-  CreateConceptNoteInput, CreateNoteInput, NoteAuthoringResult, NoteRelation, NoteRevision,
+  CreateConceptNoteInput, CreateNoteInput, NoteAuthoringResult, NoteRelation, NoteRevision, UpdateNoteBodyOptions,
 } from "./authoring-model.js";
 
 /**
@@ -60,6 +60,20 @@ export async function createConceptNote(
   return createNote(root, { ...input, type: "concept" }, options);
 }
 
+/**
+ * Replace one existing note's body at an exact revision. Frontmatter bytes,
+ * stable identity and relations remain unchanged. Like createNote, this adds a
+ * final newline and separates frontmatter from the body with one blank line.
+ *
+ * A stale revision fails even if the requested body already matches. Callers
+ * must read back an interrupted operation before deciding whether to retry.
+ */
+export async function updateNoteBody(
+  root: string, id: string, body: string, options: UpdateNoteBodyOptions,
+): Promise<NoteAuthoringResult> {
+  return runAuthoring(updateNoteBodyProgram(nativeAuthoringPlatform, root, id, body, options));
+}
+
 /** Add one exact outbound typed relation, idempotently. */
 export async function addNoteRelation(
   root: string, sourceId: string, predicate: string, targetId: string, options: AuthoringOptions = {},