Commit Graph

157 Commits

Author SHA1 Message Date
shumeiko.it
0e2f3197eb docs: describe the release workflow now that it is merged
The architecture guide, AGENTS.md and the threat model said releases were
built by hand or Windows-first; ADR-0009 still listed the release
workflow as future work. The Windows build guide named the missing
Settings > API Keys tab.
2026-11-01 02:21:20 +01:00
shumeiko.it
608c804482 Merge P2.4: README and documentation for the community edition 2026-11-01 02:20:13 +01:00
shumeiko.it
10c013efcd Merge P1.3d: unsigned release workflow for three systems 2026-11-01 02:20:13 +01:00
shumeiko.it
b156072285 chore: drop billing and team variables from .env.example, add the installer README
.env.example described Stripe, Clerk, MinIO and the team server, none of
which the community edition runs, and sent users to a Settings tab that
does not exist. The web UI no longer names a person as author, and the
installer package gets the README its files list promised.
2026-11-01 02:10:01 +01:00
shumeiko.it
74200d46e8 fix: five defects found while rewriting the docs (UF-061 to UF-065)
- Key messages named a Settings > API Keys tab that does not exist; they
  now point at Settings > Models (UF-061).
- The connector suggestion looked for vault.db, which never exists; it
  now checks the vault for a connector entry (UF-062).
- /config and /preferences were registered with a leading slash and
  never matched (UF-063).
- Pins and documents were written under ~/.waggle whatever the data
  directory; they now use the server's data directory (UF-064).
- The Windows uninstaller named a Data & Privacy page that does not
  exist (UF-065).
2026-11-01 02:08:57 +01:00
shumeiko.it
e34f95ec3c docs(oss): describe the release workflow in the Windows build guide (P1.3d)
The guide now says the release workflow builds Windows on windows-latest
with NSIS and MSI, and shows how to pack the server archive and run the
installer and desktop smoke tests locally.
2026-11-01 02:08:36 +01:00
shumeiko.it
687e3b86c7 ci(release): replace the commercial pipeline with an unsigned build for three systems (P1.3d)
release.yml now has one build job with a matrix over the four release
targets (windows-x64, macos-arm64, macos-x64, linux-x64). Each leg stages
the sidecar, checks it, builds the web UI, packs the server archive for
the installer (ADR-0009), runs the installer smoke test, builds the
desktop installers (NSIS and MSI, app and DMG, deb and AppImage), runs
the packaged app until its sidecar answers /health, and uploads the
installers and archives. A pushed v* tag also gets a draft GitHub
release with a SHA256SUMS file, created with GITHUB_TOKEN only. Pull
requests on the desktop paths and manual runs build and test without
publishing, so tauri-build-pr.yml is removed.

Nothing is signed or notarized. The macOS app gets an ad-hoc signature
("-"), which needs no certificate; without it macOS reports a downloaded
Apple Silicon app as damaged.

Removed with the old pipeline, as nothing else used them: the Windows
signing handoff and signer (sign-windows-artifact.ps1 and its tests,
new-windows-signing-handoff.ps1), the pilot signing scripts
(sign-windows-pilot.ps1, apply-signing-config.mjs, signing-config.ts and
its test, sign-macos-adhoc.sh, tauri.build-override.conf.json and the
tauri:sign:* and tauri:build:win:pilot-signed scripts), the installer
certifier with its bootstrap-token helper, and the Windows release
publisher. check-sidecar-resources.mjs stays: tauri.conf.json runs it
before every desktop build and the workflow runs it before packing the
archive.

app/package.json gains tauri:build:linux. The tests that pinned the old
workflows, the certifier, the signer and the publisher are removed;
new tests pin the targets, the step order, the absence of signing and of
secrets other than GITHUB_TOKEN, and the draft-only, tag-only publish.
2026-11-01 02:08:31 +01:00
shumeiko.it
a73abd4d54 feat(scripts): add release smoke tests for the installer and the desktop app (P1.3d)
scripts/release-smoke.mjs runs on every release target:

