11 Releases 13 Tags

RSS Feed

• mosaic-v0.0.29 81c1775a03

  Compare

  mosaic v0.0.29 Stable

  jason.woltje released this 2026-04-08 00:42:54 +00:00 | 4 commits to main since this release

  Changes

  • feat(framework): superpowers enforcement, typecheck hook, file-ownership rules (#451)
    • PostToolUse typecheck hook for immediate TS type error feedback
    • Superpowers Enforcement section in AGENTS.md (skills, hooks, MCP, plugins)
    • File-ownership partitioning rules for parallel workers in ORCHESTRATOR.md
    • Settings audit in launcher validates hooks/plugins at mosaic claude startup
  • fix(installer): preserve credentials dir and seed STANDARDS.md (#452)
    • credentials/ now survives framework upgrades (added to PRESERVE_PATHS)
    • AGENTS.md and STANDARDS.md seeded from defaults/ on first install
    • AGENTS.md protected from deletion during upgrades

  Upgrade

  curl -fsSL https://mosaicstack.dev/install.sh | bash
  

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)
• mosaic-v0.0.28 1bfd8570d6

  Compare

  mosaic-v0.0.28 Pre-Release

  jason.woltje released this 2026-04-06 00:46:31 +00:00 | 7 commits to main since this release

  @mosaicstack/mosaic v0.0.28

  Highlights

  Drill-down main menu + provider-first flow + quick start (IUV-M03, #446)

  • Wizard replaced with menu-driven architecture: Quick Start, Providers, Skills, Agent Identity, Gateway, Advanced, Finish & Apply
  • Quick Start completes in 3 questions: API key, admin email, admin password
  • Provider setup happens first; deterministic intent intake with preset categories and thematic agent names
  • Headless backward-compat preserved (MOSAIC_ASSUME_YES=1 + env vars)

  UX polish (IUV-M02, #444)

  • CORS prompt replaced with hostname/FQDN input; CORS value derived internally
  • Skill installer now respects user selection (was a no-op before)
  • MOSAIC_HOSTNAME env var for headless hostname config

  Hotfix (IUV-M01, #440/#441)

  • Bootstrap DTO class-erasure regression fixed (was: import type erased DTO at runtime)
  • Wizard failure propagation in interactive mode
  • Port prompt prefills 14242
  • Pi SDK mentioned in intro copy

  Other

  • TUI password input now masked (#449)
  • Repo rename: mosaicstack/mosaic-stack → mosaicstack/stack (#447, #448)
  • Short install URL: curl -fsSL https://mosaicstack.dev/install.sh | bash

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)
• mosaic-v0.0.27 bd76df1a50

  Compare

  mosaic-v0.0.27 Pre-Release

  jason.woltje released this 2026-04-06 00:15:23 +00:00 | 11 commits to main since this release

  mosaic-v0.0.27

  Highlights

  • Drill-down main menu: Replace linear 12-stage interrogation with menu-driven architecture (Quick Start, Providers, Agent Identity, Skills, Gateway, Advanced, Finish & Apply)
  • Provider-first flow: LLM API key collection moves to the front with auto-detection of Anthropic vs OpenAI from key prefix
  • Quick Start path: 3 questions (API key, admin email, password) targeting under 90 seconds for returning users
  • Deterministic intent/naming: User picks intent category (general, software-dev, devops, research, content, custom) and gets thematic agent name (Mosaic, Forge, Sentinel, Atlas, Muse)
  • Headless backward compat: MOSAIC_ASSUME_YES=1 + env vars still work unchanged, with new MOSAIC_AGENT_NAME and MOSAIC_AGENT_INTENT vars

  New files

  • packages/mosaic/src/stages/provider-setup.ts - Provider API key collection + auto-detection
  • packages/mosaic/src/stages/agent-intent.ts - Deterministic intent intake + naming
  • packages/mosaic/src/stages/quick-start.ts - Minimal-questions quick start path

  Breaking changes

  None. Headless installs are fully backward compatible.

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)
• mosaic-v0.0.26 c08aa6fa46

  Compare

  mosaic-v0.0.26 — Bootstrap Hotfix Pre-Release

  jason.woltje released this 2026-04-05 22:17:59 +00:00 | 16 commits to main since this release

  mosaic-v0.0.26 — Bootstrap Hotfix

  Fixes four bugs found during real-run testing of mosaic-v0.0.25.

  Changes

  Bug fixes

  • [CRITICAL] Admin bootstrap 400 regression — bootstrap.controller.ts imported BootstrapSetupDto with import type, erasing the class at runtime. NestJS @Body() fell back to plain Object as the metatype, and ValidationPipe with whitelist: true + forbidNonWhitelisted: true rejected every field ("property email should not exist", "property password should not exist"). Fixed by changing to a value import so the class reference is preserved for design:paramtypes. Covered by a new e2e integration test that binds through the real NestJS DI + Fastify pipeline.

  • Wizard reports success after bootstrap failure — the interactive-mode guard in wizard.ts had an && headlessRun condition, so a completed: false result was silently swallowed in interactive mode and the wizard continued to print ✔ Wizard complete. Fixed by removing the headless-only gate: bootstrap failure now aborts with a non-zero exit in both interactive and headless modes.

  • Gateway port prompt does not prefill 14242 — @clack/prompts text() accepts two distinct options: defaultValue (used only when the user submits empty) and initialValue (prefills the input buffer). The prompter was only passing defaultValue, so the field appeared blank. Added initialValue support to WizardPrompter.text(), ClackPrompter, and HeadlessPrompter. All prompts that have defaults now prefill the buffer so the user can press Enter to accept.

  • "What is Mosaic?" intro copy missing Pi SDK — the welcome stage listed Claude Code, Codex, and OpenCode but omitted Pi SDK, the underlying agent runtime. Copy updated to include Pi SDK.

  Packages

  • @mosaicstack/mosaic 0.0.25 → 0.0.26

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)
• mosaic-v0.0.25 a4c94d9a90

  Compare

  @mosaicstack/mosaic 0.0.25 — install UX hardening Pre-Release

  jason.woltje released this 2026-04-05 20:53:26 +00:00 | 19 commits to main since this release

  @mosaicstack/mosaic 0.0.25 — install UX hardening

  Closes the install-ux-hardening-20260405 mission. All 7 acceptance criteria satisfied across three feature PRs.

  New features

  mosaic uninstall (PR #429)

  • Top-level command that cleanly reverses every mutation made by tools/install.sh — framework data, npm CLI, nested stack deps, runtime asset injections in ~/.claude/, and npmrc scope mapping
  • Flags: --framework, --cli, --gateway, --all, --keep-data, --yes, --dry-run
  • New install manifest at ~/.config/mosaic/.install-manifest.json drives deterministic reversal; heuristic fallback for installs that predate the manifest
  • Shell fallback: curl … | bash -s -- --uninstall works without a functioning CLI

  Wizard remediation (PR #431)

  • Password entry is now masked in raw mode with a confirmation prompt (no plaintext echo)
  • New hooks-preview stage shows exactly which Claude hooks will be installed and captures explicit consent
  • New mosaic config hooks list|enable|disable subcommands for post-install management
  • Headless install path: MOSAIC_ASSUME_YES=1 + MOSAIC_ADMIN_NAME/EMAIL/PASSWORD lets CI/automation complete the wizard without a TTY

  Unified first-run wizard (PR #433)

  • mosaic wizard and mosaic gateway install are collapsed into a single cohesive flow with shared in-memory state
  • Gateway config + admin bootstrap are now terminal stages 11 & 12 of runWizard
  • The fragile 10-minute $XDG_RUNTIME_DIR/mosaic-install-state.json session bridge has been removed
  • mosaic gateway install still works standalone (thin wrapper over the same stages) for users who already went through the wizard
  • state.hooks.accepted === false now propagates end-to-end via MOSAIC_SKIP_CLAUDE_HOOKS — declining hooks actually skips hook installation

  Stats

  • 24 test files, 219 tests passing (+15 net new since 0.0.24)
  • 4 rounds of independent codex code review applied across the milestones

  Upgrade

  npm i -g @mosaicstack/mosaic@0.0.25
  

  Alpha — stays in 0.0.x until GA.

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)
• mosaic-v0.0.24 417805f330

  Compare

  mosaic v0.0.24 Pre-Release

  jason.woltje released this 2026-04-05 14:49:05 +00:00 | 27 commits to main since this release

  @mosaicstack/mosaic 0.0.24 — alpha

  First version where npm i -g @mosaicstack/mosaic@latest && mosaic --help works end-to-end from a clean global install.

  Fixes

  • Third correction wave for the systemic publish-skip bug: memory, queue, and storage registry copies at 0.0.3 were built before M5 added their registerXCommand exports. The publish workflow silently skipped them because their versions matched the registry.

  Version bumps

  • @mosaicstack/memory 0.0.3 → 0.0.4
  • @mosaicstack/queue 0.0.3 → 0.0.4
  • @mosaicstack/storage 0.0.3 → 0.0.4
  • @mosaicstack/mosaic 0.0.23 → 0.0.24

  Verification

  • mosaic --help exits 0 and prints the alphabetized command list
  • All 38 typecheck, 21 lint, format:check, and 162 mosaic tests pass
  • All four packages confirmed on Gitea registry at their new versions

  Alpha — stays in 0.0.x until GA.

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)
• v0.0.8 cd57c75e41

  Compare

  v0.0.8 — Phase 7: Feature Completion Stable

  jason.woltje released this 2026-03-15 19:50:24 +00:00 | 277 commits to main since this release

  Phase 7: Feature Completion (v0.0.8)

  Web Dashboard

  • Functional WebSocket chat with streaming responses
  • Conversation management (search, rename, delete, archive)
  • Project detail views (missions, tasks, PRD viewer)
  • Provider management UI (status, test connection, model capabilities)
  • Settings persistence (profile, preferences, notifications)
  • Admin panel (user CRUD, role assignment, system health)

  Agent & MCP

  • 7 new agent tools (file ops, git, shell exec, web fetch)
  • MCP server endpoint with 14 tools (streamable HTTP transport)
  • MCP client (connect to external MCP servers as agent tools)
  • Skill invocation from catalog

  CLI

  • Model/provider switching (--model, --provider, /model in TUI)
  • Session management (list, resume, destroy)

  Infrastructure

  • Coord module DB migration (project-scoped, multi-tenant RBAC)
  • Agent session sandboxing (cwd, system prompt, tool restrictions)

  Quality

  • E2E Playwright test suite (~35 tests)
  • Comprehensive docs (user guide, admin guide, dev guide, deployment)
  • Complete .env.example with all 25+ env vars

  Bug Fixes

  • TUI agent:end React state updater side-effect
  • Agent session cwd sandbox hardening

  19 PRs merged (#136-#153). All quality gates green.

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)
• v0.0.7 7d04874f3c

  Compare

  v0.0.7 — Phase 6: CLI & Tools Stable

  jason.woltje released this 2026-03-15 01:07:27 +00:00 | 311 commits to main since this release

  Phase 6: CLI & Tools

  • @mosaic/cli — unified binary with tui, prdy, quality-rails, wizard subcommands
  • @mosaic/prdy — PRD wizard migrated from v0 (YAML persistence, 3 templates, interactive wizard)
  • @mosaic/quality-rails — code quality scaffolder migrated from v0 (Node/Python/Rust, 3 profiles)
  • @mosaic/mosaic — install wizard migrated from v0 (9-stage wizard, runtime detection, skill catalog)

  Bug fixes

  • PLUGIN_REGISTRY ESM circular reference resolved (plugin.tokens.ts extraction)
  • AuthStorage.create() silent exit replaced with AuthStorage.inMemory()

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)
• v0.0.6 6e22c0fdeb

  Compare

  v0.0.6 — Phase 5: Remote Control Stable

  jason.woltje released this 2026-03-15 00:06:35 +00:00 | 317 commits to main since this release

  Phase 5: Remote Control

  • Plugin host — gateway plugin loading + channel interface
  • Discord bot plugin — mentions, DMs, response buffering
  • Telegram bot plugin — text messages, response chunking
  • Authentik OIDC SSO adapter via BetterAuth genericOAuth
  • All Phase 5 env vars documented in .env.example

  Testing

  1. docker compose up -d to start infrastructure
  2. Copy .env.example to .env and configure tokens
  3. pnpm --filter @mosaic/gateway exec tsx src/main.ts to start gateway
  4. Set DISCORD_BOT_TOKEN / TELEGRAM_BOT_TOKEN to enable plugins
  5. Set AUTHENTIK_* vars to enable SSO

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)
• v0.0.5 9eb48e1d9b

  Compare

  v0.0.5 — Phase 4: Memory & Intelligence Pre-Release

  jason.woltje released this 2026-03-13 13:57:07 +00:00 | 339 commits to main since this release

  Phase 4: Memory & Intelligence

  @mosaic/memory

  • PreferencesRepo: user preference KV store (CRUD + upsert, categories)
  • InsightsRepo: knowledge store with pgvector embedding column (1536 dims)
  • Semantic search via cosine distance
  • Relevance decay for old insights
  • VectorStore + EmbeddingProvider interfaces for future abstraction

  @mosaic/log

  • AgentLogsRepo: structured log ingest (single + batch)
  • Flexible query builder (session, level, category, tier, date range)
  • Tiered storage: hot (7d) → warm (30d) → cold (90d) → purge

  Summarization Pipeline

  • SummarizationService: cheap LLM extracts insights from aging logs
  • CronService (node-cron): summarization every 6h, tier management daily
  • Job tracking via summarization_jobs table

  Agent Integration

  • Memory tools injected into all agent sessions:
    • memory_search, memory_get_preferences, memory_save_preference, memory_save_insight
  • EmbeddingService (OpenAI-compatible, configurable)

  Skill Management

  • SkillsService + SkillsController at /api/skills
  • CRUD + enable/disable toggle
  • Supports builtin/community/custom sources

  Stats

  • 5 new DB tables, 5 new API endpoint groups
  • All 18 packages: typecheck, lint, format clean
  • 10 unit tests passing
  • PR feat(Phase 4): Memory & Intelligence — memory, log, summarization, skills (#91)

  Milestones

  • Phase 0-3: ✓
  • Phase 4: Memory & Intelligence (v0.0.5) ✓
  • Phase 5: Remote Control (v0.0.6) — next

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)