GitHub

Change Log

[0.8.0] - 2026-07-17

Changes

  • Add sayid-menu, a transient menu that sayid-setup-package now binds to the C-c s prefix: commands grouped by workflow, with live traced/recorded state in the header (backed by a new sayid-get-log-count op). All classic key sequences keep working - the menu uses the same keys - and sayid-use-menu set to nil restores the plain prefix keymap.
  • An empty workspace tree (C-c s w) and an empty traced-functions view (C-c s s) now render a short getting-started hint instead of signaling an error.
  • The trace commands describe their outcome in plain language (what was traced and what to do next) instead of echoing the raw server reply, and enabling/disabling an untraced function now reports the actual problem. The sayid-trace-fn-at-point op reply changed accordingly (see doc/nrepl-api.md).
  • Tracing a function no longer pops up the traced-functions window; it's refreshed only when already visible.
  • g refreshes the workspace tree and traced-functions buffers.
  • sayid-reset-workspace asks for confirmation, since it irreversibly drops all traces and the whole recording.
  • Add sayid-trace-fn (C-c s t t), the just-trace-this command for newcomers - an outer trace of the function at point.
  • Rename the per-function trace commands for consistency: sayid-trace-fn-outer, sayid-trace-fn-inner and sayid-trace-fn-remove (the old sayid-outer-trace-fn, sayid-inner-trace-fn and sayid-remove-trace-fn names remain as obsolete aliases).
  • Bring the workspace tree view to feature parity with the legacy text view: c d defs a captured value to $s/*, c p pretty-prints one, and c r copies an expression reproducing the call at point.
  • sayid-query-form-at-point (C-c s f) now renders its results in the tree view, backed by the new sayid-query-form-at-point-data op, instead of the legacy text view.
  • Require CIDER 2.0.

Bugs fixed

  • Fix sayid-tree-inspect (c i in the tree view) and sayid-buf-inspect-at-point never opening the inspector: they passed an expression string to cider-inspect, an API that CIDER dropped years ago. They now go through cider-inspect-expr.
  • The inspect commands now signal a clear error when there's no value to inspect at point, instead of defing and inspecting a garbage value.

[0.7.1] - 2026-07-11

Bugs fixed

  • Fix the workspace shelf (ws-save!/ws-save-as!/ws-load!) storing a live reference instead of a snapshot: mutating the workspace after saving (e.g. clearing the log) corrupted the shelved copy, so a later load restored nothing. It now shelves a fully-dereferenced snapshot, like a recording does.
  • Fix rec-save-as! reporting id 'null' to slot 'null' - it read the recording atom instead of its value.

[0.7.0] - 2026-07-10

  • Editor support for the new data functionality: sayid-tap-trace (C-c s d t) taps the workspace to your data tool, and sayid-capture-baseline (C-c s d b) / sayid-diff-traces (C-c s d d) drive the snapshot-then-compare flow. Backed by new sayid-tap-trace, sayid-capture-baseline and sayid-diff-traces nREPL ops.
  • Add sayid.data, the programmatic data-first API: trace-data returns the recorded call tree as plain keyword-keyed Clojure data with live captured values (and timing/source), and tap-trace! tap>s it for exploring in Portal/Reveal/Morse.
  • Add sayid.golden, a golden-trace testing helper: capture a run's recorded call tree as a normalized baseline and assert future runs still match it (gold/matches-golden?), with an update mode via SAYID_GOLDEN_UPDATE. With inner tracing the baseline covers intermediate expression values too. Also gold/diff-traces, which structurally diffs two captured traces and reports exactly which calls and values changed.

[0.6.0] - 2026-07-08

  • Rebuild inner tracing on tools.analyzer.jvm (sayid.inner-ast), working off the analyzed AST instead of re-reading source and rewriting raw forms. This replaces the legacy rewriter (the sayid.inner-trace namespace is gone), fixes inner-traced try/catch swallowing exceptions, and drops the per-macro special-casing that made the old instrumenter fragile.

[0.5.0] - 2026-07-01

  • #119: Add sayid.trace/*evict-old-calls* (default false), which switches the record limit from keeping the first N top-level calls to a keep-the-last-N ring, evicting the oldest.
  • #118: Add sayid.trace/*per-fn-limit* (default unbounded), which caps how many calls of any single function are recorded, so one hot function can't crowd out the rest of the recording.
  • #117: Add sayid.trace/*sample-rate* (default 1), which records one in every N top-level calls, for tracing a hot entry point without drowning the recording. Backed by a recording-suppression flag that also fixes a latent NPE when a skipped root called an inner-traced function.
  • #116: Add sayid.trace/*max-trace-depth* (default unbounded), which caps how deep the call nesting is recorded, so one deeply recursive call can't explode into an unbounded subtree.
  • #115: Serialize captured values in the data ops under bounded *print-length*/*print-level*, so a fat or infinite value can't hang the serializer or produce a runaway payload.
  • #114: Cap the recording at sayid.trace/*record-limit* top-level calls (default 50k), so tracing a namespace under a test suite can't grow the workspace without bound. Calls past the cap run untraced and Sayid warns once.
  • #113: Bring back trace management in the traced-functions view (sayid-show-traced): e/d/r enable, disable and remove the trace at point, i/o switch a function to an inner or outer trace.