- installer: installs the server archive with packages/launcher into a
  temporary directory, requires a clean doctor report (only the PATH
  warning is allowed), starts run on a free port with a temporary data
  directory, waits for /health, stops it and uninstalls;
- desktop: starts the packaged app (an executable or a macOS .app) with
  a temporary data directory, waits until its sidecar answers /health on
  127.0.0.1:3333, then stops the app and the sidecar and checks that the
  port is released.

The process tree is stopped through the process group on macOS and
Linux and with taskkill /T on Windows. The tests run both modes against
stand-in payloads.
2026-11-01 02:08:15 +01:00
shumeiko.it
ea837895e8 refactor(tauri): drop the certifier-only WebView debug port (P1.3d)
The Windows installer certifier opened a WebView2 CDP port through
WAGGLE_CERTIFIER_WEBVIEW_DEBUG_PORT. The certifier leaves with the
commercial release pipeline, so the main window is built straight from
its configuration and the shipped app never opens a debugging port.
2026-11-01 02:08:08 +01:00
shumeiko.it
87c1d398f9 docs: add desktop app update and uninstall steps to the install guide (P2.4) 2026-11-01 02:02:50 +01:00
shumeiko.it
dd6564451a docs: bring the command and local API references up to date (P2.4)
commands.md lists all 23 registered slash commands with their working
aliases and drops the FTS5 and two-mind wording. api.md explains the
bearer session token and that the API is internal, fixes the session
route parameters, lists the memory routes served through the memory
contract, the current chat stream events and the permissions body, and
removes the team, import and KVARK enterprise-pack routes.
2026-11-01 02:01:57 +01:00
shumeiko.it
94d54c4188 docs: rewrite the troubleshooting guide for this edition (P2.4)
Cover the unsigned installers, the server installer's error messages,
the desktop startup log, ports, models, memory on mem0 (including the
embedder mismatch) and the data directory. Drop team mode, the .mind
files, FTS5, docker compose for LiteLLM, the Node-on-PATH requirement
of the old desktop app and the invented cost per conversation.
2026-11-01 01:59:25 +01:00
shumeiko.it
834096146e docs: update the capabilities and connectors guides for this edition (P2.4)
Remove KVARK enterprise connectors, the 120+ package count and the
curl examples, which no longer work without the session token. Describe
Skills Hub, the marketplace scan as the code applies it, MCP Hub, the
30 native connectors, the approval modes, and the messaging channels
with the whatsapp-web.js warnings and browser download.
2026-11-01 01:58:42 +01:00
shumeiko.it
eca050328b docs: merge the two getting-started pages and update the workspaces guide (P2.4)
docs/GETTING-STARTED.md and docs/guides/getting-started.md covered the
same ground; keep one guide in docs/guides that follows the current
setup flow, the two model paths, memory on mem0 and the real keyboard
shortcuts. Drop the product tiers, the signed-Windows-only install, the
.mind files, install.sh and the external coding-agent sign-in.

The workspaces guide loses team workspaces, the .mind files, FTS5 search
and the knowledge graph, and describes virtual and local storage, the
shipped personas and what deleting a workspace removes.
2026-11-01 01:57:12 +01:00
shumeiko.it
b8a4134b0a 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.
2026-11-01 01:55:25 +01:00
shumeiko.it
a369fb95f3 docs: use project contacts in SECURITY.md and the code of conduct (P2.4)
Drop the personal email address. Security reports go through GitHub
private vulnerability reporting, with hello@egzakta.com as the fallback;
the code of conduct points security reports there too. Add a
supported-versions table for the first community release and update
the scope to the desktop app, the server installer and the shipped
packages.
2026-11-01 01:54:23 +01:00
shumeiko.it
ea724a6bfd docs: rewrite the README for the first community release (P2.4)
Say plainly what Waggle is, show both install paths with a link to the
install guide, the current run-from-source steps (no build:packages),
the checks and a documentation index. The license section points to
THIRD_PARTY_NOTICES.md; the Apache-2.0 hive-mind sentence is gone with
those packages.
2026-11-01 01:53:54 +01:00
shumeiko.it
06a0df73b5 docs: rewrite the architecture overview for the community edition (P2.4)
Describe the web UI, the sidecar, the Tauri shell, waggle.db, the
memory contract and mem0, models, the server installer and archive,
and the staging chain that builds the desktop packages and the server
archive. Drop the removed packages, KVARK, team mode, the .mind files
and the knowledge graph.
2026-11-01 01:53:53 +01:00
shumeiko.it
4377096495 docs: move CONTRIBUTING.md to the root and rewrite it for this edition (P2.4)
Point contributors to AGENTS.md for the rules, list the current setup
and check commands (no build:packages step, no Docker), and drop the
team-mode test setup and the stale test counts. docs/CONTRIBUTING.md
keeps a one-line pointer because the pull request template links it.
2026-11-01 01:53:53 +01:00
shumeiko.it
491df50a59 docs: add the install guide and the memory guide (P2.4)
docs/install.md covers both ways to install (the Tauri desktop
packages and the server installer), the unsigned-installer warnings
on each system, first launch, the data directory, update and
uninstall. docs/memory.md describes the memory contract, its mem0
implementation, where mem0 keeps its files, recall and background
fact extraction.
2026-11-01 01:50:35 +01:00
shumeiko.it
9806afbced docs(oss): propose how to sign the installers (P2.5)
Developer ID and notarization on macOS (including the bundled node and
native libraries), the owner's existing Azure Artifact Signing on Windows
with SignPath Foundation or a CA certificate as alternatives, and signed
checksums on Linux. Lists the decisions the owner has to make.
2026-11-01 01:39:49 +01:00
shumeiko.it
413956e0a1 fix(web): ship fonts as files so the CSP lets them load
Vite inlined the two smallest Hanken Grotesk and JetBrains Mono subsets as
data: URLs. The sidecar and Tauri CSPs allow fonts from 'self' only, so
the browser blocked them and those character ranges fell back to a system
font. Fonts are now never inlined.
2026-11-01 01:36:50 +01:00
shumeiko.it
3a426a5423 feat(launcher): install the server from a prebuilt archive (P1.3c)
The launcher is now a self-contained installer with install, run, update,
doctor and uninstall. Install downloads waggle-server-<version>-<target>
.tar.gz, checks its SHA-256, unpacks it into a per-user program directory
and writes a waggle-server command that runs the tool on the archive's own
Node. Nothing is built on the user's machine and the data directory stays
WAGGLE_DATA_DIR or ~/.waggle.

scripts/build-server-archive.mjs packs the staged desktop sidecar payload
with the built web UI and a manifest. The download location waits for the
repository decision; until then install takes --from or
WAGGLE_RELEASE_BASE_URL (ADR-0009).

