mindmuxai/brain.md v0.4.0

on GitHub

Root pages are created only when there is something real to write. brain init no longer lays down six placeholder templates.

Highlights

On-demand root pages

A new brain starts with an empty pages/ directory and no root pages. brain update-root <slug> creates one of the six slots (background, architecture, flow, mindmap, stack, roadmap) when stdin starts with an authored # Title and has real content after that heading. The displayed title comes from that heading.

printf '# System architecture\n\n## Overview\n\nRequests enter through the gateway.\n' | brain update-root architecture

A legacy root page whose stored body has no H1 can omit the heading on its next write. The stored frontmatter title is inserted as the H1. A page that already starts with an H1 must include one on every later write. Omitting it fails, and the file is left unchanged.

Existing populated brains are left in place. brain init still does not overwrite them.

Install notes

• Prefer a global install if you want bare brain on PATH. npx alone does not leave brain on PATH.
• Existing installs: bump to @mindmux/brain-md@0.4.0 then run brain setup -y.

Docs

• README: update-root example starts with an authored # Title
• BRAIN.md: root pages are on-demand slots
• Skills: brain-setup, brain-bootstrap, brain-page, brain-ingest

Links

• Repo: https://github.com/mindmuxai/brain.md
• Homepage: https://projectbrain.md
• Package: https://www.npmjs.com/package/@mindmux/brain-md

License

Apache-2.0 · Incubated by MindMux

What's Changed

• feat: create root pages on demand by @LinkinStars in #25
• chore: release 0.4.0 by @robinv8 in #26

Full Changelog: v0.3.0...v0.4.0