Repository navigation
Releases
Dots Brain 1.0.1
Dots Brain 1.0.1
This patch release includes the security hardening and four project-audit fixes merged since 1.0.0.
- Isolated managed Python launches and reliable reconnects for exactly owned client bridges.
- Strict actor/project binding and uniqueness for audit receipts, with continued review progress across historical anomalies and adaptive page sizing.
- Safe validation of credential identities, consistent status snapshots during writes, and stronger SQLite responsiveness regression coverage.
The release retains schema v2, the existing dependency versions, note and revision formats, OAuth grants and local model artifacts. Capture and CORTEX modules remain disabled. Existing 1.0.0 installations need no data migration or new model download.
Verify the four release assets with SHA256SUMS. Follow the versioned installation and upgrade guidance. Keep the prior environment for code-only rollback using the current database; restoring an old snapshot can undo newer writes or deletions.
Source changes: security hardening #12, project-audit fixes #13, release metadata #14.
Dots Brain 1.0.0
Dots Brain 1.0.0 is the stable Linux release for explicitly saved, source-aware notes shared through MCP.
- One host-owned SQLite store, revisions, project-scoped access, full-text search and optional local CPU embeddings.
- Versioned source ZIP and wheel with SHA256 checksums and a matching dependency lock; Python 3.11/3.12 with SQLite 3.42+ and FTS5.
- Verified source and clean installed-wheel paths, including real stdio/HTTP MCP, migration, staged restore and deletion suppression.
- Existing schema-v2 installations keep their data and authorization history. The fixed 30-day OAuth grant policy is unchanged; refresh does not extend it and re-pairing does not delete notes.
- The locked certifi dependency is updated to 2026.10.19.
Start with the installation guide. Existing operators should follow upgrading and recovery.
Boundaries: capture and CORTEX modules remain disabled and excluded from core packages. A connection does not ensure an assistant uses memory in every conversation. Public HTTPS ingress is operated separately. Full host-loss recovery is not supported; staged restore requires a surviving current store. No paid API, hosted database or telemetry is added.
Published assets are immutable. Publication does not upgrade an existing host; retain its prior compatible executable and a validated backup before deployment.
Verification: release workflow passed on Python 3.11 and 3.12 (515 tests each, one model-dependent skip), fresh core-only wheel checks and the exact source ZIP installation. The attached wheel was also checked on Linux/Python 3.12.3/SQLite 3.45.1 with managed lifecycle, schema-v2 reuse from 0.4.4 and a bounded real local-embedding test. These checks are not a claim of prolonged soak, every-client conversation behavior or full host-loss recovery.
Dots Brain 0.4.4
Dots Brain 0.4.4
Dots Brain is a self-hosted MCP memory service for explicitly saved notes. This is still a work in progress; the release is marked as a prerelease.
Changes
- Make the default systemd example work with core dependencies; document explicit semantic dependencies and model preparation.
- Verify fresh core-only wheel installations in Linux Python 3.11 and 3.12, including real stdio/HTTP MCP, template startup, migration and restore.
- Bind release preparation to an annotated tag, its exact commit on main, current locked metadata and successful installed-wheel checks.
- Reject incomplete indexing and full-text fallback in the semantic stress checks.
- Preserve an existing empty or unknown restore disable barrier; allow only a valid retry of the same recovery.
- Keep package, runtime, plugin, lockfile, README and changelog versions aligned. Schema v2 and dependency versions are unchanged.
This release also includes the 0.4.1–0.4.3 changes previously merged to main: ownership-aware cleanup, retrieval and documentation corrections, nginx request-buffering coverage, and the full-text replacement row-ID fix. See CHANGELOG.md for details.
Upgrade
Verify the supplied SHA256SUMS, install the selected artifact in a separate environment, and retain the previous executable and a validated private backup. Preserve an existing service's explicit semantic configuration. Upgrading does not repair an already damaged full-text index or remove recovery barriers. Follow docs/upgrading.md.
The source/plugin ZIP contains the reviewed repository files. Disabled capture and CORTEX modules remain excluded from the core wheel. Automatic conversation capture is not enabled.
Source commit: 0b43ebfaeb7d28fe1e4faf7f33e6b31924fb1afe.
Release publication and any installation are separate operations. Source and wheel checks do not establish recovery, client behavior or capacity for another deployment.
Dots Brain 0.4.0
- Retain schema v2 and the explicit released v1 migration. Add read-only version
checks, FTS secure deletion, snapshot/recovery validation and writer/HTTP leases. - Preserve OAuth client/grant provenance after invalidation; bind public policy
to its listener and make bulk access changes explicit offline maintenance. - Reject known secrets, warn on uncertain content, retain successful writes when
later auditing fails, and report unknown remote outcomes without automatic retry. - Return the source body/revision with title matches; make indexing counts and
FTS fallback explicit and isolate bridge sessions for concurrent calls. - Publish managed state after readiness; bind process control to its data path.
Add read-only connect with failure rollback and explicit supervisor endpoints,
independent doctor checks, timestamps and one startup log rotation. - Add ownership-aware disconnect and uninstall that preserve unrelated client
settings, changed credentials and retained memory data. - Add schema-v2 audit review with checkpoint continuity and operator diagnostics.
- Exclude disabled CORTEX and capture modules and their tests from the core
distribution while preserving their source-only characterizations. - Add installed-wheel verification using a released synthetic v1 fixture and
real stdio MCP.
This version uses selected changes from the later experimental branch; its
v3/v4 schemas and additional command surfaces are not part of this v2 result.
Known limitations
- Corrections: assistants often store a correction as a new memory instead of a new revision of the existing one. The server supports in-place revisions (memory_remember with the same project, source, account and event_id plus expected_revision), but the tool description does not explain this yet, so search can return both the old and the corrected memory.
- Ranking: in hybrid search, a full-text match on a very common word carries the same weight as the strongest semantic match, and equal scores are ordered arbitrarily. A paraphrased query can therefore rank the best semantic match below the top three.
Dots Brain v0.3.0-alpha.2
Dots Brain can now authorize OAuth clients on the same VM and SQLite database
as the memory service. The owner agent approves an identified connection and its
project scope without reading or printing bearer tokens. Existing local bearer
connections continue working.
Implemented behavior
- Optional OAuth discovery and dynamic client registration through official MCP SDK handlers.
- S256 PKCE, exact callbacks, resource-bound token exchange, and single-use codes.
- Local
oauth pending,approve, anddenycommands for the exact initiated flow. - Project-scoped grants; default approval excludes deletion and can narrow requested scopes.
- One-hour access tokens, rotating refresh tokens, and a maximum 30-day grant lifetime.
- Client and owner revocation, persistent grants across restart, and removal of all
OAuth flows and grants during whole-instance uninstall. - Bounded registration storage and request bodies, validated callback schemes,
malformed-JSON handling, and case-insensitive HTTP Bearer scheme parsing.
No runtime dependency or paid service was added. The minimum MCP SDK version is
now the tested 1.30, within the existing major-version constraint.
Validation
66 tests passed on Python 3.11 and 3.12, with the unchanged opt-in real-model test
skipped. The 19 OAuth cases include official OAuthClientProvider discovery,
registration, browser callback simulation, CLI approval, PKCE, a memory write,
and automatic token refresh against a live local HTTP server. They also cover
concurrent code reuse, expiry, scope/project boundaries, capacity recovery,
revocation, and removal/reinstall behavior.
Lint, formatting, documentation validation, and wheel/source builds passed.
The release workflow repeats the supported-version checks for the exact tag.
All test memories and credentials are synthetic; no user account was connected.
Installation and documentation
Use the source checkout or installer ZIP with Python 3.11+ and uv, following the
setup skill. The ZIP is an installer skill package; publishing it does not
register a public ChatGPT plugin or create a shared MCP endpoint.
OAuth is enabled explicitly on an existing instance. It adds optional tables;
upgrading alone does not enable it or expose the service. Disable OAuth with an
OAuth-aware release before downgrading, so older removal code cannot leave grants behind.
Remaining alpha limits
A real public HTTPS ingress is still required. This release does not provision a
tunnel, configure a provider's web account, establish access to another device,
or verify deployment on Botter's VM. The inspected development VM has no configured
TCP destinations or VPN. A configured issuer is not evidence of public reachability.
Owner approval requires identifying the exact initiated request, not trusting a
client-supplied name. OS-owner access can still read private files, including
confidential-client registration secrets: this is not strong secret isolation.
Actual ChatGPT/Claude web clients, direct cross-origin browser MCP, conversation
capture, history import, native views, and VM persistence remain unverified or unimplemented.
MIT licensed. Memory, authentication, and local inference stay on the user's host.
This release also rejects unsupported IPv6 HTTP issuers and empty userinfo before configuration. It supersedes the alpha.1 candidate before publication; the earlier Git tag remains immutable.
Dots Brain v0.2.0-alpha.2
Dots Brain now has a repeatable removal path: disable the shared instance, revoke
its credentials, stop its managed process, and detach unchanged managed client
entries while keeping personal memory. Separate client profiles now receive
separate credentials, so disconnecting one does not revoke another.
Changes
uninstall --dry-runpreviews without changing files or stopping processes.uninstallpreserves memory, revisions, deletion suppression, local models,
unrelated settings, and later user edits. Partial cleanup is explicitly reported.- The disabled instance cannot be restarted by a leftover current-version bridge;
reinstall requiresup --resumeor an explicit bootstrap installation. disconnectremoves one recorded connection. Remote issuer revocation and
legacy shared credentials remain explicit follow-up steps.- English guides now cover uninstall/reinstall, upgrading, troubleshooting,
everyday memory use, and the full documented local lifecycle.
Installation and removal
Use the versioned source checkout or the installer plugin ZIP with Python 3.11+
and uv. Follow the repository's setup skill. Publishing this installer package
does not register a ChatGPT plugin automatically.
The CLI removes the service integration, not its own program files. The documented
agent workflow completes package or dedicated checkout removal according to the
installation method. Personal-data erasure is a separate explicit operation.
Older custom client paths may require inventory; they were not recorded by alpha.1.
Validation
Python 3.11.16 and 3.12.14 each passed 47 tests locally, with the unchanged opt-in
real-model test skipped. Lint, formatting, documentation links, and wheel/source
builds passed. The release workflow repeats checks on both supported versions.
A clean disposable source installation passed actual Claude Code 2.1.287 health
verification, removal, bootstrap reinstall, retained-memory verification, repeated
removal, package uninstall, and disposable checkout removal. No user installation
or personal memory was removed. Earlier semantic and stress measurements remain
documented as historical evidence; they were not rerun for this lifecycle change.
Remaining alpha limits
Public ingress, web OAuth, automatic conversation capture, history import,
automated backup/restore, and native ChatGPT views are not implemented. Dot VM
persistence and deployment remain unverified. Private credential files are not
isolated from their OS owner. External supervisors, older binaries, and unknown
legacy configuration locations are outside automatic removal's inventory.
MIT licensed. This release adds no runtime dependency or paid service.
Dots Brain v0.2.0-alpha.1
Dots Brain now automates local service startup and supported client setup. One bootstrap command can prepare the memory store and local embeddings, start the shared service, configure a client, and verify writes and reads through the generated bridge without copying a token.
This is a local automation alpha, not a completed autonomous web deployment. Public ingress, web OAuth, conversation capture, and native ChatGPT views remain unimplemented.
New behavior
- Repeatable Linux background startup; concurrent installations reuse one process and store.
- Automatic service recovery when a configured local bridge reconnects, including canonical-port recovery after a crash.
- Claude Code, Cursor, Codex, and generic MCP JSON adapters that preserve unrelated settings and refuse conflicting connections.
- Private credential reuse, generated-bridge verification before saving client settings, and synthetic write-probe cleanup.
- Explicit separation between memory access, application activation, conversation capture, device access, and public ingress.
Fixes demonstrated by load tests
- A blocked SQLite writer no longer stalls the network event loop or unrelated reads. Read and write work have separate bounded worker limits.
- New source records no longer scan the full-text index to delete nonexistent entries.
- Embedding backlog processing retains bounded batches without sleeping between every active batch.
- Startup waits for a killed process's worker threads to release its canonical port.
Verification
Tagged CI and the
release build both
passed on Python 3.11 and 3.12. Release assets were built from the exact annotated tag.
- Python 3.12: 34 passing tests including the prepared real model.
- Python 3.11: 33 passing tests; the opt-in real-model test was skipped.
- A clean source installation with embeddings enabled completed the bootstrap and bridge write/read checks. Real Claude Code 2.1.287 reported
Connectedin an isolated test profile. - Storage/HTTP stress: 10,000 writes, 10,000 identical retries, and 1,000 HTTP write/read pairs with 32 workers; integrity, isolation, revocation, restart, and deletion checks passed.
- Embedding stress: 200 synthetic records, 96 Czech/English queries, and eight clients; expected facts appeared in the top three for all six repeated synthetic prompts.
- Observed service peak RSS: about 61 MiB without embeddings and 684 MiB with the pinned CPU model. These are development-workspace measurements, not Dot VM capacity guarantees.
Read the stress evidence and raw reports, verification details, and autonomous setup contract.
Install
Extract dots-brain-0.2.0-alpha.1-plugin.zip into a writable directory and follow its setup skill. On the chosen Linux memory host, an agent can run:
python scripts/bootstrap.py --data-dir /absolute/private/memory --semantic --connect claude-codeUse cursor or codex for another supported client on that same machine. For other devices, the agent needs an authorized execution path and an existing securely provisioned connection; it must not create a second memory store.
The release includes the installer/source ZIP, Python wheel, Python source distribution, and SHA256SUMS. The ZIP contains an onboarding plugin manifest and skill; it does not automatically register a public ChatGPT plugin. License: MIT.
Remaining platform requirements
The inspected managed VM has no configured TCP destinations, VPN, or persistent systemd runtime. The installer does not modify that platform policy. Autonomous web setup still requires a supported stable public route and client OAuth registration. Local credential files remain readable by their OS owner; strong secret isolation is not claimed. Local reconnect recovery does not provide continuous supervision or automatic VM boot startup.
Dots Brain v0.1.0-alpha.2
Dots Brain is an MIT-licensed shared memory service for MCP-compatible assistants. This is a working local alpha: storage, retrieval, scoped access, and local transports are implemented. It is not yet the complete autonomous Dot VM deployment.
Included
- Transactional SQLite storage with source references, revisions, project filtering, and explicit deletion with reimport suppression.
- Six memory tools using the official MCP SDK, with stdio, authenticated loopback HTTP, and a stdio-to-HTTP bridge to one shared store.
- Optional pinned multilingual embeddings running locally on CPU, with verified model artifacts and no paid inference API.
- Deterministic local bootstrap, diagnostics, scoped client credentials, and an agent onboarding skill.
- English documentation and a permissive MIT license.
Fixed in alpha.2
Concurrent installers could fail while enabling SQLite WAL. Initialization now retries journal-mode lock contention within a bounded deadline. Regression tests cover temporary locks and recovery after timeout while preserving existing data.
Verification
GitHub CI passed on Python 3.11 and 3.12, including tests, lint, formatting, project validation, and package builds. Local runs passed 23 tests on each Python version; the opt-in real-model test was skipped for this SQLite-only fix. Another 240 synchronized initialization calls passed.
The initial alpha also passed a real multilingual model smoke test. That historical result is documented separately in verification evidence; it is not a production benchmark or a Dot VM resource guarantee.
The attached assets were rebuilt from the exact annotated tag by the release workflow. Both Python verification jobs and the asset upload passed. The wheel, source distribution, and installer ZIP match the SHA-256 digests of the locally prepared packages.
Installation assets
dots-brain-0.1.0-alpha.2-plugin.zip: versioned source checkout including the onboarding plugin manifest, setup skill, dependency lockfile, bootstrap, and documentation. Extract it into a writable directory and follow the README. This package does not automatically register a public ChatGPT plugin.dots_brain-0.1.0a2-py3-none-any.whl: Python package.dots_brain-0.1.0a2.tar.gz: Python source distribution.SHA256SUMS: checksums for the three assets above.
Python 3.11+ is required. Start with the README and installation guide.
Current limits and next milestone
Public HTTPS ingress, web OAuth, automatic provider configuration, conversation capture, native ChatGPT views, and MCP Events remain unimplemented. Dot VM persistence, process supervision, quotas, and strong credential isolation have not been verified. Current credentials use private files; an agent with access to those files can read them.
The next milestone is a verified deployment on the actual memory host with authenticated public ingress and an external client's read, write, restart, and revocation path. No paid hosted database, authentication service, or embedding API is required by this alpha.