Removes install.sh, scripts/waggle-server.sh and their CI job, which the
installer replaces, and the bin name clash with @waggle/cli.
2026-11-01 01:35:54 +01:00
shumeiko.it
eb2412b687 chore: refresh the lockfile and third-party notices after the merges
The lockfile picks up the license fields added to workspace packages; the
notices drop the crates of the removed updater plugin.
2026-11-01 01:18:00 +01:00
shumeiko.it
86ea0d7529 Merge P2.3: license gate and third-party notices
# Conflicts:
#	docs/oss/upstream-fixes.md
2026-11-01 01:17:28 +01:00
shumeiko.it
0cfe97b5ec Merge P2.2 part 2: remove the excluded packages and scrub internal names 2026-11-01 01:16:46 +01:00
shumeiko.it
acd9db90e1 chore: drop mentions of apps/www and memory-mcp from comments (P2.2) 2026-11-01 00:50:45 +01:00
shumeiko.it
16eaf01e14 chore: scrub personal names, maintainer URLs and local paths (P2.2)
Sample data in tests, prompts and UI placeholders uses Alex Morgan
instead of the maintainer's name; decision attributions say "owner".
Personal details in two test fixtures are replaced. Local paths
(D:/Projects/...) and paths into the maintainer's planning repository
are reworded. Clone and install URLs in CONTRIBUTING.md and the getting
started guide use placeholders until the public repository location is
decided (Q9). The Benchmarks page no longer names the maintainer's
hive-mind repository, and the upstream fixes log names the main Waggle
repository instead of an internal git host.
2026-11-01 00:50:13 +01:00
shumeiko.it
72a2a895a5 docs: drop references to the removed packages (P2.2)
AGENTS.md records that the excluded packages left in P2.2. SECURITY.md
scopes memory to memory-contract and memory-mem0. THREAT_MODEL.md points
the injection scanner at @waggle/core, marks the MCP tool scope gate as
removed with the memory MCP servers, and drops the hive-mind copy of the
URL egress guard. docs/ARCHITECTURE.md lists the memory packages instead
of the hive-mind substrate. docs/methodology.md, the LoCoMo write-up of
the hive-mind engine whose reproduction steps pointed at the
maintainer's hive-mind repository, is removed.
2026-11-01 00:50:06 +01:00
shumeiko.it
9276723f25 fix(core): name EMBEDDING_PROVIDER in the mock-embedding warning (UF-058)
When no embedding provider answers, the banner told users to set
HIVE_MIND_EMBEDDING_PROVIDER, which only the hive-mind CLI read; Waggle
reads EMBEDDING_PROVIDER. A test checks the banner text.
2026-11-01 00:43:05 +01:00
shumeiko.it
c098f20872 chore: drop hive-mind provenance notes from comments (P2.2)
Comments that pointed at hive-mind-core files, the hive-mind OSS
mirror and its drift triage now describe the code as it is. The
in-process reranker caches its model in ~/.waggle/models, like the
embedder, when the caller passes no directory; the sidecar always
passes one.
2026-11-01 00:42:48 +01:00
shumeiko.it
613b23be17 refactor(memory-mem0): drop the old engine from the search-quality bench (P2.2)
The bench compared mem0 with MindDB, FrameStore and HybridSearch from
the hive-mind substrate, which @waggle/core no longer exports and which
left the repository. It now runs mem0, mem0-rerank and cosine; the
recorded comparison stays in docs/oss/research/memory-search-quality.md.
2026-11-01 00:42:47 +01:00
shumeiko.it
4c1b404339 refactor(app): remove the wiki Tauri commands (P2.2)
get_wiki_pages, get_wiki_page, get_wiki_page_content and
compile_wiki_section proxied to the sidecar's /api/wiki routes, which
served the wiki-compiler package and left with the old memory engine in
P1.5. No screen called them. Remove the commands, their TypeScript
bindings and tests. cargo check and the 32 Rust tests pass.
2026-11-01 00:42:39 +01:00
shumeiko.it
2edfd01e6e refactor: remove coding-agent hook management (P2.2)
The hooks for Claude Code, Codex and the other agents ran the
hive-mind-hooks-* packages, which left the repository; ADR-0002 hides
the feature in v1. Remove the hook installer surface from the tool
launcher, the POST /api/tools/hooks route, the hook status probe in
tool detection, and the hook fields of the tool manifest and detection
envelope (hookCapable, hookRoot, hookPointer, hooksInstalled,
hookPointerPath). Third-party adapter manifests no longer accept the
hook fields.

