Skip to content

feat: publishable npm package installer#5

Open
robinv8 wants to merge 3 commits into
mainfrom
feat/npm-package-installer
Open

feat: publishable npm package installer#5
robinv8 wants to merge 3 commits into
mainfrom
feat/npm-package-installer

Conversation

@robinv8

@robinv8 robinv8 commented Jun 26, 2026

Copy link
Copy Markdown
Member

Replace the local ./setup and ./uninstall shell scripts with a publishable npm package named brain-md.

What changed

  • Added package.json with bin entries for brain-md, brain-md-uninstall, and brain.
  • Added bin/ scripts: installer, uninstaller, and the brain reference CLI.
  • Updated README with npx brain-md / npm install -g brain-md instructions and documented --project, --symlink, --yes flags.
  • Updated .gitignore for node_modules/, *.tgz, and project-level .brain.md/.
  • Removed obsolete setup and uninstall scripts.

Local verification

  • npm linkbrain-md setup --project --yes → copied skills into .claude/ and .codex/.
  • Simulated brain-setup: scaffolded BRAIN.md, brain/, CLAUDE.md, AGENTS.md.
  • Exercised brain CLI: create-page, read-page, append-timeline, update-truth, set-tags, lint-links, archive-page.
  • brain-md uninstall --project --yes removed skills and manifest while preserving project brain/ data.

Notes

  • Package name chosen as brain-md (unscoped) to keep the open-standard route simple. brain was already taken on npm.

robin added 3 commits June 26, 2026 10:43
…ruth section boundaries

- Add normalize-timestamps CLI command to migrate timestamps to YYYY-MM-DDTHH:MM:SS
- Fix extractSection/replaceSection/appendToSection to treat compiled_truth as spanning until ## timeline
- Fix lint-links to only check compiled_truth for pages, ignoring append-only timeline
- Fix listRootPages to only return canonical root pages
- Support single-quoted timestamps in normalization
- Add tests for timestamp normalization, section boundaries, and root page filtering
- Remove normalize-timestamps CLI command and all related library helpers
- Keep section boundary fixes, lint-links scope fix, and canonical root-page filtering
- New pages and root pages continue to use nowStamp() for correct-by-construction timestamps
- Update tests to focus on section boundaries, root-page filtering, and lint scope
Replace the local ./setup and ./uninstall shell scripts with a publishable
npm package named brain-md.

- Add package.json with bin entries for brain-md, brain-md-uninstall, and brain
- Add bin/ scripts: installer, uninstaller, and the brain reference CLI
- Update README with npx/npm install -g instructions and new flags
- Update .gitignore for node_modules and project-level .brain.md/
- Remove obsolete setup/uninstall scripts
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant