From b8a4134b0a9762d3760b737877f1ebd83f862163 Mon Sep 17 00:00:00 2001 From: "shumeiko.it" Date: Sun, 1 Nov 2026 01:55:25 +0100 Subject: [PATCH] docs: add a changelog entry for the first community edition (P2.4) List what changed for users compared with the commercial product: removed (billing, KVARK, compliance, self-learning, team mode, old memory engine features), changed (mem0 memory, waggle.db, opt-in analytics, whatsapp-web.js, the server installer, the pinned Node runtime, the built-in proxy), added and fixed, based on the ADRs and the branch history. --- CHANGELOG.md | 92 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 92 insertions(+) create mode 100644 CHANGELOG.md diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..e890c4c --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,92 @@ +# Changelog + +All notable changes to the Waggle community edition are listed here. The format follows +[Keep a Changelog](https://keepachangelog.com/en/1.1.0/). + +## Unreleased: first community edition + +The first open-source release of Waggle, made from the commercial Waggle OS product. This entry +lists what changed for users compared with that product. The reasons are recorded in the +[decision records](docs/oss/adr/README.md). + +### Removed + +- **Billing and plans.** Trial, Solo, Teams and Enterprise plans, Stripe checkout, license + checks, trial banners and upgrade prompts. Everything a plan used to unlock is available + (ADR-0001). +- **KVARK** enterprise retrieval, its agent tools, and the enterprise capability packs. +- **Compliance reports** and the compliance subsystem. +- **Self-learning** (ADR-0004): behavior evolution and prompt optimization (the `optimizer` + package), learning from corrections, the Evolution screen (Memory → Improvements), the + nightly prompt-optimization and monthly-assessment jobs, and the idle-session reviewer. + Thumbs up and down are still stored, and corrections you make are saved as ordinary memories. +- **Team mode** (ADR-0003): connecting to a team server, team workspaces and shared memory, + WaggleDance, the team screens, and S3 file storage for workspaces. The code stays in the + repository but is not built or shipped. +- **Features of the old memory engine** (ADR-0002): the knowledge graph, the wiki, importing chat + history from ChatGPT and Claude exports, memory consolidation, the memory server for + external tools (MCP), and the memory hooks for Claude Code, Codex and other coding agents. +- **`install.sh`** and `scripts/waggle-server.sh`, replaced by the server installer. +- The automatic start of a LiteLLM proxy, which needed Python. It is now opt-in (see Changed). + +### Changed + +- **Memory runs on local mem0** behind a memory contract (ADR-0002, ADR-0007). Memories are kept + in `~/.waggle/memory/`, embedded by a model that runs on your computer, and searched with + mem0's combined vector and keyword search. Nothing goes to a cloud memory service. Memories + from the old `.mind` files are not carried over. See [docs/memory.md](docs/memory.md). +- **Waggle's own data** (automations, notifications, cost tracking, your profile card and task + list) moved to a separate `waggle.db`, apart from memory. +- **Analytics are opt-in** (ADR-0006). Waggle asks once; nothing is sent until you choose + **Allow**, and Settings → General → Privacy & Telemetry turns it off again. When allowed, + Waggle sends one event at the end of setup with the template, persona and model you chose. +- **WhatsApp uses `whatsapp-web.js`** instead of Baileys (ADR-0005). Pair your phone again with + the QR code. The session is kept in the data directory as a browser profile, protected by file + permissions rather than the vault. If no Chrome, Edge or Chromium is installed, Waggle + downloads Chrome for Testing (about 170 MB) the first time you start WhatsApp. The channel + handles text messages only. +- **`npx @waggle-ai/waggle` installs a prebuilt server** (ADR-0009) instead of running the server + from npm. It adds the `waggle-server` command with `run`, `doctor`, `update` and `uninstall`, + and the installed server serves the web UI. The package and command names are temporary. +- **Desktop app and server archives carry their own Node.js** (22.23.2) with matching native + modules, so no Python or compiler is needed to install (ADR-0008). +- **Model calls go through the built-in provider proxy** by default. LiteLLM runs only when + `config.json` contains `"litellm": { "enabled": true }`, on your own Python. +- **The Waggle-managed Ollama runtime works on Linux**, and installs no longer download CUDA + libraries. +- **The recall reranker is off by default**; `WAGGLE_RERANKER=1` turns it on. +- **The license is MIT** for the whole repository. Notices for shipped third-party components are + in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md). +- UI text no longer uses decorative emoji or em dashes, and generic AI icons were replaced. + +### Added + +- **Background fact extraction.** While you chat, Waggle can save facts about you to personal + memory, every six messages or after a two-minute pause, with the model you chat with. Turn it + off in Settings → General → Memory. +- **Memory capabilities.** The UI hides memory features the store does not support. +- **The server installer** (`packages/launcher`): `install`, `run`, `doctor`, `update` and + `uninstall`, with SHA-256 checks of the downloaded archive. +- **A license check** for shipped npm packages and Rust crates. +- **A new design**, off by default, switched on with "New design" at the bottom of the sidebar. +- **A bottom navigation bar on phones**, instead of the sidebar rail. + +### Fixed + +Fixes made while preparing this edition. Each is recorded in +[docs/oss/upstream-fixes.md](docs/oss/upstream-fixes.md). + +- The packaged macOS app could not find its bundled server and stayed on "Starting Waggle…" + (UF-004). +- On macOS and Linux the desktop app stopped its server without letting it shut down (UF-046). +- Local model downloads were cancelled after five minutes (UF-008). +- A working API key showed as not responding, and other internal model calls failed (UF-044). +- A memory saved to an unknown workspace landed in personal memory (UF-039). +- Memory searches from Timeline and the chat recall toast used the wrong scope (UF-035), and the + command palette searched the wrong workspace (UF-033). +- The web client showed "important" and "temporary" memories as normal (UF-036). +- Generating a persona from a description failed (UF-045). +- The onboarding Industry dropdown opened under the dialog (UF-007), and startup text was + invisible in the light theme (UF-017). +- Brand fonts did not load under the content security policy. +- Smaller interface fixes: UF-042, UF-043, UF-047 to UF-057.