In the web UI, remove the hidden hook actions and the "How memory is
shared" explainer from the Launcher, adapter.manageHooks, the
hook-wired count in Mission Control and the agentHooks and memoryMcp
memory feature flags. Launch, watch and stop are unchanged; the
roadmap tool note no longer mentions hooks.
2026-11-01 00:35:13 +01:00
shumeiko.it
8a308aac01 docs: generate THIRD_PARTY_NOTICES.md for the shipped components (P2.3)
scripts/generate-third-party-notices.mjs works offline: it lists the npm
packages of the sidecar and web UI closures from package-lock.json, the
Node.js runtime and npm that bundle-node.mjs stages, and the Rust crates of
the desktop shell from `cargo metadata --offline`, and reproduces each
distinct license text once. A section covers the LGPL (libvips,
node-webpmux), MPL (servo crates), OFL (fonts) and unlicensed components
and what their licenses ask.

The Windows and Linux crates are not in the local cargo cache, so this
first file covers the macOS crates and says so; regenerate after
`cargo fetch` before a release.

Log UF-058 (installers ship third-party code without notices) and UF-059
(buffers 0.1.1 has no license) in the upstream fixes.
2026-11-01 00:31:26 +01:00
shumeiko.it
3ebe97e033 build: add a license gate for shipped npm packages and Rust crates (P2.3)
scripts/check-licenses.mjs (npm run check:licenses) reads the production
dependency closures of the sidecar (@waggle/server minus the packages
stage-sidecar-deps.mjs never ships) and the web UI (apps/web) from
package-lock.json and fails on GPL, AGPL, SSPL, missing and unknown
licenses. It allows permissive licenses plus MPL-2.0 and lists named
exceptions with reasons; LGPL libvips and node-webpmux, the OFL fonts and
the unlicensed buffers package are marked as pending the licensing review.

app/src-tauri/deny.toml applies the same allowlist to the Tauri crates with
cargo-deny; the npm check fails when the two lists drift apart. A new CI
job runs both, with cargo-deny 0.18.3 installed and cached in CI.

scripts/license-inventory.mjs holds the shared closure logic.
2026-11-01 00:30:06 +01:00
shumeiko.it
5a7f3d24d9 chore: declare MIT and drop personal metadata from manifests (P2.3)
Add "license": "MIT" to the workspace manifests that lacked it (app,
apps/web, server, shared and the postponed team packages) and to the
Tauri crate. Remove the personal author and the maintainer repository,
homepage and bugs URLs; the public repository location is not decided
yet (Q9). package-lock.json is left as is and is regenerated later.
2026-11-01 00:28:07 +01:00
shumeiko.it
46687a823a chore: remove the packages excluded from the community edition (P2.2)
Delete apps/www, packages/admin-web, every packages/hive-mind-* package,
packages/memory-mcp and packages/wiki-compiler (ADR-0002), with what
existed only for them: their tests kept outside the packages, the hook
runtime build, the hive-mind OSS subtree-split and drift scripts, the
www deploy and hive-mind-cli workflows, the staged hook lifecycle step
in the Windows desktop workflows, and the root dev:www, build:www and
build:hook-runtime scripts.

Drop the matching excludes from the Vitest, ESLint and workspace
dependency checks, the next override, and the extraneous workspace
entries from package-lock.json. The smart-router qualification seed
now writes its spend to waggle.db, where the sidecar has read cost
traces since P1.5.
2026-11-01 00:21:10 +01:00
shumeiko.it
39d9f63043 build: let the sidecar build run from a source archive (P1.3d)
build-sidecar.mjs required a git checkout: it read HEAD, the tracked
file list and the marketplace database blob from git. Outside a checkout
it now records no source revision and ships the database from disk; a
checkout keeps the exact-revision checks.
2026-11-01 00:13:38 +01:00
shumeiko.it
d2ad282498 fix(desktop): find the sidecar through Tauri's resource directory (P1.3d)
Linux packages keep resources in /usr/lib/<app> (deb) or under $APPDIR
(AppImage), not next to the executable, so the shell never found
service.js there. Setup now records Tauri's resource_dir and the lookup
prefers it, keeping the executable-relative paths as a fallback.

