Limits & known behaviors

Last updated: 2026-07. 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

• 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.
• 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.

Search

• Empty or heading-only sections can appear as low-relevance search results. Filtering these out of retrieval is on the roadmap.

Sync

• Blenau syncs your repo’s main branch. Repos whose default branch isn’t main aren’t fully supported yet.
• Deleting a Markdown file in your repo does not yet remove the corresponding document from Blenau’s index.

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, and the brain-health report (flags empty sections, duplicates, and documents that have drifted from their source) in the dashboard.

On the roadmap

Filtering empty / heading-only sections out of search results, and removing a document from Blenau when its Markdown file is deleted from the repo.