Skip to content
Blenau Docs

Limits & known behaviors

Last updated: 2026-08. We keep this page honest and current — if something here surprises you in production, it’s a bug in this page, not just the product.

Editing

Section titled “Editing”
  • edit_section changes a section’s body only. To rename a heading use rename_section; to remove a section use delete_section; to append/prepend/replace part of a body use patch_section. Passing a different heading inside edit_section is rejected, not silently applied. See Editing.
  • To retire a whole document use delete_document (or blenau docs delete), not delete_section on its title: splicing out the H1 commits an empty file and leaves the document in every listing wearing its old title. Brain health reports that state as empty_document. See Editing.
  • Edits are structure-preserving — they splice just the section you named into the document’s canonical Markdown and leave the rest byte-for-byte untouched. One caveat: a document created before structure-preserving writes shipped and never edited since has no stored canonical copy yet, so its first edit rebuilds the base from Blenau’s index (which can normalize the untouched parts); every edit after that is clean.
  • Never re-ingest a repo-backed document to modify it — it resets provenance to manual and can duplicate sections. See Provenance and Editing.
Section titled “Search”
  • Empty or heading-only sections can appear as low-relevance search results. Filtering these out of retrieval is on the roadmap.

Sync

Section titled “Sync”
  • Blenau syncs your repo’s main branch. Repos whose default branch isn’t main aren’t fully supported yet.

Recently shipped

Section titled “Recently shipped”

Things this page used to list as limitations, now available: first-class rename_section / delete_section / patch_section, structure-preserving edits, dry_run previews on every write, whole-document deletion from every channel (delete_document over MCP, blenau docs delete, and git rm + push, which the sync now propagates into the index), and the brain-health report (flags empty sections and documents, duplicate headings, near-duplicate documents, and documents that have drifted from their source) in the dashboard.

On the roadmap

Section titled “On the roadmap”

Filtering empty / heading-only sections out of search results.