Drop tauri-plugin-updater: it was declared but never registered, and the
updater stays disabled until release signing exists.
2026-11-01 00:10:22 +01:00
shumeiko.it
a8250cb375 refactor: drop the one-time copy of legacy .mind data
The first start copied Waggle's tables and the memories of the commercial
edition's .mind files into waggle.db and mem0. The product is still in
development and nobody has data to bring over, so both copies, their tests
and the legacy creation-time field are gone. ADR-0007 records the change.
2026-10-28 12:35:41 +01:00
shumeiko.it
fb3697ca6c fix(web): find a keyless primary's provider from the model id (UF-054, UF-055)
A provider without its key lists no models, so Model Pilot could not tell
the primary needed a key, and it compared a prefixed active id with a bare
one. The provider now also comes from the id's prefix or family name, and
prefixed and bare ids count as the same model. The account row's fallback
initial is A for Account, not W.
2026-10-27 14:56:30 +01:00
shumeiko.it
25ad379e38 fix: drop the em dash from user-facing copy
Anti-slop audit-002, item 13 (R-02). Every em dash in text the user sees
(web UI labels, toasts, tooltips, empty and error states, chat steps,
API messages, notifications and channel replies) became a period, comma,
colon or parentheses. Model prompts, logs, comments, regexes and the lone
dash that marks an empty value are unchanged. Text the client matches
against server copy (the default workspace summary, the quiet-night dream
summary) accepts the old wording too, so cached and saved data still match.
2026-10-27 14:53:12 +01:00
shumeiko.it
3ae3cc81fc fix(web): give phones a bottom navigation bar instead of the rail (UF-057)
At 375px the 64px icon rail took a fifth of the screen and Home's heading
wrapped over five lines. Below sm the rail hides, a bottom bar carries the
five places plus More (⌘K), and Home tightens its padding and heading.
2026-10-27 14:36:35 +01:00
shumeiko.it
5bf3dd9ea8 fix(web): replace generic AI icons and decorative arrows
Sparkles and Zap stood in as the icon for unrelated things: tools, MCP,
imports, model routing, workspaces, memory highlights (anti-slop audit-002,
item 16). Each now gets an icon for what it is (Wrench, Plug, Import, Route,
Hexagon, Brain and so on) or none. Chevrons and arrows on Resume, Continue,
Open, Set up a model and the onboarding buttons are gone (item 17); arrows
in settings paths, relations and the launcher flow diagram stay.
2026-10-27 14:36:20 +01:00
shumeiko.it
827bf8488b fix: drop decorative emoji from UI text, chat steps and channel replies
Bees, sparkle glyphs, fire, check and warning marks decorated buttons,
toasts, activity steps and channel replies (anti-slop audit-002, item 18).
Marks that carry state (key set, importance, the hive glyph) stay.
2026-10-27 14:27:19 +01:00
shumeiko.it
22846e4131 fix(web): label the Home activity summary as the last 24 hours (UF-056)
The summary always covers the last 24 hours, but it read "While you slept"
and "A calm night" at any time of day.
2026-10-27 14:24:44 +01:00
shumeiko.it
659c84bee2 fix: never greet the user by the assistant's default name (UF-055)
Home and the sidebar read the user's name from the identity row, which the
sidecar fills with the assistant's identity named Waggle. Both now use the
profile name, with the identity name as a fallback that skips the default.
2026-10-27 14:24:35 +01:00
shumeiko.it
c2998f1a6b fix(web): say when the primary model has no key and which model chats use (UF-054)
Settings showed the configured primary while the status bar showed the
model new chats fall back to, so the two screens disagreed. Model Pilot now
says the primary needs a key and names the model in use.
2026-10-27 14:20:05 +01:00
shumeiko.it
97b2c984d8 refactor(web): drop the team agent tab and team memory scopes (P1.1)
Team mode is out of the community edition, but Agents still offered a Team
tab, a team agent type and team / organization memory scopes.
2026-10-27 14:17:25 +01:00