Changelog
What's new in SourceVault. Everything below runs on your own hardware, with local models and no source-code egress.
2026-10-25, v1.67.0: MCP over HTTP, the network door for a team server
Until now the MCP server ran only where the client ran: every developer indexed locally, and a team server had no MCP door. This release adds one. A team server now serves MCP over HTTP behind named agent tokens, so one governed install answers every developer's Claude Code or Cursor, with the same tools, policy, redaction and audit chain as before. The pre-release security review of that work tightened repository scope on every door, and that fix ships here too.
Added
- MCP over HTTP at
POST /mcp (docs/MCP.md, "Connecting to a team server"). Connect with claude mcp add --transport http sourcevault https://<host>/mcp --header "Authorization: Bearer ${SOURCEVAULT_AGENT_TOKEN}". The door takes a named agent token on every request and has no unattributed mode and no shared-secret fallback; a missing or revoked token is 401, a token not scoped to the door is 403. Plaintext is served to loopback only: from anywhere else the server needs TLS or a trusted TLS proxy, otherwise 503 tls_required. Origin and Host are validated against the advertised origin. Both MCP protocol eras are served on the one endpoint: 2026-07-28 clients statelessly with the revision's header checks, older clients through an initialize session bound to their token. Limits are per agent (120 requests a minute, 20 ask_codebase per five minutes, one ask_codebase in flight), calls are bounded by a timeout, and every refusal at the door is an auth_failed record in the audit chain (#517).
- The
mcp-http agent surface. sourcevault agent mint <name> --surfaces mcp-http --repos ... mints a token for the door. It is a separate grant from mcp on purpose: a token minted for the local stdio server never gains network reach without the operator saying so (#517).
- The deploy guide covers the door (docs/DEPLOY_SERVER.md): the three exposure rules, the
SOURCEVAULT_MCP_* knobs, and a checklist for running a team server on a Kubernetes cluster that also hosts other things (#518).
Changed
- Repository scope is one string in the list, on every door. The review found that a token scoped to one repository could read any other by naming it as a one-element list, because the engine coerces
["other"] to "other"; that "*" and comma pairs let a scoped token ask across every repository; and that a scoped token could list every repository, watch and attestation. Now a scoped agent names exactly one repository as a string, anything else is an agent_repo_scope refusal that is recorded, listings are filtered to the agent's repositories, and the signed HTTP API's scope check follows the same rule (#519).
- Tool arguments are type-checked against each tool's schema before the handler runs, for every MCP caller on either transport (#519).
- The MCP server's dispatch moved out of the stdio process into a module both transports share; the stdio server behaves exactly as before (#516).
Upgrade notes
- Nothing to do for stdio setups:
claude mcp add sourcevault -- sourcevault mcp and the Claude Desktop bundle are unchanged, and local tokens keep working as they did.
- To open the door on a team server: mint a token with
--surfaces mcp-http, make sure the server is behind TLS or a trusted proxy with SOURCEVAULT_TRUST_PROXY set, set SOURCEVAULT_URL to the public origin, and give the client the claude mcp add --transport http line above. docs/DEPLOY_SERVER.md, "The MCP door", has the detail.
- One visible change for existing MCP clients: an argument of the wrong type, such as
n_results sent as the string "5", is now a tool error naming the type instead of being coerced. Well-behaved clients send the types the schema declares and see no difference.
2026-10-24, v1.66.0: One-click install for Claude Desktop, and a registry listing
Until now the MCP server reached a client by hand: claude mcp add for Claude Code, a JSON stanza for everything else. Hosts that install MCP bundles, Claude Desktop first among them, now get SourceVault with one click, and the official MCP registry lists it, which is where the directories agent users browse take their entries from.
Added
sourcevault-mcp.mcpb, published with every release beside the tarball. The bundle is a launcher for the installed product: it finds the sourcevault command (the bundle's "command" option, PATH, the places the installers put it, or on Windows the WSL2 distribution) and runs sourcevault mcp with stdio handed through. The product is not inside the bundle, so it keeps upgrading through Homebrew or the self-updater as before. With nothing installed the bundle says so and shows the install line for the platform. Its options are the server's environment variables: "Agent token" (SOURCEVAULT_AGENT_TOKEN), "State directory" (SOURCEVAULT_STATE_DIR) and the command path; all optional (#511).
- The official MCP registry (registry.modelcontextprotocol.io) lists
ai.sourcevault/gateway, pointing at that bundle by URL and SHA-256. The release workflow publishes the entry after the tag is pushed, from a hash of the asset it downloads back from the release, so the listing pins exactly what customers get (#511).
Upgrade notes
- Nothing to do. Claude Code setups through
claude mcp add are unchanged. Claude Desktop users: download the bundle from the latest release and open it, or install from the registry; SourceVault itself must already be installed.
2026-10-24, v1.65.0: A published container image, and one macOS install
The team-server path asked for a source checkout: git clone, then docker compose up --build, on a machine that may have neither git nor the build tools. Every release now publishes a ready image for two platforms, so a server install is a Compose file and a pull. On macOS the installer carried a second channel beside Homebrew that none of the product's own tooling understood; it is retired, and the move to Homebrew is written down.
Added
- A public container image. Each release builds
ghcr.io/sourcevault-ai/sourcevault for linux/amd64 and linux/arm64, tagged with the version and, for full releases, latest, and labelled with the version it carries. compose.yaml names that image, so docker compose pull && docker compose up -d runs the published build while docker compose up --build -d still builds from a checkout; SOURCEVAULT_IMAGE pins a version. The dashboard is built once on the build platform and production dependencies are resolved per target, so nothing native runs under emulation that need not (#506). The image job runs on the lab runner and a manual build_image dispatch rebuilds the image for a release that missed it (#508, #509).
Changed
- macOS installs through Homebrew only.
install.sh on macOS stops and prints the three Homebrew lines instead of installing a launchd LaunchAgent. The one macOS action left in the script is --uninstall-launchd, which removes a script install's agents and leaves config, state and mirrors in place for the move. preflight.sh checks the Homebrew service and names the retired path when that is what is loaded (#507).
- The scripted installer's closing lines point at
sourcevault open and sourcevault doctor instead of a grep for the token (#505).
Upgrade notes
- Homebrew and Linux installs: nothing to do.
- A macOS install made by
install.sh keeps running as it is, but the script will not update it again. The playbook's "Moving a script install to Homebrew" section lists the values to keep from the old env file, install.sh --uninstall-launchd, the brew install, and where to point REPO_ROOT and SOURCEVAULT_STATE_DIR. Keeping DASHBOARD_TOKEN keeps every agent token and MCP client working.
- Compose deployments can switch from
up --build to pull at the next update; both keep working.
2026-10-24, v1.64.0: Two lines to a working install
After brew install the user still had seven steps ahead: start the service, start Ollama, pull two models, find a 64-character token in a file whose path differs by platform, paste it into the unlock screen, and only then open a dashboard that, on a fresh machine, could not search until the models had finished downloading. This release makes the install brew install and sourcevault setup, and makes the minutes before the models arrive useful instead of broken.
Added
sourcevault setup. The post-install tail as one command, on every platform: start the service when it is down and wait for it; wait for Ollama; pull the embedding model and the reasoning model for this machine's RAM tier through Ollama's streaming API with progress, skipping what is present (--reasoning-model <name|none> overrides the tier, --lite skips the step); run the doctor's checks; open the dashboard signed in. Idempotent: on a working install it verifies and opens (#502).
sourcevault open. Opens the dashboard already signed in, without ever showing the token. The command reads the token the way the server does, exchanges it for a single-use sign-in code that expires in sixty seconds (POST /api/dashboard/session/handoff, bearer-authenticated), and opens the browser with that code; the dashboard removes it from the address bar before redeeming it for the ordinary session cookie. The token is never displayed, logged, or placed in a URL. --print writes the link instead, for an ssh session; on WSL the Windows browser opens (#501).
- Lite until the models arrive. A fresh install whose Ollama has no embedding model at first start runs lite (keyword and symbol search, file reads, the repo map, the MCP server) instead of failing, and records that the server chose this. It then watches Ollama, and the moment the embedding model is listed it turns lite off and reindexes every repository with vectors. A toggle you make yourself ends the automatic behaviour; an install already running lite by choice, or one whose environment sets
SOURCEVAULT_LITE, is left alone. The dashboard says what is happening and what ends it (#503).
Fixed
sourcevault doctor recognised only Homebrew's old launchd label for the service and reported it as not loaded on Homebrew 6; both labels are asked now (#500).
Upgrade notes
- Nothing to do. Existing installs have a lite setting written or models present, so the automatic lite behaviour never engages on them. Run
sourcevault setup once if you like: it verifies and opens.
2026-10-24, v1.63.0: Is it working?
Only Linux and Windows installs were health-gated. On macOS `brew services start` returns before the server boots, and the installed command line had no way to ask whether the install works: npm run doctor is the pre-install preflight, and it lives in a source checkout. The macOS instructions also had the model pulls before anything had started Ollama, which fails on a fresh Mac.
Added
sourcevault doctor. The post-install check, on every platform, read-only: the install channel and the version on disk; the env file and the dashboard token (none is a failure, since the dashboard fails closed); whether the server answers at the install's own address and runs the installed version (a process still serving the previous version after an upgrade is the common miss, reported with the restart command); lite mode and where it is set; Ollama with the embedding model and the reasoning model, each with the pull command when missing; the stores; the repositories and how many are ready; and whether the service manager has the service. PASS, WARN and FAIL lines, exit 1 on any FAIL, --json for tooling (#498).
Changed
- The macOS install steps run in working order. Start the service first (it starts a down brew-managed Ollama itself at boot, so the separate Ollama start is gone), pull the models, which need that running Ollama, then
sourcevault doctor. The README now sends you to Settings → Engine for the lite toggle, where it is (#498).
Upgrade notes
- Nothing to do. Run
sourcevault doctor after the upgrade: it confirms the running server is the new version.
2026-10-24, v1.62.0: The overview, answered first
v1.61.0 built the overview layer on every install: the repository map at reindex, and a local-model summary per module behind `sourcevault summarize`. Measured afterwards, that layer never reached a caller. For "what are the main modules of this repository and how are they organised" the vector search ranked the summaries first, the heuristic rerank buried them in the thirties under code chunks matching the word "main" in a file name, and ask cited none of them. This release seats them where the question wants them, and only there.
Changed
- Overview questions lead with the repo map and module summaries. A question about the shape of the whole or of a module ("how is this repository organised", "give me a high-level overview of this codebase", "what does the control plane crate do") now returns the module summaries in the first slots, with code behind them, in search and in ask. The detection is deliberately narrow: words that only ever mean shape ("high-level", "architecture", "main modules") count on their own; words that also describe behaviour ("overview", "structure", "layout", "organised") count only beside a named whole (repository, codebase, crate, module, app); "overall" alone never counts; and anything that names an identifier or a file is a code question and is unchanged. On a code question the summaries earn nothing, and a repository that was never summarized sees no change. Two knobs:
CODE_OVERVIEW_SUMMARY_SLOTS (default 3) is how many summaries lead, CODE_OVERVIEW_SUMMARY_BONUS (default 6) keeps them in the candidate set before the final stage (#496).
Upgrade notes
- Nothing to do. Repositories with a map and summaries answer overview questions differently as soon as the new build is running; run
sourcevault summarize <repo> on any repository that has only the map to give it the summaries the layer leads with.
2026-10-23, v1.61.0: The overview, on every install
Chunk retrieval answers "where is X" well and "how does X work overall" badly: a dozen fragments from a dozen files, and no picture of which modules exist or how they relate. The repo map that fixes this existed, but only a source checkout could build it. Now every install has it.
Added
- The repo map builds at reindex. Every full index, and every incremental run that changes something, rebuilds the repository map (every module, its files and their symbols) from the chunk metadata it just wrote, beside the symbol graph and the history index. It is one embedded document, so an overview question retrieves the overview itself and ask grounds its architecture answers on a cited skeleton of the codebase instead of guessing it from fragments. Lite mode skips the step, since the map is an embedded document; a failure warns and leaves the index intact (#493).
sourcevault summarize <repo>. Adds one local-model summary per module on top of the map, for the deeper overview. Summaries stay opt-in because each one is a generation-model call; --map-only rebuilds just the map. The command refuses in lite mode and says why, and says when the map landed but no model was chosen to write the summaries (#493).
Fixed
- The dependency audit gate no longer fails on the advisories published after v1.60.0: body-parser (GHSA-27r3-jxmh-p828) in the backend, and vite, zod and undici among the dashboard's development dependencies. Lockfile-only bumps in both trees, no manifest change (#493).
Upgrade notes
- Nothing to do. Each repository gains its map at its next reindex (one extra row in its collection). Installs in lite mode keep indexing as before and do not build the map.
2026-10-13, v1.60.0: Refusals on the console
Ten refused dashboard requests in twelve milliseconds from one host were invisible on the Gateway view and surfaced only in the quarter report. A security console should show that first.
Added
- An authentication card on the Gateway view. Refused sign-ins, signed-API calls and webhook deliveries for the month, counted in the error colour the moment there is one, with the accepted sign-ins beside them; a table of the refusals newest first with where they were refused, the source host and the reason; and a by-source line when more than one host is involved. The console payload carries the same data under
authentication for anything else that reads it (#489).
Upgrade notes
- Nothing to do. The card reads records the audit log already keeps, so refusals from before the upgrade appear as soon as the new build is running.
2026-10-13, v1.59.0: The page a reviewer files
A SOC 2 or ISO 27001 reviewer asks a short list of questions about AI coding agents. This release answers them on one page, from the records the install already keeps.
Added
- The compliance evidence summary.
sourcevault report evidence (and GET /api/dashboard/report/evidence) maps the activity report for a period onto six controls: is agent access bounded by policy and are refusals recorded; does every agent act under a named, scoped identity; are secrets redacted before content reaches a model; is activity logged in a tamper-evident record that exports to a SIEM; which commits did AI write, which touched security-relevant code, and is that attested; are changes to the security configuration themselves recorded. Each row names the criteria it speaks to (SOC 2 Trust Services Criteria and ISO 27001:2022 Annex A), the question a reviewer asks, what the period's records show, how to verify it, and a status: evidenced, partial, or not evidenced. The policy in force and the active agent tokens are read when the page is generated and marked as current state. The HTML form is a single printable A4 page with no script and no external asset, so it saves as a PDF from any browser; Markdown and JSON carry the same content. The page says what it is: evidence for your own assessment. SourceVault holds no certification, and the references name criteria, not certificates (#486).
Upgrade notes
- Nothing to do. The summary reads the same records as the activity report, so a period with the audit log off is reported as such rather than as a clean sheet.
2026-10-10, v1.58.0: One question, answered on your terms
SourceVault never phones home, so the only way to learn which half of the product an install uses is to ask. This release asks, once, at the moment the answer is freshest, and makes answering cost one click and no privacy.
Added
- The usage summary.
sourcevault report usage (and GET /api/dashboard/report/usage) builds a counts-only picture of this install: version, access mode, days in use, sources, which features are on, policy rules, agent tokens, attestations, and ninety days of audited activity by surface, with named versus unattributed events, denials, redactions and DLP findings. No repository, file, question, person or host appears in it, and a test feeds names into a fixture log to prove none come out. The text ends with the question: did you come for search and Ask, or for policy and audit? It is copied to the clipboard or written to a file, and sent nowhere; pasting it into Discord or support@sourcevault.ai is your own action (#476).
- The question, where it belongs. The free-tier notice after the trial, and the trial banner in its last two days, ask it with a Copy a usage summary button beside it. Settings → About gains a Copy summary row for everyone else. A failed copy points at the terminal command instead of failing quietly (#476).
Upgrade notes
- Nothing to do. The summary reads the audit log, so it has data only for the months the log was on, and it says so.
2026-10-10, v1.57.0: The evidence leaves the box
Two things ship. The Gateway's records now export to a SIEM and roll up into a period report a compliance review can file, and the dashboard comes out of a five-phase UI/UX review with the same features in a quieter, more consistent, more accessible shape.
Added
- Audit export for a SIEM.
sourcevault audit export streams the hash-chained monthly files as lossless JSONL (chain fields included, so the receiver can recompute the chain), ArcSight CEF, or RFC 5424 syslog framing with the JSON record as the message. --since and --until bound the period, --out writes a 0600 file, each month's chain verdict goes to stderr, and the exit code is 3 when a month fails verification, so a scheduled export can alarm. sourcevault audit verify prints the verdicts alone. The dashboard serves the same download at GET /api/dashboard/audit/export with the verdict in the x-sourcevault-audit-chain header (#474).
- The AI activity report.
sourcevault report ai-activity writes, for a period (default: this quarter to date), what AI read through the Gateway by surface, agent, repository and file; what policy stopped by rule, agent and file, with DLP findings by rule; identity and configuration changes; and what AI wrote: commits per indexed repository, the ones disclosing AI authorship, the security-relevant ones by category, and the signed attestations recorded in the period. Every section states its coverage, and the report ends with how to reproduce each number. Markdown for a reviewer or JSON for a GRC tool; the writes section needs the provenance feature and says so when it is off. Also at GET /api/dashboard/report/ai-activity (#474).
- A date window on the provenance scan.
scanProvenance and the commit reader accept since/until, and the scan now lists every AI-authored commit it saw as ai_commits, not only the alerts (#474).
Changed
The dashboard, phase by phase (#468, #470, #472, #473):
- Foundations. Design tokens live on
:root, so every drawer, modal and dropdown follows the theme; muted text clears 4.5:1 on every surface; Inter is self-hosted; every custom control has a visible focus ring; the repository card's disclosure and the empty composer are real buttons; reduced-motion covers the overlays; the shell uses dynamic viewport height so phone browser chrome no longer clips the footer.
- Ask and Search. The Search/Ask switch sits inside the composer; lite mode says there is no model before a question is typed; the model button says what is true (lite, pinned by the environment, or the pick); result rows are a title, one muted line and the excerpt with matches marked inline; the source drawer shows the code first and folds "Ask about this snippet" under it.
- Lists and drawers. History, Pinned and the archive share one list: collapsed rows grouped by day, a filter box, and the answer on demand. Archive is now the "Archived" filter on History, and Runbook is named Pinned (the export keeps its runbook.md filename). Drawers go full-width on phones, and the source drawer and the file explorer work side by side. The Gateway view has one empty state instead of four empty tables, and its alerts link straight into Settings.
- Settings and dialogs. Tabs reorder to Appearance, Plan and license, Features, Engine, Source control, Security, About; Engine gathers lite mode, the Ask model and the backends. Every toggle reports its own save and its own refusal. Activating a key says so; rotating the token asks first; shutting down lives in a Danger zone. Clone, Add local and Connect have labelled fields; Add local indexes in the background like Clone; Delete says what is removed for each kind of source; a success banner confirms clones, sign-ins and model pulls.
- Mobile and polish. A category picker replaces the collapsed settings tabs on a phone; the nav drawer closes when it opens something; the login card explains where the dashboard token lives; a self-update waits until no field has focus and no Ask is running, then says "Updated to vX" once; "Install app" appears when the browser offers it.
- Indexer.
.terraform, .terragrunt-cache, .serverless, .cache, .parcel-cache, .yarn, .pnpm-store, Pods and DerivedData join the default ignore list; a provider's changelog under .terraform/ had been outranking a repository's own auth module (#470).
Upgrade notes
- Nothing to do for existing installs. The new CLI subcommands are there after
brew upgrade sourcevault; the report has data only for the months the audit log was on, and it says so in its Coverage section.
- Two things moved in the dashboard. The Archive view is the "Archived" filter on History, and the Runbook view is called Pinned.
2026-10-10, v1.56.1: The ask model is a choice
Three changes to the model manager (#464; v1.56.0 below was a version bump that shipped without them). The dashboard no longer names a model nothing can run, the picker stops reading like a spec sheet, and the model Ask runs on is chosen once, on the server, for every surface.
Added
- The ask model is a server setting. Picking a model in the dashboard (Select, or Pull and Select) writes the
ask_model setting, so Ask over MCP and the Hermes plugin runs on the model the dashboard shows; before, the pick lived only in the browser and those surfaces never saw it. The order, resolved per call: SOURCEVAULT_ASK_MODEL (or OLLAMA_CHAT_MODEL) in the service environment, then the setting, then the machine's RAM-tier suggestion while Ollama has it, then none. With none, Ask declines and says where to pick one instead of failing inside the Ollama call, the source drawer answers 409 ask_model_required, and indexing lands the repo map without module summaries and logs the skip (#464).
Changed
- No model is assumed. The frozen qwen3.5 default is gone.
/api/dashboard/models reports ask_model only when the chosen or suggested model is installed, alongside ask_model_source and ask_model_configured. The sidebar mirrors it and reads "Select a model" when there is nothing to run on, including after an uninstall from the terminal or a switch to lite mode (#462, #464).
- The picker shows names. Options are grouped Installed and Suggested. Each row is the model name with one small fit tag (fits, tight, won't fit) when the machine's RAM gives a verdict; size, RAM tier and note sit in one line under the picker for the picked model. Search matches on the name only (#463).
- The picker warns when the pick is not installed, and goes read-only with a note when the environment names the model (#464).
- Deleting the picked model clears the setting, and the
ask_model value passes the same name policy the picker enforces (#464).
Upgrade notes
- Installs with the suggested model pulled need nothing: it is used while it stays installed.
- Installs that chose another model in the dashboard before this release should pick it once more. The old pick was browser-local and is not migrated; until then Ask runs on the suggestion if installed, else declines with a message naming the model manager.
- Operators who pinned
SOURCEVAULT_ASK_MODEL see the picker disabled with "set by the environment". Remove the variable and restart to choose from the dashboard.
- Hermes plugin v1.5 (#461) is on the public mirror. It needs nothing on the server side: its README now matches v1.55, and it explains the licensing denials an older server can still send.
2026-10-10, v1.56.0: Version bump only
Published with the v1.55.0 feature set: the model-manager pull request was refused by the forge's status checks while the release pull request merged, so this tag carries no product change. The changes it was meant to carry are in v1.56.1 above.
2026-10-09, v1.55.0: The engine is free
The commercial shape changes with this release, and the product follows it: the engine is free forever on one repository, the Gateway is what a license buys, and Team becomes an annual per-seat term. Nothing already installed stops working; several things that used to stop now keep going.
Added
- A free tier. When the 7-day trial ends, SourceVault no longer locks: search, file reads, Ask, and repository onboarding keep working on one repository, on every surface (dashboard, signed API, MCP, Hermes), forever and without a key. The trial still runs the Gateway on that repository for its seven days; afterwards only the Gateway bundle and Multi-repo Ask wait for a license. The dashboard shows a dismissible free-tier notice instead of a lockout, and the plan card reads "Free" (#455).
- Lite mode is a switch. Settings → Features → Lite mode turns the model-free profile on and off without a restart; the server, the MCP server, and index workers all agree within seconds. SOURCEVAULT_LITE in the service environment still wins when set, and the switch says so. Turning lite off is refused until Ollama lists the embedding model, so a flip can never turn search into errors (#453).
- Seats as a signed plan limit.
issue-license.js --seats N and the Stripe seats metadata record the seat count a per-seat plan was sold for; the plan card reads "Team · 10 seats". Contractual until per-user roles ship (#454).
Changed
- Positioning. The README leads with what the Gateway does — policy, redaction, the audit chain, provenance, agent identity, enforced once on every surface — and places private code memory underneath it (#454).
- Prices and terms (docs/BILLING_POLICY.md, docs/LICENSING.md, docs/TEAM_FULFILLMENT.md): Starter is $390 one-time (was $1,350; renewal $160), Pro stays $4,500 (renewal $1,850), the Starter → Pro upgrade is the $4,110 difference, and Team is an annual per-seat term from $15,000/year with a 365-day key, unlimited sources, and Team support included. Keys issued before 2026-10-09 keep their original terms. A paying customer on a build newer than their updates window now keeps the engine too and sees renewal guidance instead of a lockout (#455).
scripts/release/reprice-catalog.js moves the Stripe catalog to the new list prices: dry-run by default, --apply creates the new Prices on the existing Products, archives the old ones, and prints the ids for the site's environment (#455).
Upgrade notes
- Nothing to do for licensed installs. Keys, features, and limits are unchanged; the plan card may now show a seat count if your key carries one.
- Installs whose trial had ended come back to life on this release: the one repository they indexed is searchable again, and the Gateway features stay locked until a key is entered.
- Operators who pinned
SOURCEVAULT_LITE=1 will see the new switch disabled with "set by the environment". Remove the variable and restart to hand control to the dashboard, or leave it to keep the deployment pinned.
2026-10-07, v1.54.0: The security review ships
A principal-level security review of the whole product, fixed in four phases plus a sweep of the smaller findings (#449, #450). Two themes ran through it: a hostile repository that the operator chooses to index, and trust decided by the bind address instead of by who is actually calling.
Added
- Signed releases. The Linux/WSL self-updater no longer pipes the vendor install script into bash. It downloads the exact release tarball the update check named, verifies it with the running install's own code (sha256 against the published checksum, and from this release on an ed25519 signature against a public key embedded in the build), stages it beside the install, swaps the directories with the state dir carried across, and keeps the previous tree with a
rollback.sh next to it (#449).
- Replay protection that survives a restart. Every signed route shares one nonce store, persisted to the state dir, so a captured request can no longer be replayed on a sibling route that shares the secret, or after the service restarts (#450).
- Model pulls are confined to known registries. Ollama's registry and Hugging Face by default;
SOURCEVAULT_ALLOWED_MODEL_REGISTRIES admits others (#450).
- The managed Qdrant history store is authenticated and bound to loopback: a per-install API key is generated into the state dir and sent on every request; a server that does not accept it is refused rather than adopted (#449).
Changed
- Placeholder secrets are no longer credentials. A
replace-with-... or REPLACE_ME... value copied from an example file is treated as unset at boot (the log says placeholder_secret_ignored): the dashboard provisions its own token, the signed API locks on any exposed host, and the webhook stays off (#449).
- A trusted reverse proxy counts as an exposed host. With
SOURCEVAULT_TRUST_PROXY set, an unset CODE_SEARCH_HMAC_SECRET no longer leaves the machine API unsigned to proxied clients (#449).
- Body-only relay signatures are refused on exposed hosts.
/task and /result require timestamped (v2) signatures on any deployment reachable beyond loopback; local-only installs keep accepting them and log a deprecation. SOURCEVAULT_HMAC_REQUIRE_TIMESTAMP=0 keeps dual-accept everywhere for a relay peer that cannot send timestamps yet. The result webhook to Hermes now carries an x-webhook-signature-v2 beside the body-only header (#449).
- The indexer confines symlinks to the repository. A committed link that resolves outside the source tree is skipped and logged, never read; single-file local sources keep working through their recorded target (#449).
.sourcevaultignore matching is linear, no longer a regex: a hostile ignore file cannot stall the dashboard. One semantic change, matching gitignore: ** inside a single segment no longer crosses / (#449).
- Sync-and-reindex pulls only clones. A local folder added in place is indexed as it sits and is never
reset --hard onto its upstream (#449).
- A deleted audit head is a finding. Verification reports
head_missing for a month with records and no signed head on an install that holds its attestation key; each append also logs audit_chain_head with the terminal hash, so shipped logs anchor the chain off the box (#449).
- The session probe is rate-limited on failed credentials only; the MCP server and every CLI load
.env from the install directory, never the working directory; SOURCEVAULT_TLS_MIN_VERSION must be TLSv1.2 or TLSv1.3; git clones pin the transport and end option parsing before the URL; agent-token revocations can no longer be overwritten by a concurrent last-used touch (#449, #450).
Upgrade notes
- Relay peers on an exposed or proxied host must send timestamped signatures or the operator must set
SOURCEVAULT_HMAC_REQUIRE_TIMESTAMP=0 until they do. Local-only installs are unaffected.
- Example-file placeholders stop working as secrets. An install that still runs on
replace-with-... values will boot with a generated dashboard token (read it from the credential file named in the log) and, if exposed, a locked signed API until real secrets are set.
- Ignore files using
** inside a path segment (lib**.js) now match within that segment only; use **/ for directories.
- This release's updater verifies the next one. Installs on v1.54.0 require every later release to carry a valid signature; the next tarball published by the release job is signed, so nothing is needed from the operator.
2026-08-26, v1.53.1: The plan card names the key
Added
- The dashboard's plan card shows which vendor key signed the licence — "Licensed to … · key
<fingerprint>" — the fingerprint v1.53.0 started reporting, and the one thing support asks an operator to read out during a staged signing-key rotation (#433).
Changed
- Dependency refresh, all within ranges: antd 6.6.1, vite 8.2.2, vitest 4.1.11, zustand 5.0.15 and the rest of the dashboard tree; @types/node 26.3.0, eslint 10.9.1, express-rate-limit 8.6.2 and the rest of the backend tree (#431, #432).
2026-08-26, v1.53.0: A signing key that can rotate
Added
- The license signing key can be rotated without stranding a single license. The product now verifies against a list of vendor keys (
VENDOR_PUBLIC_KEYS_PEM, current signer first), so a rotation is staged rather than a cliff: the next public key ships a release ahead while the old one still signs; the signer switches once customers are on that build; the old key is retired only when nothing it signed can still take an update. Every issued license keeps verifying on every build it is entitled to run, and nothing needs re-issuing. A verified license now reports which key signed it (signer, a short fingerprint the keygen prints and Settings exposes as license.signer), so support can tell at a glance. The recipe is written up in LICENSING.md, "Rotating the signing key"; the old overwrite-in-place mode stays as the emergency path and is documented as such (#428).
Changed
- Pinned Node 24 images refreshed to the current digests in CI, the release pipeline, and the Dockerfile (#426, #427).
2026-08-26, v1.52.1: The API spec catches up
Added
- The OpenAPI spec at
/api-docs covers every surface the docs describe. POST /api/webhooks/git (the reindex webhook), the docs endpoints themselves (/api-docs.json, /api-docs/sign), and the agent-identity header on every signed route — <signature-header>-agent naming a minted agent, signed with that agent's key — were served by the product but absent from its own spec (#423).
2026-08-26, v1.52.0: Branded HTTPS on WSL and Linux
Added
sourcevault tls-setup understands WSL. It detects the distro from the kernel string (so it works from an ssh session, where WSL_DISTRO_NAME is not set), fetches mkcert when it is absent — from the pinned v1.4.4 release into ~/.local/bin, its sha256 verified against the value compiled into the tool before it is ever run, a mismatch refused and deleted — and handles the trust boundary the Windows browser sits behind: the Linux trust store is skipped, the root is copied to C:\sourcevault-rootCA.pem, and the one certutil step is printed for an admin PowerShell. Importing a root into Windows is a trust decision, so that step stays yours. Native Linux gets the same mkcert fetch, and a trust-store install that fails without sudo now prints its remedy instead of failing the run (#419).
- The portless URL on Linux and WSL, offered rather than left to you. When
:443 is refused to an unprivileged user and you are at a terminal, tls-setup explains the one persistent setting (net.ipv4.ip_unprivileged_port_start=443, re-applied at boot by systemd-sysctl), asks, and on yes runs exactly sudo tee and sudo sysctl --system — then re-probes :443 and drops the port from the URL only once a listener there is proven. Declined, failed, or non-interactive: the ported URL and the two commands, printed (#421).
Fixed
- A
:443 that binds but belongs to someone else no longer fools tls-setup. The probe used to ask only "can I bind 443?" — on a box where a reverse proxy or a NAT rule already owns the port (a k3s ingress on the WSL reference machine, for one real case) the bind succeeds and every connection is still answered by the other party, so the tool advertised a portless URL that served a 404 under a stranger's certificate. The probe now connects to its own listener and expects its own nonce back; a hijacked port is reported as such and the ported URL is kept (#419).
Changed
- Docs checked against the code as it stands: Gateway in every tier, SQLite as the default store, current models and defaults, and surfaces that had shipped but were still documented as pending (#420).
- The release workflow can announce a version after the fact (
workflow_dispatch with a version input; posts the entry and refreshes the site changelog) for an entry written or amended after the tag (#417).
- Pinned images:
ollama/ollama 0.32.15 in Compose (#384), semgrep/semgrep 1.174.0 in CI (#385).
- For anyone scripting it:
tlsSetup() in scripts/ops/tls-setup.js is now async (#419).
2026-08-26, v1.51.1: Health checks on TLS installs
Fixed
scripts/healthcheck.sh — the script behind the installer's final validation step and the stack-healthcheck timer — probed plain http://127.0.0.1:9000/ regardless of how the service was configured. On a TLS install (sourcevault tls-setup) that failed every time: upgrades ended on a failed validation step, and the timer logged a failed unit every 15 minutes for as long as the install had been on TLS. It now reads the port and TLS setting from the env file the service itself loads; an explicit SOURCEVAULT_PORT or SOURCEVAULT_SCHEME still wins (#414).
Changed
- The Gateway is on every tier — announced late. v1.51.0 also shipped this, and its announcement did not say so: the standalone Gateway tier introduced in v1.50.0 sold for one day and is retired. Every license, Starter and Pro included, carries the Gateway bundle (access policy, secret redaction, the audit chain, AI-change provenance, agent identity) — the same bundle the free trial runs — and tiers differ by source cap and by the retrieval extras from Pro up. Keys issued for the one-day tier keep working, read as Pro, and renew as Pro. The v1.51.0 entry below now records it (#412).
2026-08-26, v1.51.0: The relay is governed
Security
- The task relay is governed by the same Gateway as the MCP surface. Until now the relay was described as the Gateway's agent-to-agent surface but ran outside it: no policy decision on a hand-over, no secret scrub on what the executing agent reported back, and no record in the audit chain. Now a Sentinel rule that fences a whole repository (
**, or a deny default) refuses delegation to it with 403 policy_denied — before the task id is reserved, so a permitted retry is not answered "duplicate" — and records the decision; path-scoped rules keep governing reads, not the hand-over. Every result on its way back to the delegating agent, inline completion and /result callback alike, passes the DLP rulepack (a whole-repo redact rule wipes the free text instead), and every hand-over and outcome lands in the chain as task_relayed then task_completed or task_failed, sharing one trace — never the goal text (#411).
- A named agent token cannot delegate against a repository it is not scoped to.
/task now runs the same repository-scope check as the signed HTTP routes and refuses with 403 agent_repo_scope; previously the relay was the one signed surface that skipped it (#411).
Changed
- The Gateway is on every tier. The standalone Gateway tier that v1.50.0 introduced sold for one day and is retired: governance is the product, so gating it behind one tier made the free trial — which runs the Gateway — a downgrade for Starter and Pro buyers. Every license, Starter and Pro included, now carries the Gateway bundle (access policy, secret redaction, the audit chain, AI-change provenance, agent identity); tiers differ by source cap and by the retrieval extras from Pro up. Keys issued for the one-day tier keep working and read as Pro, whose entitlements are identical, and renew as Pro. The dashboard's plan card and the agent-identity prompt no longer name a Gateway tier (#412).
Fixed
- The installer's final health checkpoint honours a custom
PORT and a TLS-enabled install instead of probing plain HTTP on 9000, so a branded-HTTPS or non-default-port install no longer reports a false "not healthy" at the end of an otherwise successful run (#410).
2026-08-25, v1.50.0: The trial runs the Gateway
Added
- The free trial runs the SourceVault Gateway on your one repository. An unlicensed install gets the access policy, secret redaction, the tamper-evident audit chain, AI-change provenance, and named agent identities for the seven days — so the first thing you see is a policy decision and a verifiable chain, not a search box. Multi-repo Ask stays a licensed feature, the repository cap stays at one, and the features close the moment the window ends (#407).
- Gateway is a plan of its own. Pro's retrieval plus the Gateway on up to 15 sources, self-serve at sourcevault.ai — with an updates renewal and a Pro → Gateway upgrade at the list-price difference. Team is the Gateway deployed for a team; Enterprise adds the compliance pack. The dashboard's plan card names the tier, and
issue-license.js documents the key shape (#407). Retired in v1.51.0: the Gateway is in every tier.
2026-08-25, v1.49.0: Monorepo scale on a laptop, and no vector database to run
Added
- Code vectors live in SQLite. A store seam for the code collection with a
sqlite-vec backend: binary-quantized index plus an exact float32 rescore, in a file under the state dir. Measured at parity with ChromaDB on every benchmark corpus (express/zod/flask reproduce its rankings with zero flips) while the search process drops from a ~450 MB daemon plus a resident HNSW graph to an ~80 MB store (#395, #396). The default for fresh installs; an install that indexed on ChromaDB keeps it until you migrate (#397).
- git-history lives there too. The history store gains a SQLite backend as a slice of the same file, so a fresh install runs no vector database service at all. ChromaDB becomes opt-in: the installer adds it only with
--with-chroma or keeps an existing one, preflight, /health?deep=1 and the boot probe ask the active backends before touching it, compose puts it behind --profile chroma (#401).
npm run migrate-vectors -- --to sqlite copies existing code indexes and history slices across without re-embedding (118,952 chunks in 27 s) and stamps the manifests so incremental runs carry on (#395, #401).
- Settings -> Advanced: Vector store and History backend controls, health-checked before committing, with the env-managed state shown (#395, #401).
- Resumable full reindex. A full index builds into a staging collection under an append-only journal and swaps in when complete; an interrupted run resumes from where it stopped instead of starting over, and a run where every file failed refuses to replace the working index (#387).
- Hardware-aware model defaults. The reasoning model and context window follow detected RAM (qwen3.5:9b on 16 GB+, qwen3.5:4b below, 16k/8k context); the installer tunes Ollama with flash attention and an 8-bit KV cache; hybrid-reasoning models run non-thinking for cited answers. The model manager shows what fits this machine and whether the install is in lite mode (#392, #393).
- A monorepo benchmark fixture: the five corpora as one repository (20,616 files, 118,952 chunks) with re-rooted and cross-repo questions, plus
npm run bench:attribution, which names the pipeline stage that loses each missed question (#392, #394, #398).
- Hermes plugin v1.4. Signs requests as a named agent when
SOURCEVAULT_AGENT_NAME and SOURCEVAULT_AGENT_TOKEN are set, so every call audits as that agent instead of the shared secret; preserves the server's structured error codes and Retry-After in slash-command output instead of collapsing them to one generic error (#381).
- Status reports the lexical index. A
lexical-index check shows repositories, chunks, and bytes on disk — at monorepo scale that file is a real share of the install's footprint and nothing reported it (#391).
Changed
- The cross-encoder scores one pair per pass. Its 30-pair padded batch was the search process's entire 2.5 GB: 2449 MB -> 343 MB RSS and p50 700 -> 558 ms on express, rankings unchanged (#398).
- No wall-clock index timeout.
SOURCEVAULT_INDEX_TIMEOUT_MS defaults to 0; the stall watchdog is the protection. The 30-minute cap would have killed the healthy 76-minute monorepo index at 40 % (#388).
- Indexing at scale: Chroma writes batched at 200, streaming symbol graph and repo map builds, per-repo sharded manifests, FTS5 pragmas, lexical index size in status (#388, #389, #390).
- Nightly retrieval gate runs each corpus on both vector backends (#399). BENCHMARK.md gains the monorepo-scale section: indexing on the 16 GB floor, the co-tenancy tax, sqlite-vec parity, CPU-only generation numbers, with the measurement artifacts committed under
bench/gates/ (#386, #399, #400).
- Agent benchmark harness (
npm run bench:agent) reports honest headline metrics — new context tokens and dollar cost, not cache re-reads, which had overstated the busier arm by ~10× — pins the checkout and index commit into every report, refuses to compare mismatched runs, and keeps the local model's reasoning out of the measured loop by default (#378, #379, #380).
2026-08-21, v1.48.0: A relay that retries and reports
Added
- The task relay retries, phase-aware. A failed call to the executing agent (network, timeout, 5xx) re-sends the task - it never ran, so nothing double-runs. A failed completion delivery re-posts only the webhook - executed work is never repeated. Three attempts with exponential backoff, every retry logged and annotated on the task (#376).
- Ask the relay how a task is doing.
GET /task/{task_id} (signed like POST /task) reports accepted -> ok | error, with delivery and in-flight-retry detail. Unknown ids answer an honest "unknown" - the state is process-local, so absence proves nothing (#376).
2026-08-21, v1.47.0: The audit chain answers who
Added
- Agent identity (SourceVault Gateway). Named, scoped tokens give every agent its own identity: mint from the Gateway console or
sourcevault agent mint <name> --surfaces mcp --repos a,b (plaintext shown once; only its hash is stored). MCP clients set it as SOURCEVAULT_AGENT_TOKEN; signed-HTTP and relay callers name themselves in a header and sign with a per-agent key. Every audit record now says who asked - and the signed HTTP API, which previously left no audit trace at all, records every call (#372).
- The console answers by agent. The Gateway view gains an Agents panel (mint, list, revoke), activity-by-agent, and who-columns on the activity and enforcement tables (#373).
- Sentinel rules can name subjects. A policy rule with
"subjects": ["ci-reviewer"] applies only to that verified identity - per-agent deny/redact on the same ordered, first-match engine, fail-closed for callers with no identity at all (#374).
Existing shared-secret setups keep working unchanged (they attribute as shared-secret); every previously issued Gateway license gains the identity feature automatically.
2026-08-21, v1.46.0: A calm power screen
Changed
- Shutting down no longer looks like an outage. From the moment a shutdown is confirmed, the whole dashboard yields to a power screen - "Shutting down", then "SourceVault is off" with the one-line restart command - instead of "Dashboard request failed" banners and flashing health warnings for a server you asked to stop. The screen watches for the server's return and brings the page back by itself (#366).
2026-08-21, v1.45.0: The stack follows SourceVault
Added
- Starting SourceVault starts its stack. If ChromaDB (or, on macOS, the brew-managed Ollama) is down at boot, SourceVault starts it and waits for it to come up -
brew services start sourcevault / systemctl --user start sourcevault is now the whole command. Opt out with SOURCEVAULT_NO_STACK_AUTOSTART=1 (#360).
- Shut down from the dashboard. Settings - About has a Power row: a confirmed Shut down stops everything, dependencies first, the server last. From a terminal, the same is
sourcevault stack up|down|status (#360).
On Windows/WSL and Linux, Ollama is deliberately not stack-managed - it runs on the Windows side (WSL) or as a root service (Linux), and often serves more than SourceVault.
2026-08-20, v1.44.0: A lighter dashboard
Changed
- The dashboard loads meaningfully less. First-load JavaScript drops from ~401 KB to ~354 KB compressed, and the repo file explorer's on-demand chunk shrinks from 1.6 MB to 356 KB - it had been carrying all 1,250 file-type icons inside itself; icons now load individually the first time a row shows one, then cache (#357). The syntax highlighter loads only when the first citation opens, views load on first visit (still cached for offline), and the app icons are a quarter of their old size (#358). No feature changes - everything is where it was, just cheaper to arrive at.
2026-08-20, v1.43.0: Silent tab updates
Changed
- Open tabs pick up server updates by themselves. The "SourceVault was updated / Reload now" banner is gone: a tab that notices a newer server version quietly reloads itself into it - the same service-worker-aware path the Settings updater uses, so it also covers upgrades done outside the dashboard (a terminal brew upgrade, the installer over SSH) (#354).
2026-08-20, v1.42.1: The CLI on your PATH
Fixed
- Scripted Linux/WSL installs now put the
sourcevault command on PATH (via ~/.local/bin), so sourcevault tls-setup works there the same as on Homebrew installs; existing installs gain it on their next update (#352). The per-platform install guide - tokens, branded HTTPS, the desktop app, updating - shipped alongside (#351).
2026-08-20, v1.42.0: Update from Settings
Added
- One-click updates from the dashboard. Settings - About now has "Check for updates" and, when a newer version exists, an "Update to vX.Y.Z" button that runs your platform's own updater (Homebrew on macOS, the installer on Linux/WSL) and reloads the page into the new version when it's up. The check only happens when you click - SourceVault never phones home (#349).
Fixed
- The branded https://dashboard.sourcevault.ai page and dashboard deep links now work on Linux and WSL installs; they previously fell back to a redirect or a 404 because of where scripted installs live on disk (#347).
- The Linux/WSL installer is sudo-free again on boxes that already have their dependencies: an already-serving ChromaDB is left alone, a reachable Ollama API counts as installed (no duplicate model downloads inside WSL), and re-running the installer now actually restarts the service onto the new version (#348). Honesty note: v1.40.0 announced most of these behaviors, but that release shipped them incomplete - v1.42.0 is where they actually landed.
2026-08-20, v1.41.0: Dashboard, once
Changed
- The branded host serves the dashboard at its root. https://dashboard.sourcevault.ai/ now IS the dashboard - no /dashboard/ path, no redirect; the subdomain already says it. The boot log, the Dock launcher, and
sourcevault tls-setup all advertise the clean form. localhost keeps its familiar /dashboard/ path (that is where the installable app and its offline machinery live), and every old URL keeps working (#345).
2026-08-20, v1.40.0: An install that asks for nothing
Ten findings from smoke-testing the one-line installers on real hardware across macOS, Linux, and Windows/WSL - every one fixed. The headline: a machine whose dependencies are already present now installs SourceVault without a single password prompt, and on Windows the dashboard survives a reboot without anyone logging in.
Changed
- The Linux installer is sudo-free when it can be. Dependencies are checked before apt is invoked; ChromaDB no longer requires Docker (when Docker is absent, the same native chroma the macOS path uses is installed via uv/pipx/pip and run by a new systemd user unit); a reachable Ollama API counts as installed - on WSL the Windows-side Ollama serves into the distro, and model pulls go through the API (#341, #342).
- Services run without a login session. The installer enables systemd lingering, so a headless boot - or a WSL distro started at Windows logon with no shell - brings SourceVault up by itself (#340). Rendered units carry node's real location on their PATH, so nvm-installed toolchains work under systemd (#342).
- The Windows one-liner hardened end to end (sourcevault.ai installers): correct content type for irm|iex, UTF-16-safe WSL parsing, the real Ubuntu distro name resolved and used everywhere, no terminal-closing exits, success claimed only when the dashboard actually answers, a printed way to read your login token from Windows, and a per-user logon auto-start so WSL and SourceVault come back after every reboot.
2026-08-20, v1.39.0: Browse on one edge, read on the other
Changed
- The file explorer docks left, and content docks opposite. The explorer opens from the left by default (a "Dock right" toggle in its header persists your choice), opens without a backdrop so nothing dims or locks it, and the source drawer always opens on the opposite edge of an open explorer - so the file tree and the file you clicked are visible side by side and can never overlap (#335). With the explorer closed, citations keep opening from the right as always.
2026-08-20, v1.38.0: The file explorer grows up
Changed
- Material Icon Theme icons in the file explorer. The tree and the path-filter results now carry the familiar per-language file icons and named folder icons (PKief's VS Code set, MIT), bundled at build time - nothing is fetched from a CDN, keeping the zero-egress posture. Unindexed files render dimmed so the badge and the tree agree. The icon set ships in the explorer's own lazy chunk, loaded on your first "Browse files" (#331).
Fixed
- Files opened from the explorer say "Ask about this file." The drawer's ask always grounded on the loaded file when there was no snippet - but every label promised a snippet. The copy now matches the grounding, with file-shaped example prompts; citations keep the snippet wording (#330).
2026-08-20, v1.37.0: See inside your repositories
Added
- A file explorer in the repository detail view. Expand a repo card and press "Browse files": a drawer shows the repository's directory tree - every file the indexer sees, with ignore rules applied, so the view matches what indexing considers. Filter by path to switch to a flat match list. Every file is badged indexed / not indexed, and clicking one opens it in the source viewer citations already use (#328). It doubles as a debugging tool for "why isn't this file found?": the file is either absent from the tree (ignored) or badged not indexed.
2026-08-20, v1.36.0: Ask while you ask
Changed
- Asks run concurrently. Submitting a question no longer locks the composer until the answer lands: ask as many questions as you like - follow-ups included - and each runs as its own job. Every in-flight ask shows its own progress banner labelled with its question, answers land at the top of the result strip as they finish, and the submit button reads "Ask (N running)" instead of blocking. A page refresh re-attaches to every ask still running, not just one (#325). The server always ran asks concurrently; the one-at-a-time limit was the dashboard's.
Also in this release: the re-published retrieval benchmark (docs/BENCHMARK.md) - 472 questions across five public corpora, zero errors, results tables newest-first (#326).
2026-08-20, v1.35.0: Every question gets its own tab
Changed
- Follow-ups are explicit. Asking a question no longer silently continues the previous conversation: each ask opens its own result tab. To have a conversation, press the new Follow up button on an answer - the composer shows the armed state as the familiar "Follow-up" chip, your next questions join that conversation's tab, and "New conversation" ends it. Selecting a tab is just viewing and never arms a follow-up (#323).
Previously every new ask joined the active thread by default, which made tabs act like collections - and archiving one appeared to take several results with it. (Nothing was ever deleted: the other questions stayed in History; only the shared tab closed.)
2026-08-20, v1.34.0: Results you can put away
Three history-management gaps reported from live use, one theme: actions that looked like they did nothing.
Changed
- Archiving a result puts it away. Archiving from an open answer now also closes that result's tab in the strip, instead of only moving the History row while the result kept sitting in the primary view (#321).
Fixed
- Every result can be dismissed. The result strip's close button is its only dismiss control, and the strip only appeared once you had two results - a lone result could not be closed at all. The strip now shows from the first result (#321).
- History rows have Delete. The per-row Delete existed only inside Archive; History now carries the same control, backed by the same permanent server-side delete (#321).
- Closing the active result tab now falls back to the newest remaining result, not the oldest (#321).
2026-08-20, v1.33.0: The dashboard reads like a feed, and updates in one click
Two quality-of-life fixes for the dashboard, both reported from live use.
Changed
- New results land on top. Each search or ask result now appears at the front of the result strip - reverse-chronological, like a feed - instead of behind everything already retrieved. Follow-up turns and repeated searches still update their existing tab in place, so the strip never reshuffles mid-conversation; when the tab cap is reached, the oldest results are the ones that fall off (#319).
Fixed
- The post-upgrade "Reload now" button works on the first click. It previously reloaded the page from the old service worker's cache, so the first click looked dead and the second click "worked". The button now fetches the new interface immediately, shows an updating state, and reloads itself the moment the new version takes over (#318). One caveat: the tab open during THIS upgrade still runs the old button one final time; the fix applies from the next upgrade on.
scripts/healthcheck.sh prints its timestamp with a POSIX date format; the GNU-only form it used produced an error line on macOS, the platform it most often runs on (#318).
2026-08-20, v1.32.0: The branded dashboard drops its port
One feature, small and visible: after sourcevault tls-setup, the dashboard URL is now https://dashboard.sourcevault.ai/dashboard/ - no port suffix.
Changed
- A second TLS listener on port 443 serves the same app as the main port, so the advertised URL needs no
:9000 while every integration pointed at the main port keeps working (#312, SOURCEVAULT_TLS_ALIAS_PORT). Fail-soft: if another daemon holds 443, the bind failure is logged with the remedy and the main port serves as before. tls-setup probes whether *your* machine can bind 443 before advertising a portless URL - modern macOS can unprivileged; on Linux grant CAP_NET_BIND_SERVICE and re-run it.
Fixed
sourcevault tls-setup run from a session without a terminal now explains that the first mkcert -install needs your password at a real terminal, instead of surfacing sudo's opaque error (#311). Once the root is trusted, the command works from anywhere.
Upgrade notes
- Already ran
tls-setup on v1.31.0? Run it again after upgrading and restart the service - it re-probes port 443 and updates the advertised URL. Nothing else changes.
2026-08-20, v1.31.0: Retrieval that finds the code you named, and a branded HTTPS dashboard
Every change in this release was measured on a benchmark that tripled in size first: the four retrieval question sets now hold 96 questions each (384 total, #303), adversarially adjudicated, with documentation-, test- and config-seeking questions covered for the first time. Each retrieval improvement below shipped only after a paired replay across all 384 questions showed gains with no losses; two further candidates (a wider vector fetch window, a retuned rank-fusion constant) measured as nulls and were closed without shipping.
Added
sourcevault tls-setup - the branded dashboard URL in one command (#309). Mints a locally-trusted certificate for dashboard.sourcevault.ai (whose public DNS already points at your own machine) with mkcert, and persists the TLS settings into every env file your service loads. After brew services restart sourcevault the dashboard lives at https://dashboard.sourcevault.ai:9000/dashboard/ with a real padlock - no egress, no real CA, nothing leaves the box. The certificate keeps localhost SANs so curl and healthchecks keep working (SOURCEVAULT_SCHEME=https scripts/healthcheck.sh). Entirely opt-in: installs that never run it are byte-for-byte unchanged, and http://localhost remains a browser secure context as before.
Changed
- Questions that name an identifier now find it. A prose question like "How does safeParse construct its error lazily?" previously reached retrieval with no exact-match signal at all; camelCase and snake_case mentions now feed the literal leg, scored against declared symbols only so call sites and tests cannot bury the declaration (#304). Separately, the search index now splits camelCase identifiers into their parts, so "parse" reaches inside
safeParse through the keyword leg too - at reduced weight, so exact-word matches still rank first (#308, CODE_SUBTOKEN_BM25_WEIGHT).
- Repos that ship a generated mirror of their own source stop paying for it twice. Near-identical copies of the same chunk (a mirror with rewritten import specifiers, e.g. zod's
deno/lib) now collapse to the canonical copy before ranking, like byte-identical copies always did (#305, CODE_TWIN_JACCARD).
- Questions about CI, pre-commit, dependabot, renovate or editorconfig are read as configuration questions and ranked toward the config artifact instead of having config demotions applied against their own answer (#306).
- Measured effect, file-hit@5 on the expanded sets: zod 0.635 -> 0.698, flask 0.854 -> 0.885; express (0.906) and ripgrep (0.854) unchanged. On your own repos the mention and subtoken legs are the ones most likely to show: questions that name a function or config tool now carry an exact signal they never had.
Upgrade notes
- First search after upgrading may be briefly slower. The keyword index adds a column for camelCase subtokens; on first open the mirror is upgraded in place from rows already on disk - no re-indexing, no re-embedding, one transaction. Nothing to do.
- Retrieval baselines from before this release are obsolete (the question-set fingerprint changed with #303). If you maintain your own baselines with
bench:retrieval, re-record them once on this version.
2026-08-19, v1.30.0: The audit release — fail-first fixes and per-repo collections only
A full-codebase audit (docs/CODEBASE_AUDIT.md) and the RAG modularization plan (docs/RAG_MODULARIZATION_PLAN.md) were executed end to end this release: fourteen stacked pull requests (#285–#298) plus follow-ups (#299–#301). Everything below is the operator-visible part; the internal restructuring — clients.js, ask.js, history.js and indexer.js each split behind their existing import paths — changes no behavior and is recorded in the two documents.
Security
- Cloning is gated by the same SSRF block list as every other host the server fetches from.
validateGitUrl carried its own allowlist copy without the loopback/private/link-local block, so a clone URL could point the server's git at an internal address. It now goes through the shared gate (#286); see Upgrade notes.
- A token embedded in a repository's remote URL no longer reaches the dashboard. The repos listing rendered
remote.origin.url verbatim, so an https://user:token@... remote — which an old sync override wrote to disk — exposed the token to any dashboard viewer. Credentials are now stripped on every branch of the URL normalizer (#286), and the override that wrote them is gone (#300); see Upgrade notes.
- The audit log's
month query parameter must look like 2026-08. It was spliced into a file path unvalidated, so a crafted month read files outside the audit directory (post-auth, .jsonl-suffixed — bounded, but real). Both audit reads now refuse anything else (#286).
- A typo'd
DASHBOARD_SESSION_MAX_AGE_SEC no longer rejects every session. A non-numeric value NaN-poisoned every cookie's Max-Age and expiry; it now warns and falls back to the 12-hour default (#286).
ssh:// clone URLs with an embedded password are refused, matching the https rule; SSH remotes authenticate with the server's keys (#286).
- Swagger "Try it out" auto-signing works again for the machine API. The docs signer kept its own copy of the signed-route facts and had drifted to body-only signatures, which the machine routes refuse as replayable. One shared registry now feeds both the guards and the signer, which emits timestamped v2 signatures for every signed route (#287).
- Licensed-feature gates fail closed. A settings or entitlements read failure used to become a 500 on the HTTP routes while the MCP gate treated it as feature-off; every gate now shares the MCP behavior, with the failure logged (#301).
Changed
- Per-repo collections are the only read path. The shared-collection fallback scheduled for removal in v1.28 is gone: a repository indexed before per-repo collections and never reindexed since reads back zero chunks until one full reindex (#292). See Upgrade notes — this is the entry to read before upgrading an old install.
- One-off token clones for Forgejo and custom remotes now require a username and say so in a clear 400, instead of authenticating as the literal placeholder
x-access-token, which Gitea-family servers reject with an opaque credential error (#286).
- Ask questions are bounded server-side at 2000 characters (
SOURCEVAULT_ASK_QUESTION_MAX_CHARS), rejected as question_too_long rather than silently truncated — the same contract the search path has always applied to queries (#301).
- Repositories still on the legacy shared collection are called out in the dashboard: their status carries
collection: "shared" and a stale reason naming the remedy ("indexed before per-repo collections — run a full reindex") (#292).
Fixed
- The nightly retrieval-quality gate is trustworthy again. Its four matrix jobs share one localhost on the CI runner and raced for the same two ports; the loser's servers died, its readiness probes passed against the winner's, and every question then failed against the wrong corpus's fixture — reported as a retrieval regression. Each corpus now gets its own ports, and each job verifies the servers it spawned are the ones answering (#299). Retrieval itself was never regressing: the race winner reproduced its committed baseline exactly.
- A corrupted
settings.json now warns as it falls back to defaults instead of silently reverting audit_log and sentinel to off (#289).
- The dashboard store constructs even when the browser refuses storage access (private modes, blocked storage): the localStorage reads that ran at construction time are now fail-soft (#287). Changing the code theme from the source drawer updates Settings immediately instead of after a reload (#290).
Upgrade notes
- If the install predates per-repo collections (v1.25) and any repository has not been fully reindexed since: those repositories will read back zero chunks after this upgrade — search and ask find nothing in them until one full reindex per repository. The dashboard identifies them:
collection: "shared" in the repos listing, plus the stale reason named above. Run Reindex on each; nothing is lost, the legacy rows are simply no longer consulted.
- Private-network git hosts must now be named. A clone URL pointing at a loopback, RFC1918, CGNAT, or link-local address is refused unless that exact host is listed in
SOURCEVAULT_ALLOWED_GIT_HOSTS — and * does not clear the block list; it means "any public git host", not "reach into my network". If your Forgejo/GitLab genuinely lives on 10.x, add its host to the setting.
- The undocumented
GITHUB_TOKEN/GITHUB_USER sync override was removed. It wrote user:token@ into .git/config on disk. Connect GitHub from the dashboard instead; the credential helper then covers clones and every later sync. A remote URL that already carries a token keeps working with plain git until the repository is recloned.
- One-off Forgejo/custom token clones need a
username alongside the token (the API returns missing_username naming the fix). Connections made through the dashboard are unaffected.
2026-08-12, v1.29.0: Sessions you can revoke, and retrieval that stays put
Security
- Logging out now ends the session. Dashboard sessions were stateless self-signed tokens with no revocation, so
DELETE /api/dashboard/session only cleared the caller's cookie and a captured value stayed usable until it expired, up to 12 hours later. The only real invalidation was rotating DASHBOARD_TOKEN, which signs everyone out. Logout now records the session nonce in a persisted ledger that verification consults, pruned as entries expire and capped by dropping the ones nearest natural expiry first.
- The authentication throttle covered one door of two. The limiter guarded
POST /session while every other /api/dashboard/* route authenticated the same token through a bearer header with no limiter at all. A gate limiter now sits ahead of dashboard auth and counts only unauthenticated requests, so operator polling is never throttled.
- Self-hosted provider hosts are checked against the git-host allowlist. The instance host arrived in the request body and was only checked for being parseable, with nothing blocking RFC1918, link-local, or the cloud metadata address. The server then fetched
https://<host>/..., and a token refresh would POST a stored refresh_token to whatever host the connection carried. The clone path already enforced the allowlist; these HTTP paths now do too.
- A guessable webhook secret is called out at boot. Unlike the generated
DASHBOARD_TOKEN, SOURCEVAULT_WEBHOOK_SECRET is operator-chosen and compared against an attacker-supplied header, and a correct guess triggers a repository reindex. The throttle on that endpoint is deliberately loose at 30 requests per 5 minutes, which caps a guessing run without stopping it. Entropy is scored over the alphabet the secret actually uses, so padding a short secret to length does not earn a pass. It warns rather than refuses, because the endpoint is optional and refusing would take search, MCP, and the dashboard down on upgrade.
- Release tokens no longer sit in a checkout's git config. A credential in a remote URL is written verbatim into
.git/config for the life of the job, and for the tap clone that is a token able to repoint what every customer brew-installs, left on a self-hosted runner. The tap clone, tap push, and tag push all pass it through http.extraHeader instead.
- The shipped runtime templates run SourceVault with fewer privileges. Indexing shells out to git against repository URLs a caller can influence, and neither the systemd unit nor
compose.yaml did any of the cheap kernel-side limiting around that. deploy/systemd/sourcevault.service now sets NoNewPrivileges, a private /tmp, a read-only home with an explicit writable list, and SystemCallFilter=@system-service. All three compose services drop every capability and set no-new-privileges. Directives that could not be verified against a live deployment, a read-only container rootfs among them, ship commented out with the checks they need first.
Fixed
- Indexing another repository no longer changes the results you get in the ones you already had. The keyword half of search filtered rows to a single repository but ranked them with
bm25() statistics gathered over every indexed repository, so term weights moved as unrelated code arrived: on the express fixture, file-hit@5 fell from 0.833 to 0.800 once flask was indexed beside it, with express's own index, questions, and query untouched. Each repository now gets its own full-text table, so a five-repository install retrieves the way a one-repository install does. Re-indexing a changed file used to leave the old version's terms behind in that index as well, inflating the same statistics and taking a slot out of every result set. Existing installs rebuild from text already on disk the first time they open the database, with no re-indexing and no re-embedding.
- Citations are checked against the sources the answer was given. Nothing validated generated
[S#] markers, so a model citing [S7] when it had five sources shipped a dead citation to the dashboard and misattributed grounding to MCP clients. The benchmark's grounded metric was satisfied by a single hallucinated marker, so the one number meant to police citation discipline was blind to the most common citation failure.
- Answers no longer spend part of their context budget on text the model has already been shown. When several chunks of one file went into the same block, they were joined as they were stored, so the roughly 200 characters (
CODE_CHUNK_OVERLAP) that chunking repeats at each seam appeared twice, right where the retrieval hit is, and the copy counted against CODE_ASK_CONTEXT_CHARS and pushed out blocks holding something different. Blocks are now rebuilt from line ranges, so the overlap that exists for embedding stops there and reaches neither the prompt nor the [S#] sources shown with the answer.
- A relayed result is marked delivered only once Hermes has it. The entry was written before the delivery was awaited, so a failed delivery left it claiming success. The 500 told OpenClaw to retry, the retry was answered "already forwarded" and suppressed, and the result was dropped with an info-level line to show for it.
- MCP clients are no longer told their results passed a gate that is switched off. The server advertised Sentinel policy and DLP filtering on every read no matter what the install enforced, and Sentinel is licensed and off by default. A client acting on that could forward content believing it had been scrubbed. The instructions now say which of the two is true, and
sourcevault://policy reports live enforcement state.
- Opening a citation from an Ask that covered several repositories now loads the file. The drawer asked the server for the file under the repository name of the view you clicked in, and for a multi-repository Ask that name is the comma-joined list of every repository in the question, so the read failed and you got the retrieved snippet with an error instead of the file. A citation now carries the repository its block came from. Asks against a single repository were never affected.
- Opening a citation while another is still loading no longer shows the wrong file. Clicking a second citation before the first arrived left whichever response landed last in control, so the drawer could show one citation's title and line highlighting above another citation's contents. The pending request is now cancelled when you move to a new citation.
- Reading the audit log no longer stalls the server. Every read loaded the whole file synchronously and split it into lines before keeping the last 200 records, or 2000 for the console view, so a month of activity blocked the event loop on each call. Reads now take the tail directly. The chain verdict, which is the expensive part, is cached for 30 seconds; set
SOURCEVAULT_AUDIT_CACHE_MS=0 to turn that off.
- Licence verification is cached for 5 seconds instead of running on every request. It walked up to three trial directories and verified a signature each time. Installing a key clears the cache immediately, so an upgrade takes effect at once, and 0 disables the cache.
- The trial banner's links can be reached from the keyboard. Three prompts in the expiry banner were anchors with no
href, so they took no focus and a keyboard or screen-reader user could not follow them to the licence form. They are buttons now. The licence form itself was always reachable through the sidebar Settings button. Archived interactions and repository cards also gained explicit Move up and Move down actions, in the archive row's action area and the repository card's overflow menu, so reordering no longer needs a drag.
- A repository whose name contains a comma no longer corrupts the selection. The dashboard held the repo selection as one string meaning three different things: a name, a comma-joined list, or the "*" sentinel. Every consumer re-derived the shape by hand, and a comma in a name broke the selection and every request built from it.
- Destructive confirmations follow your theme. They rendered with default tokens, so a delete dialog popped up light over a dark interface.
- A capacity that is not a number no longer switches off the limit it sets.
TASK_HISTORY_CAPACITY=5k became NaN, every size check against it was false, and the task-relay history grew for as long as the process ran. An unreadable value now falls back to 5000.
- The Docker image no longer carries the application twice. Ownership is set as files are copied rather than by a recursive chown afterwards, which had written the whole tree into a second layer. The build context also excludes nested
node_modules directories that a root-anchored pattern was missing, including the roughly 27 MB under scripts/demo.
npm run tune no longer recommends knob settings its question set cannot support. The sweep scored nine combinations on the same questions it then picked from, crowned the highest scorer, and printed it as .env lines to paste into production, but on a 30-question set one flipped question moves file-hit by three points, so the winner was often noise. Each combination is now compared against your current settings with the exact McNemar test the nightly quality gate already used, Holm-corrected across the grid, and has to survive dropping any single question. When nothing clears that, the report says so and keeps the defaults.
- Benchmark precision no longer scores questions that have no expected files. A question matched only on answer text scored a flat zero, pulling the reported average down with a number that measured nothing. Those are unscored now, the same way file-hit already was. Zero cited files where files were expected still scores zero, because that is a real miss.
Changed
search_codebase over MCP returns a compact result by default. Every reply carried the full chunk text, and the same payload was repeated as pretty-printed JSON in the text block and again in structuredContent. Content is now opt-in with include_content: true, matching the service default, which has always been off. The MCP projection also stops carrying chunk, repoName, fileBasename, directory and extension; file, preview, the line range, language, kind, distance and matchTerms all survive. Callers that reach /api/search-codebase over HTTP, the Hermes plugin among them, are unaffected.
- The installer pins the vector store to the version compose already pinned. It started Chroma from a mutable tag, so an upstream release could change what a customer runs between two installs of the same SourceVault. Linux pulls the pinned tag and digest, macOS installs the matching Python package, and Renovate moves all of them with the compose pin so they cannot drift.
- The signed task relay is supported rather than experimental. It is deliberately single-shot, which is a design decision rather than a caveat.
docs/RELAY.md gains the signing recipe it was missing: which routes accept the current scheme and why, the optional v2 form, the outbound webhook signing that runs the other way, and a worked example to check an implementation against.
Upgrade notes
- Connecting a self-hosted provider now requires its host to be listed in
SOURCEVAULT_ALLOWED_GIT_HOSTS, the same setting git operations already honoured. Connections made before this release keep working; a new connection to a host that is not listed is refused, and the error names the setting to add it to.
- An MCP client that read
chunk from a search_codebase result should now pass include_content: true. One that read repoName, fileBasename, directory or extension has no flag to restore them: they are gone from the MCP projection, and file is what remains to derive a path from.
- The privilege reduction is in the shipped templates, so an install already running
deploy/systemd/sourcevault.service needs the new copy and a systemctl --user daemon-reload. Create the writable directories before the first start, mkdir -p ~/.sourcevault/repos and your state dir, because the read-only home will not let the app create them. On a kernel with unprivileged user namespaces switched off the unit fails with status=226/NAMESPACE; comment out PrivateTmp=, ProtectHome= and ReadWritePaths= and keep the rest. An install that mirrors repos over SSH through an agent socket under /tmp also has to drop PrivateTmp=, since the private /tmp hides that socket. For compose, recreate the containers to pick up the new security_opt and cap_drop settings.
- If
CODE_RRF_BASE_WEIGHT or CODE_FETCH_MULTIPLIER is set in your environment because an earlier npm run tune printed it, re-run the tuner. The old report handed you the top scorer on that question set whether or not the set could tell it apart from the defaults, and the new one says outright when to keep your values and when to drop back to 60 and 8.
- If
SOURCEVAULT_WEBHOOK_SECRET is set to something short or low-entropy, this release logs a warning at boot. Nothing stops working; generate a longer random value when convenient. Installs that do not use webhook reindexing are unaffected.
2026-08-10, v1.28.0: A faster dashboard, and signed requests that expire
Fixed
- The dashboard no longer stutters while you type. Every keystroke in the ask box rewrote the entire cached view (status, repositories, history, archive, and every open result tab) to browser storage, on the same thread drawing the screen. It now saves only when something worth saving actually changed, and never more than once per half second. During an index run this was happening continuously in the background as well.
- Search got faster on large repositories. A query mentioning anything code-shaped pulled every chunk of the repository into memory and scored all of them, which on a hundred-thousand-chunk repository meant hundreds of megabytes of work per search. It now asks the index for the candidates it actually needs. Results are unchanged: the ranking runs over the same rows it would have found by reading everything.
- Ordinary questions no longer take the slow path. "How does the sendFile function work?" counted as a code query because it contains a parenthesis and the word *function*, so it paid for exact-match scanning it could not use. That test now looks for code shape rather than code vocabulary: a call, an arrow, a declaration.
- The repository list stopped being the slowest thing the dashboard does. It ran up to six git commands per repository one after another, counted indexed chunks by fetching every chunk's id, and worked out each repository's file types by fetching every chunk's metadata. Counting is now a count, file types are recorded when the index is built, and repositories are inspected several at a time.
- Changing the embedding model no longer corrupts an index in silence. Switching models left the stored vectors in the old model's space and every new search in the new one, and an incremental reindex would mix both into a single index with no way to tell afterwards. SourceVault now records which model built an index, rebuilds it when the model changes, and refuses to search across a mismatch instead of returning quietly wrong results.
- Git history indexing can no longer wedge. If an indexing run was interrupted partway through writing commits, every later run retried the same range and failed on the commits already stored, so history stayed stuck until a full rebuild. Repeat writes are now harmless.
- A delegated task is no longer re-run when only the reply fails. If OpenClaw finished the work but the completion could not be delivered to Hermes, SourceVault forgot the task had run, so Hermes' retry executed all of it again, once per attempt, for as long as the outage lasted.
- Provider sign-ins survive a crash or a coincidence. Connections, sources, settings, and repository order were each written by overwriting the file in place with no lock, so an interrupted write could leave unreadable JSON that read back as *no connections at all*, and two writes at once could lose one of them, including a freshly refreshed GitLab token, which ends that connection permanently. These files are now written atomically and changed one writer at a time, and an unreadable one is reported rather than silently treated as empty.
- In lite mode, the dashboard stopped reporting a server error for a model server it is designed to run without. The models list now comes back empty and says why.
Security
- Machine API authentication could be silently disabled. On installs that deliver secrets through systemd credentials (the hardening path the deployment guide recommends), the code-search, read-file, and history-search endpoints read their signing secret before those credentials were loaded, so they came up with no secret at all. On a loopback bind that means unsigned requests for repository contents were accepted, while the startup log reported authentication as enabled. Installs that pass the secret through the environment or a
.env file were never affected.
- Signed requests can no longer be replayed. A signature covered only the request body, so a captured request stayed valid forever: anyone able to observe traffic on a plaintext deployment could repeat a read-file request indefinitely and keep receiving the current contents of that file. Signatures now cover a timestamp and a one-time value, are rejected outside a five-minute window, and cannot be replayed inside it.
- The machine API now requires the new signature form and refuses the old one. See the upgrade notes.
- The nightly search-quality check can no longer pass while search is broken. It compared only the questions that returned an answer, so a run where every question failed compared nothing, found no regression, and reported success. Errors, and a comparison that covers too little of the baseline, now fail it.
Upgrade notes. One breaking change, and one automatic reindex.
*Signed requests.* If you call /api/search-codebase, /api/read-file, or /api/history-search from something you wrote yourself, it must now send x-code-search-signature-timestamp and -nonce alongside the signature, and sign timestamp.nonce.body rather than the body alone. The clients shipped with SourceVault, including the Hermes plugin, were updated and need nothing. Requests without the new headers are answered 401 timestamp_required. The /task and /result relay endpoints still accept the old form, because Hermes and OpenClaw sign those; set SOURCEVAULT_HMAC_REQUIRE_TIMESTAMP=1 to require it there too once they have been updated.
*Embedding model.* The first index run after upgrading records which model built each index. If you later change OLLAMA_EMBED_MODEL, CODE_EMBED_URL, or CODE_EMBED_DIMS, the next incremental run rebuilds that repository once rather than mixing two models' vectors, and searches against a mismatched index are refused until it is rebuilt. Existing indexes carry no recorded model and are left alone until something changes.
2026-08-10, v1.27.0: Sign in to GitLab without pasting a token
Added
- Sign in to GitLab by approving SourceVault at your GitLab instance instead of pasting a personal access token, the same way GitHub sign-in works. Works with gitlab.com and self-hosted instances; needs GitLab 17.9+ (17.3 behind a feature flag). Unlike GitHub (whose OAuth scopes grant write alongside read), GitLab's ask for read access and nothing else, so this gives up no privilege compared with a token. (#239)
- GitLab tokens expire after about two hours; SourceVault refreshes them in the background as part of the git operation that needs them, so a connection that worked this morning still works this afternoon with nothing to re-approve. (#239)
- Repositories now show which store holds their index, and anything still on the old shared store is tagged reindex pending. The move to per-repo stores in v1.25.0 was invisible until now: you were told to schedule a reindex without being told which repositories needed one. (#238)
Fixed
- A dashboard exposed over HTTPS could be advertised at a URL nobody can open: binding to all interfaces (
HOST=0.0.0.0) put that literal address into the startup link. It now advertises localhost, and warns when TLS is on and SOURCEVAULT_URL is unset — the case where your certificate names something else. (#241)
Security
- Updated a dashboard build dependency (
nanoid) past a high-severity advisory, GHSA-2v37-7h3g-55p8. It is a build tool, not something SourceVault runs or exposes, so no deployment was at risk. (#243)
The GitLab flow has never run against a live GitLab instance. No OAuth app is registered and nobody maintaining SourceVault uses GitLab. Protocol handling is well tested, but no test says whether a given GitLab version accepts the scopes as asked or whether the token authenticates a real clone. If you are first to enable it, expect to debug it. The token path is unaffected.
Upgrade notes. Nothing required. GitLab OAuth stays off until configured. Register an application in GitLab (User settings → Applications) with the device flow enabled, set SOURCEVAULT_GITLAB_CLIENT_ID, restart. Existing connections and every token login are unchanged. Bitbucket and Forgejo keep using tokens: neither implements the device grant, verified against a live Forgejo instance.
2026-08-07, v1.26.0: Sign in to GitHub without pasting a token
Added
- You can now sign in to GitHub by approving SourceVault at
github.com/login/device instead of creating and pasting a personal access token. The dashboard shows a short code, you enter it at GitHub, and the sign-in dialog closes itself once GitHub confirms. Nothing is relayed through a SourceVault server (your browser talks to GitHub, and your own machine exchanges the approval for a token), so this changes how you sign in without changing where anything is stored or who can see it. (#235)
- Settings → Source control now shows how each connection was signed in, so it is clear which logins you can revoke at the provider and which are a token you hold. (#235)
Access tokens are not going away, and for some setups they remain the better choice. GitHub's OAuth apps only offer coarse repository access: the scope that reaches private repositories also grants write access, which is broader than a fine-grained token limited to read. If you want SourceVault to hold the narrowest possible access to your code, keep using a fine-grained personal access token — both options stay side by side in the sign-in dialog, and this release does not change any connection you already have.
Upgrade notes. OAuth sign-in is off until it is configured, and upgrading alone does not switch it on; the sign-in dialog looks exactly as it does today until then. Turning it on takes two steps: register a GitHub OAuth app (GitHub → Settings → Developer settings → OAuth Apps) with device flow enabled, then set SOURCEVAULT_GITHUB_CLIENT_ID to its client ID and restart. Full steps are in docs/DASHBOARD.md. GitLab, Bitbucket, Forgejo, and custom remotes are unchanged and continue to use tokens.
2026-08-07, v1.25.1: Fixes a v1.25.0 reindex that emptied a repository's index
Fixed
- Reindexing a repository after upgrading to v1.25.0 could leave it with no index at all. v1.25.0 moved each repository into its own store, but an incremental reindex decides what work to do from a record of what it indexed last time — and that record described the *previous* store. Every file looked unchanged, so nothing was written to the new store, and the repository then reported zero indexed chunks. Moving a repository to its own store is now always a full index; later reindexes are incremental as before. (#233)
If you already hit this. Upgrade and reindex the affected repository once: the reindex now rebuilds it. Nothing was lost from your working copy, and no chunk content was destroyed; the index simply had not been written to the new store yet. Repositories you have not reindexed since upgrading were never affected.
2026-08-07, v1.25.0: Large repositories stop breaking search
Fixed
- Search against a large repository no longer fails outright. Every repository's chunks lived in one store, and a search narrowed to a repository with a metadata filter; past roughly 121,000 chunks that filter exceeded a limit inside the store and the query returned an error instead of results. It did not get slow; it stopped working, and because every repository shares that store today, one large monorepo was enough to break every search against it. Each repository now has its own store, so no filter is needed and the limit is never reached. Deleting a repository is faster for the same reason. (#231)
- An identifier-shaped query no longer downloads the whole repository to answer. The exact-match half of a search fetched every chunk from the store on each query: invisible on a small repository, and hundreds of megabytes per question on a large one. It now reads the local index that already holds the same rows. (#230)
Upgrade notes. Nothing to do, and nothing to migrate by hand. A repository moves to its own store the next time it is indexed; until then it is read the old way and behaves exactly as before. That means a large repository keeps hitting the failure above until you reindex it once, which is worth scheduling deliberately for a very large corpus rather than letting it happen during a working day.
2026-08-07, v1.24.0: Locking keeps your place, and an edited repository stops nagging
Changed
- Locking the dashboard no longer discards what you were working on. Unlocking puts you back where you were. Locking used to clear the source drawer's snippet conversations, which read like a privacy measure but was not one: the search results beside them kept their code in the browser's saved state either way, so the same source remained and the only reliable effect was losing your place. Locking ends the session and leaves the browser's stored state in place. If you need it gone, clear the browser's site data — and say so, because a built-in control for it is a reasonable thing to want. (#226)
Fixed
- A repository with uncommitted changes no longer reports itself out of date forever. It was marked stale for having a dirty working tree, which reindexing could never clear, because indexing does not commit anything. The dashboard offered a remedy that could not reach the state. Uncommitted files are indexed like any others, so a repository indexed after its edits is current and now says so. It reports out of date when files have actually changed since the last index, and reindexing clears it. (#227)
- Errors from a repository action stay on the Repositories page. A message such as "Too many reindex requests" used to appear above every view, including pages with nothing to reindex. (#228)
- Choosing a repository in the sidebar now shows that repository, opened, with its details. It previously switched to the Repositories page and listed all of them, leaving you to find the one you had just clicked. (#228)
2026-08-07, v1.23.0: SourceVault can serve its own HTTPS
Added
- SourceVault can now terminate TLS itself, without a reverse proxy in front. Point
SOURCEVAULT_TLS_CERT and SOURCEVAULT_TLS_KEY at a certificate and key and it serves HTTPS directly. This is for two situations a proxy handles badly: a machine on an internal network whose certificates come from a corporate authority, and an air-gapped install, where it adds nothing whatsoever to the list of outbound connections. No authority is contacted and no revocation is checked. For anything facing the internet a reverse proxy remains the better answer, and the existing recipes still apply. (#224)
- Certificates can be renewed without a restart: send the process
SIGHUP and it re-reads them from the same paths, without dropping connections. If the new files are unusable the previous certificate keeps serving and the log says why. (#224)
- Optional companions to the above:
SOURCEVAULT_HTTP_REDIRECT_PORT runs a small plaintext listener that redirects to the HTTPS port, so anyone who types the bare address arrives somewhere instead of watching the browser hang; and SOURCEVAULT_HSTS sends HSTS on a real hostname. HSTS is refused on local addresses no matter how it is set: it applies to a hostname and ignores the port, so sending it from a local instance would force HTTPS on every other development server sharing that name in the same browser. (#224)
TLS stays off unless you configure it, and a local install should leave it that way: browsers already treat http://localhost as a secure origin, so the dashboard installs as an app and shows no warning without any certificate at all. A misconfigured certificate stops the server from starting rather than quietly falling back to unencrypted traffic.
Security
- The dashboard no longer marks its cookies
Secure on the strength of an X-Forwarded-Proto header alone. The header was believed whether or not SOURCEVAULT_TRUST_PROXY said a proxy could be trusted, which is the setting that exists to answer exactly that question, and is off by default because anyone can send the header. Exposure was limited: a forged header affected only the sender's own session. (#223)
Upgrade notes. If you run SourceVault behind a TLS-terminating reverse proxy and have not set SOURCEVAULT_TRUST_PROXY, your dashboard cookies were being marked Secure by accident and will stop being. Set SOURCEVAULT_TRUST_PROXY to the number of proxy hops in front of the app (usually 1). That setting was always required for this deployment (it also governs whether rate limits and audit records attribute a request to the real client or to the proxy), so this is worth setting regardless. The server writes a single forwarded_proto_untrusted warning at the point it notices, rather than failing.
2026-08-07, v1.22.0: Deselecting a repository stops searching it
Fixed
- Removing a repository from the search bar no longer leaves it selected. The dashboard reapplied a default repository on every background refresh, and could not tell "cleared" from "not chosen yet", so a repository you had just removed quietly came back within seconds, and questions kept being answered from it. (#221)
- Removing a repository from the search bar now clears the results it retrieved. They used to stay on screen after the repository was gone from the search bar, and a question grounded in those results still answered from them. (#221)
- Deleting a repository now closes the results still showing its code. Every citation in them pointed at a file that no longer existed, and because results are remembered per repository and query, they also survived deleting and re-adding a repository of the same name: stale code shown beside a freshly built index. (#221)
2026-08-07, v1.21.0: Settings becomes a page
Changed
- Settings now opens as a full page. Seven unrelated groups (appearance, features, licensing, connected sources, storage backend, version, and token rotation) shared one scrolling column inside a fixed dialog, so reaching any of them meant scrolling past the others. Categories are tabs now: one group at a time, each short enough to read without scrolling. On a phone the categories move to the top and each setting stacks its label above its control. (#219)
Fixed
- The licence is described once instead of once per paid feature. Four rows each repeated who the licence belonged to, which said the same thing four times and read like a list of receipts. Plan & licence now names the plan, the licence holder, and how many sources the plan allows, in one place; each feature says only whether it is available. (#219)
- Prompts offering to take you somewhere to enter a licence key now open the licence section directly, rather than leaving you to find it. (#219)
2026-08-07, v1.20.0: Three more themes, and a drawer that stays where you put it
Added
- Terracotta now has a dark variant, carrying the warm palette onto low-light surfaces with brown-leaning near-blacks rather than the grey of the default dark theme. (#215, #217)
- A Tropical Forest theme, in light and dark. Neutral slate structure and a forest-green brand, with status colours designed as part of the theme: distinct green, amber, red, and teal for passing checks, pending review, urgent violations, and live data. It is built for sessions spent watching policy and audit state, where the reason to look at the screen is usually that something needs attention; the structure stays quiet so those colours carry the signal. (#215, #217)
Fixed
- The navigation drawer no longer reopens collapsed on a wide screen. Narrowing the window collapsed the drawer and recorded that as a deliberate preference, so a single visit in a small window left it collapsed on every later visit at any size. Resizing is treated as what it is, a reaction to the window, and only collapsing it yourself is remembered. Because a preference stored before this fix cannot be distinguished from one the window imposed, it is cleared once and the drawer opens until you choose otherwise. (#217)
Changed
- Repository status dots take their colours from the active theme. They were fixed values no theme could speak for; every existing theme keeps exactly the colours it had. (#215)
- The expanded drawer's footer is centred, with its action icons spaced evenly across the width instead of bunched against the left edge. (#217)
2026-08-07, v1.19.0: Choose how the dashboard looks
Added
- You can now choose the dashboard theme. Settings offers Match system (the default, which follows the operating system as before) alongside Light, Dark, and a new Terracotta palette. (#212)
- Terracotta is a warm, minimalist alternative to the default: a terracotta accent on cream, bordered in soft taupe, in place of the indigo-on-white that most developer tools settle for. The accent is a deeper terracotta than the palette's surfaces because it has to carry button text at the contrast ratio accessibility guidelines ask for; the softer shades that read better as a background do not clear it. (#212)
Security
- Updated js-yaml to 4.3.1, which carries the fix for CVE-2026-59870, a quadratic slowdown when resolving a crafted
!!omap value. It reaches installations through the OpenAPI specification generator rather than anything that reads untrusted input, so exposure was limited, but the advisory is rated high and the update costs nothing. (#213)
Fixed
- A dashboard on a machine set to dark mode, with no theme chosen, painted its first frame in light colours before correcting itself. The startup path only recognised an explicitly saved dark preference, so it disagreed with the rest of the app about what "no choice yet" meant. (#212)
2026-08-06, v1.18.0: The dashboard notices every index
Added
- The Repositories view now learns about indexing within five seconds, no matter what started it. Indexing triggered by a webhook push, resumed after a restart, begun in another browser tab, or already running before a reload previously reached the header only through the repository list, which refreshes once every forty-five seconds — long enough for a short index to begin and finish entirely unseen. A dedicated endpoint now reports the running jobs and nothing else, cheap enough to ask often. (#210)
Fixed
- The header could claim the corpus was up to date while an index was running. It described only the work the open tab had started itself, so an index begun anywhere else left it reporting a settled chunk count and "up to date" beside a repository card that was visibly still working. (e143dde)
- Indexing several repositories at once reported a misleading percentage. A repository whose file count was still being counted contributed nothing at all, so a second repository added mid-run stayed invisible and the figure tracked only the first, then fell sharply the moment the new work was counted. The percentage is now withheld until every running job has been measured, and the caption names the number of repositories so a pooled figure is not mistaken for one repository's progress. (e143dde)
- Adding a repository held the dialog open for the entire first index. The clone itself finishes in about a second, but the dialog stayed until the indexing that followed had completed, leaving the app unusable for minutes on a large repository. The dialog now closes as soon as the clone lands and indexing continues in the background, tracked on the repository card. (#206)
2026-08-06, v1.17.0: Reindexing only pays for what changed
Changed
- Incremental reindexing no longer reads a file to discover it has not changed. Size and modification time are recorded and compared first, so an unchanged file costs a stat instead of a full read and hash. On a repository carrying large committed artefacts this is the difference between minutes and moments: a reindex with nothing to do measured 375 seconds before and finishes instantly after. The first pass following the upgrade still reads everything once to record those details. (#204)
- Files larger than 2 MB are now excluded from the index. Generated bundles, vendored blobs, and committed fixtures cannot produce useful search results, and reading them on every pass was pure cost: one repository spent every reindex re-reading 34 MB of benchmark fixtures that failed to embed each time. The count is reported at the end of a run, and
SOURCEVAULT_INDEX_MAX_FILE_BYTES changes or lifts the limit. (#204)
Fixed
- A repository whose upstream history was rewritten (a force-push) could sit forever on a commit the remote no longer contains, reporting itself freshly indexed against code nobody could fetch. Sync now realigns the local mirror onto the remote branch, and a repository stranded that way reads as stale with an explanation instead of ready. (#202)
Upgrade notes. If you deliberately index files larger than 2 MB, set SOURCEVAULT_INDEX_MAX_FILE_BYTES before your next reindex; otherwise their existing chunks are removed as the index refreshes. If you have tooling that rewrites files while restoring their original size and timestamp, SOURCEVAULT_INDEX_ALWAYS_HASH=1 keeps the previous read-and-hash behaviour.
2026-08-05, v1.16.1: Secret redaction covers compound key names
Fixed
- Sentinel's secret scrubbing missed credentials stored under compound names. A value assigned to
secret: was redacted, but the same value under secretAccessKey:, secret_access_key =, or AWS_SECRET_ACCESS_KEY= was not, so an AWS secret access key could reach an agent in the clear while the access-key ID beside it was correctly redacted. The rule now matches any name containing a secret-shaped word. Ordinary identifiers and low-entropy values are unaffected. (#198)
Upgrade notes. If you rely on Sentinel's DLP pass, upgrade. Redaction happens at read time rather than at index time, so upgrading is sufficient: no reindex is required, and previously served content is not retroactively affected. Reads after the upgrade are scanned by the corrected rule.
2026-08-05, v1.16.0: Indexing that can't spin forever
Added
- A stop button on every repository card while an index runs: canceling stops the indexer immediately and records "Canceled by operator", so you no longer wait out a run you didn't mean to start. (#196)
- A stall watchdog behind every index job: if the indexer reports no progress for ten minutes (tunable via
SOURCEVAULT_INDEX_STALL_MS), it is stopped and the job reports exactly that, with what to do next, instead of showing an eternal spinner. "Slow," "stuck," and "silently dead" are now three different, visible things. (#196)
Fixed
- An index interrupted by a restart could leave a phantom "running" job that nothing was actually running, spinning in the dashboard forever. Interrupted jobs now resume cleanly (flagged as resumed), and any record that cannot be resumed is swept instead of surviving as a ghost. (#196)
No operator action is required for this upgrade.
2026-08-05, v1.15.0: Any git host, and sign-in that meets you at the door
Added
- Self-hosted GitLab: the GitLab sign-in now takes an optional instance host. Leave it blank for gitlab.com, or point it at your own installation (same API, same token scopes). Credentials always route to the instance you connected, never to gitlab.com by accident. (#191)
- Custom remotes: a new provider for any other git server reachable over HTTPS (Azure DevOps, Gerrit, cgit, an internal mirror). Enter the host, username, and the password or token the server expects for git, and private repositories clone and stay in sync. There is no repository autocomplete for custom remotes (no common API exists); paste clone URLs, and the first clone verifies the credentials. (#191)
- Settings has a new Source control section: every provider with its connection status, and sign in / disconnect right there, so you no longer have to hunt for sign-in inside the Add Repository dialog. (#191)
Changed
- A fresh install now leads with what to do: with no repositories yet, the Ask view opens with clone / add-local buttons instead of a search box over nothing, and the Add Repository dialog defaults to whichever source you are signed into. (#191)
No operator action is required for this upgrade.
2026-08-05, v1.14.0: Self-hosted Forgejo and Gitea join the provider list
Added
- Forgejo is now a first-class source-control provider alongside GitHub, GitLab, and Bitbucket; and because it speaks the same v1 API, Gitea works identically. Pick Forgejo in the Add Repository dialog, enter your instance's host and an access token (Settings → Applications on your instance), and private repositories autocomplete, clone, and stay in sync through the same credential helper as the hosted platforms. Pasting a clone URL from your connected instance selects the provider automatically. (#185)
Fixed
- An expired provider login (for example a revoked GitHub token) no longer logs you out of the dashboard: opening the clone dialog against a dead connection used to force a trip through the login gate on every attempt. Upstream credential failures now say what they are (check the named provider's token) and leave your dashboard session alone. The same applies to clone attempts against repositories that need authentication. (#184)
- The login gate now says why you are seeing it: if your 12-hour session expired it says so (instead of presenting as a fresh install), and hitting the login rate limit reports "too many attempts" rather than a wrong-token error. (#181)
No operator action is required for this upgrade.
2026-08-05, v1.13.2: Dashboard stops failing silently on vanished history
Fixed
- Archiving, deleting, pinning, or rating a history item whose server record no longer exists (a cleared history, or a delete from another window) failed with a silent 404: the dashboard kept showing the item (usually a result tab restored from the browser's saved snapshot) and nothing explained why the click did nothing. The dashboard now closes any tab still showing the vanished conversation and says so in a dismissible banner; other action failures are named instead of being dropped. Deleting an interaction also closes its open tab. (#179)
- Collapsed sidebar: the bottom controls (model, health, settings, lock, collapse) now line up in one centered column with the menu icons above, and the collapsed rail no longer shows a scrollbar that pushed its icons off-center. (#179)
No operator action is required for this upgrade.
2026-08-05, v1.13.1: Fresh benchmark numbers and self-announcing releases
Added
- Releases now announce themselves: after a release tags, the pipeline posts the changelog entry to the community Discord's
#announcements and regenerates sourcevault.ai/changelog from this file, so what you are reading is also the announcement. (This entry is the pipeline's first end-to-end run.) (#177)
Changed
- BENCHMARK.md carries a fresh five-corpus results table (2026-08-04, qwen3.5:9b on Apple M4 Pro/24 GB): express 0.900 file-hit / 1.000 answer correctness, flask 0.960 / 1.000, ripgrep 0.800 / 0.920, zod 0.550 / 0.900; every corpus at or above its search-only baseline on the compact model. The cross-encoder reranker's benefit is now measured: citation precision +0.04 (95% CI [0.01, 0.071], significant); its file-hit effect stays within noise. The kubernetes column is marked blocked on two filed scale issues (#174, #175) rather than populated or removed. (#176)
No operator action is required for this upgrade; there are no runtime code changes.
2026-08-04, v1.13.0: Lite mode runs without Ollama or a GPU
Added
- Lite mode:
SOURCEVAULT_LITE=1 runs SourceVault with no Ollama and no ChromaDB (no GPU, no 24 GB floor). Indexing builds the keyword (FTS5) index, symbol graph, and repo map; search runs the lexical + literal legs through the same fusion and ranking pipeline (including the local CPU cross-encoder); file reads, the dashboard, MCP tools/resources, Sentinel, and the audit chain work unchanged. Ask and semantic history search decline with a clear message instead of degrading silently, and npm run doctor offers lite mode when the services are missing. Unset the flag and reindex to upgrade the same install to the full stack. See README "Lite mode". (#170)
- The nightly retrieval gate now covers four corpora as a fail-fast-off matrix: express, zod, flask, and ripgrep (JavaScript/TypeScript/Python/Rust). Each corpus arms itself independently from committed embedding fixtures and baselines. kubernetes deliberately stays a manual benchmark (its fixture would be hundreds of MB of committed JSON); the decision is recorded in BENCHMARK.md. A babysitter script (
scripts/ops/check-retrieval-gate.js) reports per-corpus results and the gate's consecutive-green-day streak. (#169, #172)
- An agent benchmark harness (
npm run bench:agent): agent task success and token spend with SourceVault MCP versus raw file reading, over the same verified question sets as the ask benchmark, with paired statistics. Built for harness phase 2; deliberately not yet run, and BENCHMARK.md says exactly what may not be published until it is. (#172)
- Team fulfillment automation (
scripts/release/fulfill-team.js): creates and sends the one-off Team invoice and, only once it is paid, issues the Gateway-bundle key to the billing email and stores it as the recovery metadata, with refusals against unpaid invoices and double-issuance. Vendor-side only; no customer-facing change. (#171)
No operator action is required for this upgrade. Lite mode is opt-in; existing full-stack installs behave identically.
2026-08-04, v1.12.0: The SourceVault Gateway
Added
- The SourceVault Gateway: the compliance features (Sentinel policy + DLP, the hash-chained audit log, AI-change provenance) are now one named tier, granted by the single
gateway license flag. The flag expands to the three member features at verification time, so keys issued earlier with the features spelled out verify unchanged. The Gateway is the Team and Enterprise differentiator (since v1.51.0 it is in every tier); see the new docs/GATEWAY.md for the umbrella guide, including the honest-use boundary. (#167)
- A Gateway view in the dashboard, the operator console over the records the gateway already writes: agent (MCP) activity by surface and repository, Sentinel denials and redactions with their rules, and the audit-chain verdict translated to plain language (what
truncated, file_missing, and head_signature_invalid each mean). Backed by GET /api/dashboard/console, a pure aggregation of the month's audit log; viewing it records nothing, and with audit_log off the view says so. (#167)
- MCP resources and prompts. Resources:
sourcevault://repos, sourcevault://watches (metadata only, so watch baselines cannot bypass answer sanitization), sourcevault://policy, and a sourcevault://repos/{repo}/files/{+path} template served through the same Sentinel policy/DLP gate as read_repo_file. Prompts: four retrieval-pattern prompts (ground_in_repo, locate_implementation, pre_merge_provenance_gate, repo_orientation). Every resource read lands in the audit log. (#166)
Changed
- The MCP server now speaks the 2026-07-28 MCP specification as a dual-era server: modern clients work statelessly (
server/discover, per-request _meta versioning, resultType, cache metadata on list results) while legacy clients (2024-11-05 through 2025-11-25) keep the initialize handshake exactly as before. Both are served concurrently, so existing clients are unaffected. Tools gained titles, read-only annotations, and structuredContent; serverInfo reports the real package version. (#166)
- The task relay is promoted out of experimental as the Gateway's agent-to-agent surface. It remains deliberately single-shot (no queue, no retry, no orchestration), now documented as intended scope: orchestration belongs to the agents on either side, governance to the Gateway. (#167)
No operator action is required for this upgrade. Existing licenses, policies, and MCP client configurations work unchanged.
2026-08-03, v1.11.2: Same-day ip-address advisories and pin updates
Fixed
- Three high-severity advisories against
ip-address published later the same day as v1.11.1 (GHSA-mwp4-54f8-5fhr, GHSA-4xrf-jv44-h6hh, GHSA-22jq-vg5j-6vgg: SSRF/trust-boundary bypasses via octet decoding, CIDR-suffix classification, and IPv4-mapped IPv6 misclassification) are cleared via a patch-level lockfile bump. (#164)
Changed
- Routine pin updates, the first delivered by Renovate: the Docker base image digest (
node:24-bookworm-slim) and the ollama container tag (v0.32.5). (#160, #161)
No operator action is required for this upgrade.
2026-08-03, v1.11.1: Security bumps and the Forgejo-native pipeline
Fixed
- Two high-severity advisories published today are cleared via patch-level lockfile bumps:
brace-expansion (GHSA-rgw5-rvv9-x895, backend tree) and fast-uri (GHSA-7p8r-x3mc-p8w7, both trees), with a moderate postcss fix riding along in the dashboard tree. (#154, #159)
Changed
- CI/CD is now Forgejo-native end to end: the Semgrep job checks out with plain git (the pinned scanner image carries no Node for actions), the release pipeline publishes to the public GitHub tap while source, issues, and CI stay on Forgejo, the release-drift tracker is hardened against Forgejo's silently-ignored label filter, and Renovate replaces Dependabot for dependency and pin updates. (#153, #155, #156, #158)
No operator action is required for this upgrade.
2026-08-03, v1.11.0: The trial clock survives a wiped state dir
Changed
- The unlicensed trial's start date is now recorded in redundant, self-healing markers instead of a single
trial.json in the state dir. On a default install the clock is written to the state dir plus the user's XDG config and data directories (~/.config/sourcevault, ~/.local/share/sourcevault); the earliest surviving copy wins, deleted or hand-edited copies are re-seeded from it, and future-dated markers are ignored. Deleting the state dir or reinstalling no longer restarts the trial. Enforcement stays offline honest-use gating (no phone-home), so deleting every marker remains a documented reset and a license key is the legitimate path. (#149)
Upgrade notes
- Server deployments that set
SOURCEVAULT_STATE_DIR are unaffected: the marker stays under that single root and no user-level files are written. To spread redundant markers across additional persisted paths, set SOURCEVAULT_TRIAL_DIRS (path-delimiter separated); see deploy/server/sourcevault.env.example.
2026-07-31, v1.10.1: Dependency updates and release housekeeping
Fixed
- Dependency updates clear a new high-severity advisory in the dashboard's build chain (
brace-expansion, GHSA-mh99-v99m-4gvg) via an override to the patched version, alongside the week's routine backend and dashboard bumps. (#143, #144, #145)
- The release-drift tracking issue now closes at tag time instead of waiting for the next day's scheduled check, and the release process doc records the versioning policy (v1 stays; the minor number is the release number). (#141, #142)
2026-07-24, v1.10.0: The dashboard can tap you on the shoulder
Added
- Desktop notifications, off by default and delivered entirely by your browser: a watch flags drift, an index run of a minute or longer finishes or fails, or health turns unhealthy. Nothing routes through a push service: notifications fire while the dashboard is open (a tab or the installed app) and nothing leaves your machine. Enable them in Settings under Appearance. (#139)
- The app icon now carries a badge counting watches that drifted since you last looked; opening the Watches view clears it. (#139)
Fixed
- Watches now refresh on the dashboard's regular poll. Previously they refreshed only on page load or manual action, so a drift produced by a background reindex stayed invisible until a reload. (#139)
2026-07-24, v1.9.0: Choose your history backend from the dashboard
Added
- The git-history backend is now a dashboard setting (Settings -> Advanced) instead of an environment-variable-only switch. Choosing Qdrant verifies the backend before the change is saved, downloading and starting the managed engine on the spot, so a problem shows up in the settings dialog rather than during a later index run. A confirmation explains that each repository rebuilds its history index on its next reindex, backend changes are recorded in the settings audit trail, and installs configured via
CODE_HISTORY_BACKEND see the control disabled with a note that the environment is in charge. (#136)
2026-07-23, v1.8.0: History search reaches the machine API and the Hermes plugin
Added
- A new signed machine-API endpoint,
POST /api/history-search, answers natural-language questions about a repository's indexed commit history and returns matching commits with their metadata (hash, date, author, subject, provenance tags). It carries the same protections as the other machine endpoints: HMAC signing, rate limiting, and the Sentinel redaction pass; commit messages get the same secret scrubbing as code. (#129)
- The Hermes plugin (v1.3) gains a
/code-history slash command and matching LLM tools, so agents can ask "when did this change, and why?" against the local history index. Requires SourceVault v1.8.0; against an older install the command explains the version requirement. (#129)
2026-07-23, v1.7.0: Opt-in full git history
Added
- A "Full git history" toggle in Settings -> Features (free, off by default). Enabled, SourceVault indexes every commit in a repository instead of the latest 500. The first index of a large repository takes a while and shows progress; after that, each index run only adds commits that are new since the last one. Turning the setting off returns to the capped behavior on the next index. (#127)
- The git-history index can now run on Qdrant instead of ChromaDB (
CODE_HISTORY_BACKEND=qdrant). SourceVault manages the Qdrant server itself: a version-pinned binary is downloaded once, verified against a checksum, and run locally with its storage inside the SourceVault state directory; nothing to install or operate. Benchmarks on an 82,000-commit history showed filtered queries dropping from ~150ms to under 2ms on this backend. ChromaDB remains the default; existing installs are unaffected. (#126)
Fixed
- Deleting a repository now also removes its indexed git history, which previously remained in the history index forever. (#126)
2026-07-23, v1.6.0: Keyword search stops scanning the whole repo
Changed
- The keyword leg of hybrid search now runs against a SQLite FTS5 index instead of fetching and scoring every chunk of the repository on each query. Results are ranked by BM25 with prefix matching, latency no longer grows with repository size, and existing indexes migrate automatically the first time each repository is searched (no reindex needed). The old behavior remains available via
CODE_LEXICAL_BACKEND=scan. (#121)
- Indexed commits now carry a numeric timestamp, enabling time-window filtering of git-history search (the previous string-only date field could not be range-filtered). Each repository's history picks this up on its next index. (#122)
Added
- A vector-store benchmark suite (
npm run bench:history and companions) that measures indexing throughput, filtered-query latency, and memory at git-history scale, used to evaluate ChromaDB against candidate successor stores on real corpora. Developer tooling; no runtime impact. (#122, #123, #124)
2026-07-23, v1.5.1: Dependency security updates and clearer docs
Fixed
- Vector collections now declare cosine distance explicitly instead of inheriting ChromaDB's L2 default. Search results are unchanged (embeddings are unit-normalized, so both metrics rank identically), and existing indexes keep working without a reindex; the setting takes effect for newly created collections. (#116)
- Dependency updates clear all
npm audit findings in the backend and dashboard, including high-severity advisories in js-yaml, fast-uri, body-parser, adm-zip, and sharp. The adm-zip and sharp fixes are applied through npm overrides until @huggingface/transformers updates its own pins. (#117, #114, #119, #113)
Changed
- The README and all documentation were rewritten for plainer, more direct prose. Content, commands, and configuration references are unchanged; the storage-sizing figures in the implementation doc were corrected (embeddings are 768-dimensional, about 3KB each). (#118, #116)
2026-07-08, v1.5.0: Source provenance recorded at add time
Changed
- A source's type is now recorded when you add it, instead of being inferred from disk every time. When you clone a repository or add a local folder or file, SourceVault writes down what it is; the dashboard reads that record to decide whether a source belongs under Repositories or Local. Previously the type was re-derived from filesystem shape on each listing, which could not reliably tell a clone from a local folder that happened to contain a
.git (from your own git init). Classification is now authoritative and no longer depends on git state, so a source can't change sections as its git state changes. Existing sources are migrated automatically the first time they're listed, and a folder placed directly under the sources directory out of band is still recognised and recorded. No action needed. (#108)
2026-07-08, v1.4.2: Local sources index and classify correctly
Fixed
- "Sync & reindex" no longer fails on a dirty or upstream-less git source. The git pull that fetches the latest before reindexing was mandatory, so a dirty working tree, a diverged branch, an offline host, or a repo with no tracking upstream (any local
git init folder) failed the whole job and nothing was indexed. The pull is now best-effort: if it can't fast-forward, SourceVault logs a note and indexes the current on-disk working tree instead. Plain "Reindex" was never affected. (#107)
- A local folder that is a git repo is now filed under Local instead of Repositories. Classification checked for a
.git before anything else, so a local folder you added in place and had run git init in was mislabeled as a cloned repository. It's now identified by how SourceVault stores it (a local source is symlinked in place; a clone is a real directory), so it lands in the Local section while still showing its branch and commit. (#107)
2026-07-08, v1.4.1: Dashboard health fix for uncommitted local sources
Fixed
- A local folder that is a git repo with no commits yet no longer breaks the dashboard. Adding such a folder (a freshly
git init'd directory with an unborn HEAD) made the repositories listing fail with a 500, which flashed the sidebar's system-health tag red with no explanation. The listing now tolerates an uncommitted git source, showing it with no commit, and a single malformed source can no longer take down the whole list. Indexing was never affected: local folders and files are indexed from disk and never required git or a commit. (#105)
2026-07-08, v1.4.0: Local folders and files
Added
- Index local folders and files, not just cloned repos. Point SourceVault at any folder or file already on your machine and it's indexed in place through a link, so a reindex always reflects the live contents and removing it here never touches your originals. Add them from the sidebar's new Local section or the Repositories view; a native file/folder picker (macOS, Windows, Linux) fills in the path so you don't have to type it. Git clones and local sources sit in separate sidebar sections so the two don't collide. (#103)
Changed
- Plan limits are now measured in sources. A git repository and a local folder each use one slot of your plan's cap, while all loose individual files you add share a single pooled slot, so adding a handful of reference files never burns a repository each. The dashboard's plan meter and the limit message now read "sources" to match. (#103)
Upgrade notes
- Local folders now count toward your plan's source cap: a folder uses one slot, the same as a repository, and loose files added individually share a single pooled slot. Your existing indexed repositories are unaffected; if you add a local source while already at your cap, the dashboard asks you to remove a source or upgrade rather than failing silently.
2026-07-07, v1.3.5: Version at a glance
Added
- The sidebar shows what you're running. A muted version number sits beside the Support and Discord links in the sidebar footer, reporting the server's actual version; after a self-applying upgrade you can watch it tick over. Settings → About keeps the fuller details. (#96)
2026-07-07, v1.3.4: Upgrades apply themselves
Fixed
- Upgrading no longer takes repeated reloads to get the new interface. The dashboard now refreshes itself exactly once when a new version's service worker takes over, so
brew upgrade → open dashboard → current interface, with zero manual reloads. Tabs that were already open when the server upgraded show a "SourceVault was updated — Reload now" banner within a minute instead of silently running the old interface. (#94)
Upgrade notes
- One last time: this upgrade is installed *under* the previous service worker, so the first load may still show the old interface; reload once. Every upgrade after this one applies itself.
2026-07-07, v1.3.3: The dashboard becomes a workspace
Changed
- A new sidebar layout puts asking first. Navigation (Ask, Watches, Runbook, History, Archive) lives in a collapsible left sidebar with an always-visible repository list (status dots show ready/stale/indexing at a glance) and the model, service health, and settings tucked into its footer. The Ask composer is now the first thing you see, centered at reading width, with example prompts when you're starting fresh. Repositories are a full view of their own (with add, reindex-stale, and live indexing progress in the header) instead of a collapsed table at the bottom of the page. On phones the sidebar becomes a slide-out menu. Everything you had is still here: the four status cards' jobs moved into the sidebar and the Repositories view; nothing was removed. (#92)
Fixed
- The trial-expired notice linked a retired domain, and the renew-updates notice linked a pricing anchor that no longer exists; both land on the right pages now. (#92)
- Icon-only controls in the new sidebar carry proper accessible names for screen readers, and the service-health indicator respects reduced-motion preferences.
Upgrade notes
- The dashboard is an installable app (PWA), so your browser may show the previous layout on first load after upgrading; reload once or twice and the new interface activates.
2026-07-07, v1.3.2: Support surfaces, in the product
Added
- Help is one click from the dashboard. The dashboard footer now links the support surfaces: the Discord community, the support routing page, and the public issue tracker. (#85)
- Discord support server, as code. The community server's structure ships as reviewable config with a staff runbook (docs/DISCORD_SUPPORT.md), self-serve license-recovery pointers across the support surfaces, and corrected secrets guidance:
npm run doctor output is safe to share as-is; .env files, settings.json, compose/systemd configs, and logs are what need redaction. (#82–#84, #88)
Changed
- Settings now reflects plan gating accurately. The Audit log row is gated to the Team plan with compliance add-on pointers where they apply, and enterprise keys are clarified as always including Multi-repo Ask. (#86)
- Docs. DASHBOARD.md now describes the always-on auth model shipped in v1.3.0: the bearer token is required on every dashboard route, loopback included, with no tokenless mode.
2026-07-07, v1.3.1: Self-serve Starter → Pro upgrade
Added
- Upgrade to Pro, right from Settings. A Starter install now shows "Upgrade to Pro — pay only the difference" on the locked Multi-repo Ask setting, linking the self-serve upgrade page. The upgrade costs the list-price difference, and the new Pro key arrives by email with a fresh 12-month updates window; paste it over the old key and Multi-repo Ask unlocks immediately. The fulfillment contract gains
license_kind=upgrade (fulfill-stripe.js, LICENSING.md), and the billing policy is now self-serve-first with the manual runbook as the backup path. (#80)
Fixed
- License activation updates plan limits immediately. Activating a key refreshed the license state but left the repository cap (and updates window) showing trial-era values until the dashboard was reloaded or locked and unlocked. Enforcement was never affected: the server always honored the new plan; the display now does too. (#79)
2026-07-06, v1.3.0: Sentinel, enforced dashboard auth, async task relay
Added
- SourceVault Sentinel: a local enforcement layer between the code index and anything that reads from it. An access policy gate decides which files may be read at all; a gitleaks-style DLP pass redacts secret material from everything that leaves the engine; every enforcement lands in a tamper-evident, hash-chained decision log. Ships with dashboard toggles and documentation. (#55)
- AI-change provenance. Commits are classified for AI authorship and security relevance (path rules plus a diff-content pass, full-body trailer scan, and revert handling), with signed in-toto attestations, a drift correlator that ties index drift back to the commits that caused it, and dashboard/MCP surfaces. (#59, #71)
- Audit chain anchoring. The decision log now carries a signed monthly head anchor, detects tail-truncation and file deletion (not just edits), and fails closed on lock timeout instead of falling back to an unlocked write. (#63)
- Retrieval regression gate. A retrieval-only benchmark with recorded embedding fixtures (deterministic, no model needed), Wilson confidence intervals and paired McNemar A/B stats, multi-repo question sets, and a nightly CI gate armed with a committed baseline. (#50–#54, #68)
- Stripe fulfillment. Checkout-to-license fulfillment scripts with payment-link auditing, a documented billing policy, and unit tests over the whole money path. (#42, #45, #60)
Security
- Dashboard auth is now enforced by default; there is no tokenless mode. Boot provisions
DASHBOARD_TOKEN when nothing supplies one (persisted to ~/.config/sourcevault/dashboard_token, 0600, value never logged) and every fail-open branch is removed; a truly tokenless boot fails closed with 503 dashboard_locked, loopback included. Previously any local process could drive the mutating control plane on a tokenless install. (#74)
- DLP scanning gaps closed on the signed search API. Search previews are now scanned against the full chunk content (a trimmed preview window could cut the assignment prefix a rule needs), same-file chunks are stitched before scanning so secrets straddling chunk boundaries redact in both halves, and modern OpenAI key formats (
sk-proj-/sk-svcacct-) are detected without the legacy infix. (#61)
- Full-project review remediations and ops hardening. Fail-closed Sentinel enforcement paths, safer audit locking, pinned chroma/ollama images (tag+digest), Bitbucket webhook dedupe via pushed head commit, and documented loopback trade-offs. (#62, #69)
Fixed
POST /task answers its 202 immediately instead of blocking up to two upstream timeouts (~120s) while clients gave up and retried; POST /result is idempotent, so a deployment where OpenClaw also calls back no longer double-delivers to Hermes. (#70)
- Token rotation reaches every config source. Rotation now persists to the compose env file (
~/.config/sourcevault/server.env) and the brew launchd env file (via SOURCEVAULT_ENV_FILE, exported by the updated formula wrapper); previously a Settings-page rotation on those installs silently reverted on the next service restart. Boot warns on credential-file drift. (#75, #76)
- Dashboard file reads honor the requested cap. Full-file reads were silently clamped to 50KB; the dashboard's trusted cap now applies and byte counts are accurate. Drawer ask-conversations are session-scoped. (#72)
- Pre-push hook survives linked worktrees. Hook-exported
GIT_DIR no longer redirects temp-repo test git commands at the project repo (which could re-init it bare). (#64–#65, #67)
- Chunk-dedup accounting.
reusedChunks no longer overcounts; verified end-to-end against a real indexer run. (#50)
Changed
- The live compose env file moved out of the repo tree to
~/.config/sourcevault/server.env (override with SOURCEVAULT_ENV_FILE); the old in-tree path stays git-ignored and blocked by the pre-commit hook. (#66)
- Docs. The task relay is documented as experimental with its own guide; the parked roadmap, billing policy, and Starter → Pro upgrade path are written down. (#73, #43, #47)
- Supply chain. actions/checkout v7, Node 24 CI actions, Dependabot backend bumps. (#35, #38–#39)
Upgrade notes
- Dashboard login is now always required. Installs with
DASHBOARD_TOKEN already configured see no change. Tokenless installs get a token auto-provisioned at first boot — read it with cat ~/.config/sourcevault/dashboard_token and paste it at the unlock screen; the browser session keeps logins infrequent (DASHBOARD_SESSION_MAX_AGE_SEC, default 12h).
- Compose deployments: move the env file out of the repo tree to
~/.config/sourcevault/server.env before the next docker compose up; compose fails loudly until then (see DEPLOY_SERVER.md).
- Homebrew installs: this upgrade also refreshes the service wrapper so in-app token rotation persists to the launchd env file; restart the service (
brew services restart sourcevault) after upgrading.
2026-07-03, v1.2.0: production hardening — sanitized errors, rate-limited machine API, Vite 8, non-root Docker
Security
- Server errors no longer leak internals. 5xx responses previously echoed raw error messages (which can carry absolute filesystem paths and upstream response bodies); they now answer a generic detail while the specifics are logged server-side. A global error handler also replaces the HTML stack trace Express emits outside
NODE_ENV=production, closing the leak for bare npm start runs. (#32)
- The signed machine API and task relay are rate-limited.
/api/search-codebase + /api/read-file (default 300/min, SOURCEVAULT_MACHINE_API_RATE_LIMIT_*) and /task + /result (60/5min, SOURCEVAULT_RELAY_RATE_LIMIT_*), mounted ahead of signature checks so brute-forcing is throttled too. Previously only dashboard and webhook routes had limits. (#32)
- Crash guards.
uncaughtException exits cleanly for service-manager respawn; unhandledRejection logs and continues, so a background relay or index-resume failure can't take the server down. (#32)
- Hardened surfaces. Swagger UI (
/api-docs) gets its own CSP; cross-origin-opener-policy/cross-origin-resource-policy join the baseline headers; boot warns when a secret still holds a template placeholder value. (#32)
- Secure installation. The Docker image runs as the unprivileged
node user with a digest-pinned base; compose binds 127.0.0.1:9000 by default; CI actions are pinned to commit SHAs and Semgrep to a version; the Linux installer no longer pipes remote scripts straight into a root shell (download → printed sha256 → confirm → execute). (#32)
Fixed
OLLAMA_HOST now actually reaches ask/embed calls. The Ollama client was configured via an instance field the library ignores, so non-default hosts silently fell back to 127.0.0.1:11434. The client is now constructed with the configured host. (#32)
Changed
- Dependencies current, zero audit findings. Dashboard build moves to Vite 8 (Rolldown) with
@vitejs/plugin-react 6; ollama 0.6. Both package trees now npm audit clean. (#32)
- ESLint gates both trees. Flat configs for the backend and dashboard run in CI and the pre-push hook; the Zustand store is typed end-to-end (
set/get checked against the real store shape); duplicated fetch/ poller/error-factory code consolidated into shared helpers. (#32)
- Docs. README now answers "when is Docker required?" per install path (macOS: never; Linux installer: ChromaDB container only; server: Compose). (#33) License signing-key generation/rotation is documented with a
scripts/ops/license-keygen.js helper. (#32)
Upgrade notes
- Docker Compose deployments only: the container now runs as the
node user, so named volumes created by an older (root) image need a one-time ownership fix before the new image starts: docker compose run --rm --user root sourcevault chown -R node:node /data, then docker compose up -d. Fresh deployments and all native (macOS/Linux installer) installs are unaffected. See DEPLOY_SERVER.md "Updating".
- The task relay's
OPENCLAW_API_KEY and HERMES_WEBHOOK_SECRET are now documented in .env.example; set them only if you use the Hermes ↔ OpenClaw broker routes.
2026-07-02, v1.1.6: sourcevault app Dock launcher
Added
sourcevault app [url] [--out <dir>] builds a SourceVault.app Dock launcher in ~/Applications that opens the dashboard in the default browser: the packaged equivalent of npm run dashboard:app, for Homebrew installs that don't have npm scripts. The embedded URL honors the install's configured HOST/PORT. (#27)
sourcevault --help prints CLI usage. (#27)
2026-07-02, v1.1.5: install the dashboard as an app + self-healing upgrades
Added
- The dashboard installs as a desktop app. Served from
http://localhost:9000/dashboard/ (a secure context, so no "Not Secure" label), the dashboard's PWA lights up native install: Chrome/Edge show the address-bar install icon and a new Settings → About → "Install app" button; Safari installs via File → Add to Dock. Installed, it runs in its own window with a Dock icon and no browser chrome. (#24)
- Browsers landing on
/ go to the app. localhost:9000 and the dashboard.sourcevault.ai alias now redirect HTML clients to the dashboard; scripts and monitors requesting JSON keep the health payload. (#24)
Fixed
- Upgrades no longer strand a running service on deleted files. Package upgrades remove the old install directory while the service keeps running from it (symptom: dashboard 500s on a missing
index.html). The server now watches its own install path and exits for respawn when it vanishes; launchd (keep_alive) and systemd (Restart=on-failure) bring up the new version automatically. The Homebrew formula also restarts the service at upgrade time. (#23, homebrew-tap#1)
Changed
- The advertised dashboard URL is
http://localhost:9000/dashboard/ (secure context, installable) instead of the branded host, which browsers flag as "Not Secure" on plain HTTP. dashboard.sourcevault.ai remains a typeable alias that redirects into the app. (#24)
2026-07-02, v1.1.4: branded dashboard URL
Added
- The dashboard has a branded URL:
http://dashboard.sourcevault.ai:9000/dashboard. The name carries public A/AAAA records pointing at loopback, so it reaches the local install on every machine with zero setup. The server advertises it (startup dashboard_available log, macOS launcher) only after verifying it resolves to loopback locally; offline machines, DNS-rebinding-protected routers, and non-loopback HOST binds fall back to the bound address automatically. (#21)
npm run dashboard:app builds a Dock-able macOS launcher that opens the dashboard in the default browser.
Fixed
- The launcher opens
/dashboard (the SPA) instead of the server root (health JSON). (#21)
2026-07-02, v1.1.3: enforce the advertised trial repo cap
Fixed
- Trial installs are now capped at 1 repository, as advertised. The install caveats and site have always said "7-day trial with one indexed repository", but the cap was wired to an env var no installer set, so an unlicensed trial could index unlimited repos.
getRepoLimit() now defaults unlicensed installs to 1 (licensed keys without max_repos, i.e. enterprise, remain unlimited; SOURCEVAULT_DEFAULT_MAX_REPOS still overrides).
2026-07-02, v1.1.2: version everywhere support needs it
Added
sourcevault --version (and -v) prints the version (plus the release date on release builds) without booting the server.
/health includes version, so "what version are you running?" is one curl away on any install.
- Dashboard Settings shows an About row with the server version.
2026-07-02, Auto-release on version bump + browser smoke tests
Pipeline
- Merging a version bump now IS the release. The release workflow also runs on pushes to
main: when package.json's version has no tag yet, it builds, publishes to the tap, bumps the formula, and pushes the vX.Y.Z tag itself (tag-last, so a failed build leaves nothing behind and simply retries). Merges that don't bump the version no-op. Manual tag pushes still work and remain the path for --suffixed prerelease tags, which never repoint the customer formula.
- Real-browser E2E smoke in CI. A Playwright job boots the server with auth enabled, logs into the dashboard through the actual UI in Chromium, and asserts a mutating request passes the CSRF double-submit check while a raw header-less request is still refused. This is the test tier the v1.1.1 CSRF-cookie-path bug slipped past: unit tests attach cookies and headers manually, so only a real browser sees cookie-path visibility. Verified to fail against the v1.1.0 code and pass against the fix.
2026-07-02, v1.1.1: fix dashboard CSRF cookie path
Fixed
- Mutating dashboard requests 403'd in the browser (
csrf_token_mismatch) whenever DASHBOARD_TOKEN was set (e.g. saving an SCM token, adding a repo). The CSRF cookie was scoped to Path=/api/dashboard, but document.cookie only exposes cookies whose path matches the page's own path, and the SPA is served from /dashboard/, so the client could never read the token to echo it as the x-csrf-token header. The cookie is now Path=/ (double-submit security lives in the token value; the cookie is JS-readable by design). The HttpOnly session cookie stays scoped to /api/dashboard. Server-level tests attached cookie + header manually, which is why this only surfaced in a real browser; a regression test now pins the cookie path.
2026-07-02, 7-day trial for unlicensed installs
Licensing
- Perpetual licenses with a 12-month updates window. Self-serve keys now carry
updates_until: the license works forever on every build released inside its window, and newer builds require a discounted renewal; the installed version never stops working. Enforcement is fully offline (release tarballs embed their release date; dev/git/Docker builds don't enforce). Customers whose window ended see renewal guidance and a dedicated dashboard banner, never trial messaging. Keys without the field (existing/enterprise, --updates-forever) cover updates forever.
- Trial period. Unlicensed installs now run a 7-day trial of the core product (search, read, ask, repo onboarding); paid upgrade features stay locked throughout the trial. After expiry the core surfaces return
403 trial_expired on every product surface (dashboard, signed API, MCP, Hermes) until a license key is entered. The clock starts on first use (trial.json in the state dir); window length is SOURCEVAULT_TRIAL_DAYS (default 7); any valid license bypasses the trial. The dashboard shows a days-remaining banner during the trial and a license prompt after expiry, and stays reachable so the key can always be entered.
2026-07-02, One-command macOS install via Homebrew
Platform
brew install sourcevault-ai/tap/sourcevault. macOS installs are now a single Homebrew command via the new public tap (sourcevault-ai/homebrew-tap): it pulls Node 24 (pinned node@24), Ollama (homebrew-core), and ChromaDB (companion formula in the tap, private Python virtualenv), generates config + secrets to $(brew --prefix)/etc/sourcevault/sourcevault.env once (0600, survives upgrades), and registers a brew services launchd service; no more hand-rolled LaunchAgents on the brew path. scripts/setup/install.sh remains the Linux/WSL2 path and a macOS alternative (still the way to get per-repo scheduled reindex agents).
- CLI entry point. New
bin/sourcevault (package.json bin field) so package managers expose a sourcevault executable; sourcevault.js's main block is now an exported main().
Release engineering
- Versioned releases for Homebrew. New
.github/workflows/release.yml: pushing a v* tag builds the dashboard and publishes a GitHub Release with sourcevault-vX.Y.Z.tar.gz (source + prebuilt dashboard/dist) and its sha256; that tarball is what the formula consumes (scripts/release/package-brew-tarball.sh).
- Fully one-command releases. The release workflow also bumps the formula's
url/sha256 in the tap automatically, so shipping is just: bump package.json version on main, git tag vX.Y.Z && git push origin vX.Y.Z. Prerelease tags (any version containing -) publish an asset but skip the formula bump, so customers are never repointed at a test build.
- Release-gate fix. The customer-bundle forbidden-path gate was silently disabled on Linux/CI:
tar | grep -q under set -o pipefail turned a MATCH into a pipeline failure via SIGPIPE. The listing is now read once and files are matched exactly, so .env can no longer false-positive on the intentionally shipped .env.example either.
- Hardcoded
/home/larry fallback paths replaced with home-relative equivalents.
2026-07-02, Security hardening, observability, and deploy polish
Security
- Rate limiting on the control plane and webhook. Dashboard login (10/5min), ask/ask-source (20/5min), reindex (5/10min), and the git webhook (30/5min) are now rate-limited via
express-rate-limit with per-route, env-overridable thresholds (*_RATE_LIMIT_MAX / *_RATE_LIMIT_WINDOW_MS), standard draft-6 RateLimit-* headers, and a Retry-After on 429s. New SOURCEVAULT_TRUST_PROXY (hop count) makes req.ip the real client behind a reverse proxy so limits apply per client instead of one shared bucket.
- CSRF double-submit token for the dashboard. Defense-in-depth on top of the
SameSite=Strict session cookie: login issues a non-HttpOnly sourcevault_dashboard_csrf cookie the SPA echoes back as x-csrf-token on mutating requests; the server compares them with a timing-safe check. Applies only to cookie-authenticated requests: bearer-token clients (scripts, plugins) are unaffected.
- Webhook replay dedup. Provider retries (GitHub redeliveries, GitLab retries) no longer trigger duplicate reindex jobs: delivery IDs (
X-GitHub-Delivery, webhook-id/Idempotency-Key, X-Gitlab-Event-UUID) are tracked in a bounded cache and repeats get 200 {ignored: true}.
- Search-query length bound (
CODE_SEARCH_QUERY_MAX_CHARS, default 2000) so a pathological query can't drive unbounded embedding cost, plus shared input-validation helpers (services/util/validate.js).
- Baseline security headers app-wide (
nosniff, X-Frame-Options: DENY, referrer-policy), X-Powered-By disabled, and the shared HMAC verification extracted into one middleware (services/security/hmac-guard.js) instead of four per-route copies.
- Container hardening.
sourcevault/chroma get CPU/memory/pids limits in compose.yaml so a runaway index job can't OOM the host, and the optional with-ollama profile binds 11434 to loopback only (Ollama's API is unauthenticated; never expose it directly).
Observability
- Structured logging via a dependency-free logger (
services/util/logger.js): readable text by default, one-line JSON with SOURCEVAULT_LOG_FORMAT=json for aggregation. Every 5xx now logs with stack context, and previously swallowed errors in the ask pipeline (phase callbacks, thread resolution, symbol-graph enrichment, follow-up rewrites) are logged instead of silently discarded.
- Auth events in the audit log. Failed logins, successful logins, HMAC signature failures (per endpoint), webhook auth failures, and rejected settings/license changes are now audited alongside the existing events, via a shared
recordAuthFailure helper that feeds both the audit log and the structured logs.
- Startup dependency probe. After the server starts listening it probes ChromaDB and Ollama in the background (with backoff) and warns if either is unreachable — observability only, never blocks or fails boot, since the
with-ollama quickstart intentionally pulls models after up -d. Opt out with SOURCEVAULT_SKIP_STARTUP_PROBE=1.
Deployment & PWA
- Offline fallback page (
offline.html, theme-aware) precached by the service worker: navigations outside the SPA shell fallback get a branded offline page instead of the browser error screen (the cached app shell continues to serve normal dashboard navigation offline, as before).
- Expanded
docs/DEPLOY_SERVER.md: nginx and Traefik reverse-proxy examples alongside Caddy, an explicit X-Forwarded-Proto requirement (the session cookie's Secure flag depends on it), a CSP-behind-proxy note, and the SOURCEVAULT_TRUST_PROXY guidance above.
- Config constants centralized: read-file byte cap, search result cap, preview length, and prior-answer replay length moved into
CODE_MEMORY_CONFIG as env-overridable values.
2026-06-20, Plan limits + macOS support
Platform
- macOS (launchd) is now a supported install target.
scripts/setup/install.sh auto-detects the platform: systemd on Linux/WSL2, launchd on macOS (Homebrew for Node/Ollama, native chroma run instead of Docker, dashboard-only). See docs/INSTALL_PLAYBOOK.md. Native Windows remains unsupported (use WSL2 or the Docker Compose deploy).
Licensing
- Per-plan repository cap. (#3, #4) Licenses can carry a signed
max_repos limit; cloneCodeRepo rejects adds past the cap with repo_limit_reached (403). Resolution: license limits.max_repos → SOURCEVAULT_DEFAULT_MAX_REPOS → unlimited. Settings shows "X / N repos used".
2026-06-19, Docker Compose deployment + installable PWA dashboard
Deployment
- Docker Compose server deployment. (#72) A team can now run one SourceVault stack and connect from Windows/macOS/Linux/WSL2 via the browser, instead of replicating the heavy Ollama + ChromaDB + Node stack on every laptop. Adds a multi-stage
Dockerfile (Node 24; builds the dashboard, prunes dev deps, fetch-based HEALTHCHECK) and compose.yaml (sourcevault + chroma, with an optional ollama profile for all-in-one demo boxes). Chroma is network-internal with a bash /dev/tcp healthcheck; OLLAMA_HOST points at a shared GPU/host box (host.docker.internal works on Docker Desktop/Colima and, via the host-gateway mapping, on Linux). State, repos, and vectors persist on named volumes. New deploy/server/sourcevault.env.example (real env git-ignored) and docs/DEPLOY_SERVER.md covering prerequisites (incl. macOS/Colima), quickstart, reverse-proxy/TLS, backups, and troubleshooting. Verified end-to-end: /health?deep=1 reports chroma + ollama reachable, and /api/dashboard/* fails closed (401, not 503) once the three secrets are set.
Dashboard
- Installable PWA. (#72) The dashboard is now a Progressive Web App via
vite-plugin-pwa: "Install" gives it an app icon and a standalone window on Windows/macOS/Linux with no per-OS packaging or code-signing. The manifest is scoped to /dashboard/ with a maskable icon set, and the service worker precaches only the app shell and excludes /api/* so the cookie-authed, dynamic API responses are never served stale. Installability needs a secure context — localhost for local testing, otherwise HTTPS via the reverse proxy.
2026-06-19, Webhook-driven reindexing and chunk-level dedup
Indexing
- Git-webhook trigger: push to reindex. (#68) A push to an indexed repo's branch now runs a sync + incremental reindex automatically, via
POST /api/webhooks/git, the same background job as the dashboard's "sync and reindex". Authenticated solely by SOURCEVAULT_WEBHOOK_SECRET (not the dashboard token) across GitHub HMAC (X-Hub-Signature-256), GitLab (X-Gitlab-Token), and a generic X-SourceVault-Token; it fails closed: 503 when the secret is unset, 401 on a bad/missing signature. Pings, tag pushes, and non-indexed-branch pushes are acknowledged and ignored; an unknown repo returns 404. See the README "Git webhooks" section to configure it.
- Chunk-level content-hash dedup: re-embed only what changed. (#69) File-level incremental indexing already skipped unchanged files, but a changed file re-embedded all of its chunks. Each chunk now carries an
embedHash (a hash of its embed input), so an incremental reindex reuses the existing embeddings for a changed file's unchanged chunks: a small edit to a large file only re-embeds the chunks that actually changed (reported as reusedChunks). Embedding is the expensive step, so this is a direct win on edit-heavy reindexing.
2026-06-18, Ask survives a browser refresh
Dashboard
- Ask survives a browser refresh, with a live phase + ETA. (#55) An Ask ran synchronously inside the HTTP request, so refreshing the browser aborted the fetch and dropped the in-flight answer. Ask now runs as a background job — the same pattern indexing got in #35 / #38:
POST /api/dashboard/ask returns 202 + a job handle, the dashboard polls to completion, and on reload it re-attaches to the still-running job by id. While it runs, a banner shows the phase (retrieving → generating → finalizing) and a rough ETA estimated from the median duration of recent asks for that repo/model. Note: POST /api/dashboard/ask now always returns 202 and surfaces input errors asynchronously via the job (status:"error") instead of a synchronous 400.
2026-06-18, Indexing at scale, retrieval quality, and live progress
A focused push to make large-repo indexing reliable and fast, surface what indexing is doing in the dashboard, and close a retrieval-recall bug. Shipped across PRs #35–#48 (roadmap tracked in issue #44).
Retrieval quality
- Literal-plan recall fix: benchmark file-find 0.600 → 0.833. (#48) A natural-language question that merely *named* a method (e.g. "how does
res.sendFile send a file?") was hijacked into a literal-only search that returned test files / call sites and skipped semantic recall of the file that actually defines the symbol. Now only pure file-listing intent (extensionOnly) short-circuits; everything else folds literal hits into the hybrid RRF fusion. Search-only retrieval went hit@5 0.333 → 0.833, recall@50 0.467 → 0.967, MRR 0.284 → 0.633.
- Opt-in TEI embedding backend + Matryoshka dimension truncation. (#46)
CODE_EMBED_URL routes embeddings through a Hugging Face Text Embeddings Inference server; CODE_EMBED_DIMS truncates and re-normalizes vectors. Off by default; throws on failure so it never silently mixes vector spaces.
- Opt-in TEI reranker backend + RAG roadmap. (#43)
CODE_RERANKER_URL swaps the local ONNX cross-encoder for a TEI /rerank server. Off by default. Added docs/RAG_ROADMAP.md.
- TEI
/rerank truncation fix. (#45) Requests now send truncate: true; code chunks were 413-ing without it.
- Reranker A/B recorded. (#47)
bge-reranker-base and 8192-ctx bge-reranker-v2-m3 were both A/B'd via TEI and both lost; the local ms-marco-MiniLM cross-encoder stays the default.
Indexing reliability & performance
- Background index jobs: large repos no longer time out. (#35) Reindexing runs as a fire-and-forget job instead of synchronously inside the HTTP request (which SIGTERM'd at the 5-minute mark). Reindex routes return
202 + a job handle.
- Chunk sanitization + per-file resilience. (#40)
sanitizeForChroma() strips lone UTF-16 surrogates that ChromaDB's strict Rust JSON parser rejects (the real reason a 14k-file C++ repo aborted at ~83%), and a per-file try/catch lets one bad file skip instead of failing the whole run.
- Concurrent embed/upsert pool (~2×). (#41) A bounded pool (
CODE_INDEX_CONCURRENCY, default 4) parallelizes embedding/upsert. Measured on a full index: 27m50s → 14m15s, identical output.
- Vendored/build-dir filtering +
.sourcevaultignore. (#42) Expanded default ignoreDirs plus a per-repo .sourcevaultignore (gitignore-subset). On vendored-heavy repos this cuts ~90% of files (14k → ~2k), the single biggest indexing-time win.
Dashboard
- Richer index status + ETA. (#39) Replaces the bare spinner with scanning/progress/percentage and an estimated time remaining, driven by a file count.
- Resume index progress after reload. (#38) The dashboard re-attaches to a running index job after a page refresh.
- Per-repo index spinners. (#37) Concurrent indexes no longer steal each other's spinner; progress is tracked per repo.
- Restore vault-mark logo in the topbar. (#36)