feat: install and update msd from git release tags, not npm

MSD is not published to npm, so /msd-update and the SessionStart update
check could never find a release. Releases are now vX.Y.Z git tags plus a
stable branch:

- check-latest-version reads release tags via git ls-remote against the
  baked repository URL (latest = highest stable tag, next = incl. -rc)
- /msd-update reruns the bootstrap installer pinned to the checked tag and
  reads the changelog from that tag
- bootstrap.sh defaults to the stable branch and supports --local/--global
- package identity: changelog URL on stable, manual install via
  msd.golem15.com
- README quickstart and update how-to describe the one-line installer
- track the repo-root CLAUDE.md

Emitted-Drift-Ack-Growth: update.md — the update flow now explains the git-tag release lookup and pins the bootstrap installer to the checked tag, replacing the npm/npx wording
This commit is contained in:
Jakub Zych
2026-10-09 02:47:50 +02:00
parent bb581803ad
commit 6524974d93
18 changed files with 349 additions and 202 deletions

View File

@@ -34,12 +34,26 @@ Each milestone repeats the same five-step loop, one phase at a time:
## Quickstart
MSD Core is a private fork and is not published to npm. Install from the checkout:
MSD Core is not published to npm. Install the latest release (needs Node.js 24+, git and jq) with:
```bash
git clone git@git.golem15.com:golem15/msd-core.git
cd msd-core
scripts/install-golem15.sh # Node 24; installs for Claude Code and Codex
curl -fsSL https://msd.golem15.com | bash
```
This installs Claude Code if it is missing, clones MSD into `~/.local/share/msd-core` at the `stable` branch (the latest tagged release), builds it and installs it globally for Claude Code. Rerun the same command, or `/msd-update` inside your runtime, to update. Options go after `bash -s --`:
```bash
curl -fsSL https://msd.golem15.com | bash -s -- --claude --codex # several runtimes
curl -fsSL https://msd.golem15.com | bash -s -- --local # into the current project only
curl -fsSL https://msd.golem15.com | bash -s -- --ref next # unreleased work from next
```
From a checkout of this repository you can also run the installer directly:
```bash
git clone https://git.golem15.com/golem15/msd-core.git
cd msd-core && npm ci && npm run build:hooks
node bin/install.js --claude --global
```
For any other runtime, run `node bin/install.js` directly. The installer prompts for your runtime (Claude Code, OpenCode, Antigravity CLI, Codex, Cursor, and more) and whether to install globally or locally. The installer is required for cross-runtime compatibility — do not copy files from `agents/` or `commands/` directly.