Back to blog
2026-04-20 Thijs Creemers

Release: v1.0.1-alpha-13

We just tagged v1.0.1-alpha-13. The headline is DX Vision — a six-phase developer experience overhaul landing in a single release. Alongside that: a cache bug fix, security hardening, and a broad dependency refresh.

DX Vision: boundary-devtools

The new boundary-devtools library gives you x-ray vision into a running Boundary application. Loaded via the :dev and :repl-clj aliases, it adds zero overhead to production builds. It ships as six phases:

Phase 1 — Zero-Friction Onboarding

Structured error codes (BND-*) with human-readable messages. Six new ADRs (024 through 029) guide the guidance engine, REPL command center, dev dashboard, error experience, and progressive learning path.

Phase 2 — REPL Power

Introspection tools for route tables, config trees (secrets redacted), module state, and schema exploration. A unified REPL namespace (boundary.devtools.shell.repl) ties everything together:

(routes)              ;; route table
(config)              ;; config tree (secrets redacted)
(modules)             ;; module summary
(schema-tree :user/CreateUser)
(schema-example :user/CreateUser)

Phase 3 — Error Experience

A layered error pipeline: classify → enrich → format → output. The classifier maps exceptions to BND-xxx codes, the enricher adds stacktrace context and fix suggestions, and the formatter produces rich output. Auto-fix applies safe fixes automatically and prompts for risky ones:

(fix!)      ;; fix the last error
(fix! ex)   ;; fix a specific exception

An FC/IS violation checker catches architecture boundary crossings at dev time.

Phase 4 — Dev Dashboard

A browser-based dashboard at localhost:9999 with ten pages: system overview, routes, requests (live HTMX polling), schemas (with example generation), database explorer, errors with fix suggestions, jobs queue, config editor, security posture, and in-app documentation.

Phase 5 — Advanced REPL

Request/response recording for debugging and replay. Route testing lets you add or remove routes on a running system without restart. Rapid prototyping converts Malli schemas to scaffold specs.

Phase 6 — Dashboard Extensions + AI

Config editor with live editing and diff preview. Security analyzer and status page. Jobs dashboard. Three AI-powered REPL commands (require an AI provider):

(ai/review "path/to/file.clj")       ;; code review
(ai/test-ideas "path/to/file.clj")   ;; suggest missing tests
(ai/refactor-fcis 'boundary.product.core.validation)  ;; FC/IS guidance

AI REPL integration

boundary-ai gained three new REPL functions for Phase 6: explain-code, suggest-refactor, and generate-docs in boundary.ai.shell.repl, plus new prompt builders in boundary.ai.core.prompts.

Bug fixes

LRU cache eviction (#137)

When multiple cache entries shared the same timestamp (fast successive writes), sort-by fell back to map iteration order and could evict the just-added entry instead of the least-recently-used one. Fixed by evicting the LRU entry before inserting the new one.

Tools: deprecated wrapper scanner (BOU-15)

The deprecated-usage scanner now detects :refer’d symbols and fully-qualified deprecated calls. Previously, `(:require […​ :refer [build-document]]) and (boundary.search.core.index/build-document …​) call sites were silently missed.

Security

Migrated to the Alpine.js CSP-compatible build. All inline scripts moved to external .js files for Content Security Policy compliance. CI pipeline hardened with stricter security checks.

Chore

boundary-tools moved from the top-level directory into libs/tools/ to follow monorepo convention. The e2e CI job is disabled (if: false) to reduce pipeline run time — tests can still be run manually.

Dependency updates

All 22 publishable libraries bumped from alpha-12 to alpha-13. Key version bumps:

  • logback-classic 1.5.23 → 1.5.32

  • clj-kondo 2026.01.19 → 2026.04.15

  • mysql-connector-j 9.5.0 → 9.6.0

  • ClojureScript 1.12.116 → 1.12.134

  • postgresql 42.7.8 → 42.7.10

  • sqlite-jdbc 3.51.0.0 → 3.53.0.0

  • jedis 7.1.0 → 7.3.0

  • ring-core/ring-jetty-adapter 1.15.3 → 1.15.4

  • aws-sdk s3/s3-transfer-manager 2.39.5 → 2.42.33

Documentation

112 files refreshed. Test commands corrected across 33 .adoc files (clojure -M:test → clojure -M:test:db/h2). New library documentation pages for devtools and tools. Updated stale version references.

Test suite

3044 tests, 15742 assertions, 0 failures across all libraries.

What’s next

The DX Vision tooling is in place — next up is polishing the dev dashboard, expanding the error code catalogue, and continuing toward beta. Feedback and issues welcome on GitHub.