[0.4.0] - 2026-07-01

  • #110: Render sayid-show-traced as a namespaces to functions tree (cider-tree-view), and add a sayid-show-traced-data op returning the traced audit as data.
  • #108: Fix the data ops misreporting inner-trace nodes: successful inner calls no longer come back as empty throws, and each node now exposes its recorded form.
  • #105: Add sayid-tree-view-workspace, a client-rendered, foldable view of the recorded call tree built on CIDER's cider-tree-view and the new data ops. Fold and navigate the tree, jump to a call's source, inspect any captured value (return, throw, or a named argument) in CIDER's inspector, and focus by function or call id. It's the default workspace view (C-c s w); the old text-rendered view stays available via M-x sayid-get-workspace. Bumps the minimum CIDER to 1.23.
  • #103: Drop the com.billpiel domain prefix from all namespaces (com.billpiel.sayid.* -> sayid.*), including the injected middleware var (now sayid.nrepl-middleware/wrap-sayid). Breaking for code that requires the old namespaces directly; the bundled plugin and Emacs client are updated in lockstep. The Maven coordinates are unchanged.
  • #101: Add data variants of the query ops (sayid-query-data, sayid-query-by-id-data, sayid-query-by-fn-data) that return matched calls as data instead of rendered text.
  • #100: Add the sayid-get-workspace-data nREPL op, which returns the recorded call tree as data (see doc/nrepl-api.md) for editor-agnostic clients.

[0.3.0] - 2026-06-29

  • #92: Stop freezing Emacs during the ! reload workflow; the re-enable/clear now runs on the reload's completion callback instead of fixed sleep-for delays.
  • #91: Collapse the query-*-with-modifier commands into prefix-aware f/i in the sayid buffer (use a prefix arg to prompt for a modifier; the F/I keys are gone), and bind r to refresh the view.
  • #91: Generate the in-Emacs help buffers from the keymaps so they can't drift, and base the output buffers on special-mode.
  • #86: Fix a state leak in the traced-buffer outer-trace command, a crash when navigating to a numeric trace id, and a couple of messages that broke on a literal % in a path.

