mosaicstack/stack
21
0
Fork 1
Code Issues 338 Pull Requests 13 Actions Packages Projects Releases 15 Wiki Activity

feat: unified install.sh + auto-update checker (deprecates mosaic/bootstrap) #347

Merged
jason.woltje merged 4 commits from feat/install-update-checker into main 2026-04-02 05:41:08 +00:00
Conversation 0 Commits 4 Files Changed 15
+774 -302
jason.woltje commented 2026-04-02 02:34:25 +00:00
Owner
Copy Link
Copy Source

Summary

Single tools/install.sh that installs both the Mosaic framework (~/.config/mosaic/) and @mosaic/cli (npm). Adds auto-update checking on CLI startup. Fully deprecates the mosaic/bootstrap repo.

What it does

tools/install.sh — unified installer

bash <(curl -fsSL https://git.mosaicstack.dev/mosaic/mosaic-stack/raw/branch/main/tools/install.sh)
  • Downloads monorepo archive from Gitea, extracts packages/mosaic/framework/
  • Runs the framework installer (preserves SOUL.md/USER.md/TOOLS.md/memory by default)
  • Installs @mosaic/cli via npm (scoped @mosaic registry in ~/.npmrc)
  • Flags: --check, --framework, --cli, --ref <branch>
  • curl-pipe safe (main() wrapper, no stdin consumption)

Auto-update checker

  • packages/mosaic/src/runtime/update-checker.ts — checks Gitea npm registry, caches result 1h at ~/.cache/mosaic/update-check.json
  • CLI startup: non-blocking background check on every mosaic invocation
  • mosaic update command: explicit check + install (--check for CI)
  • scripts/agent/session-start.sh: warns agents when CLI is outdated
  • Proper semver comparison including pre-release precedence

Cleanup

  • Deleted remote-install.sh and remote-install.ps1 (redundant redirectors)
  • Updated all mosaic/bootstrap references → mosaic/mosaic-stack
  • Updated defaults/README.md for monorepo, Pi as first-class runtime

Files changed (14 files, +767 / -298)

File Change
tools/install.sh New — unified installer (framework + npm CLI)
packages/mosaic/src/runtime/update-checker.ts New — version check module
packages/mosaic/__tests__/update-checker.test.ts New — semver + notice tests
packages/cli/src/cli.ts Background update check at startup + mosaic update command
packages/mosaic/src/index.ts Export update checker API
scripts/agent/session-start.sh Update check warning for agent sessions
eslint.config.mjs Allow __tests__/ in mosaic package
framework/bin/mosaic Fix stale bootstrap URLs
framework/bin/mosaic.ps1 Fix stale bootstrap URLs
framework/bin/mosaic-release-upgrade Fix upgrade URL
framework/bin/mosaic-release-upgrade.ps1 Fix upgrade URL
framework/defaults/README.md Rewritten for monorepo
framework/remote-install.sh Deleted
framework/remote-install.ps1 Deleted

Testing

  • vitest — semver comparison + notice formatting tests pass
  • tsc --noEmit — both @mosaic/mosaic and @mosaic/cli compile clean
  • bash -n — all shell scripts pass syntax check
  • Archive extraction verified: framework resolves correctly from Gitea tarball
  • --check flag verified against live Gitea registry

Deprecates

mosaic/bootstrap — zero references remain in the codebase. Ready to archive.

## Summary Single `tools/install.sh` that installs both the Mosaic framework (`~/.config/mosaic/`) and `@mosaic/cli` (npm). Adds auto-update checking on CLI startup. Fully deprecates the `mosaic/bootstrap` repo. ## What it does ### `tools/install.sh` — unified installer ```bash bash <(curl -fsSL https://git.mosaicstack.dev/mosaic/mosaic-stack/raw/branch/main/tools/install.sh) ``` - Downloads monorepo archive from Gitea, extracts `packages/mosaic/framework/` - Runs the framework installer (preserves SOUL.md/USER.md/TOOLS.md/memory by default) - Installs `@mosaic/cli` via npm (scoped `@mosaic` registry in `~/.npmrc`) - Flags: `--check`, `--framework`, `--cli`, `--ref <branch>` - curl-pipe safe (`main()` wrapper, no stdin consumption) ### Auto-update checker - `packages/mosaic/src/runtime/update-checker.ts` — checks Gitea npm registry, caches result 1h at `~/.cache/mosaic/update-check.json` - CLI startup: non-blocking background check on every `mosaic` invocation - `mosaic update` command: explicit check + install (`--check` for CI) - `scripts/agent/session-start.sh`: warns agents when CLI is outdated - Proper semver comparison including pre-release precedence ### Cleanup - **Deleted** `remote-install.sh` and `remote-install.ps1` (redundant redirectors) - **Updated** all `mosaic/bootstrap` references → `mosaic/mosaic-stack` - **Updated** `defaults/README.md` for monorepo, Pi as first-class runtime ## Files changed (14 files, +767 / -298) | File | Change | |---|---| | `tools/install.sh` | New — unified installer (framework + npm CLI) | | `packages/mosaic/src/runtime/update-checker.ts` | New — version check module | | `packages/mosaic/__tests__/update-checker.test.ts` | New — semver + notice tests | | `packages/cli/src/cli.ts` | Background update check at startup + `mosaic update` command | | `packages/mosaic/src/index.ts` | Export update checker API | | `scripts/agent/session-start.sh` | Update check warning for agent sessions | | `eslint.config.mjs` | Allow `__tests__/` in mosaic package | | `framework/bin/mosaic` | Fix stale bootstrap URLs | | `framework/bin/mosaic.ps1` | Fix stale bootstrap URLs | | `framework/bin/mosaic-release-upgrade` | Fix upgrade URL | | `framework/bin/mosaic-release-upgrade.ps1` | Fix upgrade URL | | `framework/defaults/README.md` | Rewritten for monorepo | | `framework/remote-install.sh` | **Deleted** | | `framework/remote-install.ps1` | **Deleted** | ## Testing - `vitest` — semver comparison + notice formatting tests pass - `tsc --noEmit` — both `@mosaic/mosaic` and `@mosaic/cli` compile clean - `bash -n` — all shell scripts pass syntax check - Archive extraction verified: framework resolves correctly from Gitea tarball - `--check` flag verified against live Gitea registry ## Deprecates `mosaic/bootstrap` — zero references remain in the codebase. Ready to archive.
jason.woltje force-pushed feat/install-update-checker from 1ad0175ec1 to 3b9104429b 2026-04-02 05:12:26 +00:00 Compare
jason.woltje merged commit ea371d760d into main 2026-04-02 05:41:08 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
bug
Defect in framework tooling or delivered code
 fleet-enhancement
Fleet-wide reliability/speed/cost improvements surfaced by the nightly enhance pass
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
code-be-01 (Mosaic fleet seat code-be-01) code-be-02 (Mosaic fleet seat code-be-02) code-dogfood-01 (Mosaic fleet seat code-dogfood-01) code-infra-01 (Mosaic fleet seat code-infra-01) fargo fred gate-merge-01 (Mosaic fleet seat gate-merge-01) happy jason.woltje (Jason Woltje) marcie merge-gate ops-01 (Mosaic fleet seat ops-01) ops-02 (Mosaic fleet seat ops-02) ops-03 (Mosaic fleet seat ops-03) ops-ci-01 (Mosaic fleet seat ops-ci-01) ops-deploy-01 (Mosaic fleet seat ops-deploy-01) orch-01 (Mosaic fleet seat orch-01) pepper resume rev-code-01 rev-code-02 rev-security-01 rev-security-02 rev-security-03 (Mosaic fleet seat rev-security-03) sanity scooby (Scooby) scrappy shaggy tiny topher (Mosaic fleet seat topher) velma veronica (Mosaic fleet seat veronica) vision woodpecker
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mosaicstack/stack#347