[0.2.0] - 2026-06-29

  • Publish under the mx.cider/sayid coordinates. The old com.billpiel/sayid coordinates are deprecated but still receive the same releases for now, so existing dependencies keep working.
  • #13: Document the nREPL middleware API (see doc/nrepl-api.md).
  • Rewrite the README's demo walkthrough around a small, self-contained example with current keybindings.
  • Consolidate the trace-management nREPL ops into four action-parametrized ops (sayid-trace-fn, sayid-trace-fn-at-point, sayid-trace-ns, sayid-all-traces), trimming the middleware from 37 ops to 26. (Breaking for any third-party nREPL client; the bundled Emacs client is updated in lockstep.)
  • Rename the buffer-oriented nREPL ops to client-agnostic names: sayid-buf-query-id-w-mod -> sayid-query-by-id, sayid-buf-query-fn-w-mod -> sayid-query-by-fn, sayid-buf-def-at-point -> sayid-def-value, sayid-buf-pprint-at-point -> sayid-pprint-value.
  • #29: Fix the wrong-type-argument error when pressing g (and similar commands) by no longer re-reading nREPL response values, which already arrive decoded on nREPL 1.0+.
  • #14: Fix inner tracing of functions that use letfn.
  • #31: Keep the generated reproduction expression in the kill ring and report clearly when the source file can't be located (sayid-gen-instance-expr, bound to g).
  • #68: Fix automatic dependency injection at cider-jack-in time for non-Leiningen projects.
  • Bump the minimum requirements to Clojure 1.10, nREPL 1.0, CIDER 1.0 and Emacs 28.
  • Bump the bundled tools.reader and tools.namespace dependencies.
  • Fix the broken Clojure version matrix that prevented the test suite from running on recent Leiningen.
  • Modernize CI: run against a JDK/Clojure matrix, lint the Clojure sources with clj-kondo, and byte-compile/lint the Emacs Lisp client.
  • Enable lexical binding in the Emacs Lisp client and tidy up its docstrings.
  • Modernize the Emacs client's nREPL usage: route all requests through CIDER's sender and drop the obsolete cider-current-connection.
  • Sync the in-Emacs help buffers and the README keybinding tables with the actual keybindings (drop entries for commands that no longer exist, add the missing ones).
  • Eliminate reflection warnings in the Clojure namespaces.
  • Report nREPL op failures with a CIDER-renderable error status instead of printing to the server console, and stop intercepting errors raised by other middleware.
  • #61: Remove version extraction logic.
  • Decouple the injected sayid plugin version from the version of the Emacs client (see sayid-injected-plugin-version).
  • sayid-trace-ns-by-pattern accepts interactive argument.

[0.1.0] - 2020-09-02

  • #57: Fix version extraction logic.

[0.0.19] - 2020-08-20

Fixed

  • Fix nREPL middleware and Lein plugin version numbers.

[0.0.18] - 2019-08-26

Changed

  • Removed support for nREPL 0.2.x.
  • Removed hard dep on Clojure.

[0.0.17] - 2018-09-01

Added

  • Added support for nREPL 0.4.

[0.0.16] - 2018-04-04

Added

  • Auto inject depencencies at cider-jack-in time. Thanks, Benedek Fazekas!

Fixed

  • upgrade to org.clojure/tools.reader "1.3.0-alpha3"

[0.0.15] - 2017-05-02

Fixed

  • emacs: disable undo to avoid buffer limit error
  • emacs: fix background colors in pretty-print buffer
  • support inner-tracing of loop form with multi-form body

[0.0.14] - 2017-03-06

Changed

  • emacs: several misc things for MELPA

[0.0.13] - 2017-02-22

Fixed

  • emacs: messed up some function names

[0.0.12] - 2017-02-21

Changed

  • emacs: improve render speed
  • emacs: prepare package for submission to melpa
  • emacs: useful message when sayid not responding

Fixed

  • support sets in pretty-print buffer

[0.0.11] - 2017-01-10

Added

  • CHANGELOG.md

Changed

  • Improved inner tracing
    • ex. recur no longer triggers explosion
  • Improved multimethod tracing
    • traced multimethod is still a MultiFn
    • dispatcher return value captured
  • Emacs : keybinding q to quit window

Read the original on github.com ↗