Miller v1.8.1

Miller v1.8.1 Release Notes

• Audience: Teams using Miller telemetry to diagnose weak searches, tool latency, and edit failures.
• Release shape: Patch release for actionable, privacy-safe telemetry and clearer recovery from path-shaped
  file search misses. No MCP tool, artifact schema, or index migration was added.
• Pinned extractor: julie-extract 2.13.0 (unchanged).

What Changed

Actionable telemetry

• Edit failures now carry stable reason buckets such as no_match, ambiguous_match, stale_target, and
  invalid_request without persisting raw paths, selectors, replacements, or rendered output.
• Tool-call telemetry now records the Miller server version, final index state, and bounded wait reason so
  exported data can distinguish stale-index behavior, workspace refresh waits, and index-load waits.
• Concurrent callers waiting on the same index load receive the same diagnostic wait classification.

File search recovery

• Path-shaped file search misses now suggest retrying with the basename or a shorter path fragment before
  falling back to broader automatic or symbol search.
• Identifier-like misses, filtered searches, and JSON output keep their existing behavior.

Upgrade Notes

• Plugin manifests advertise version 1.8.1.
• The bundled extractor remains julie-extract 2.13.0; no extractor restore, forced rescan, configuration
  change, or schema migration is required for an existing v1.8.0 installation.

Verification

• Pre-release verification includes the Release build, fast and scale suites, plugin contract tests, package
  matrix smoke tests, and checksum verification before publication.
• Live release verification:
  docs/findings/2026-07-12-v1.8.1-release-verification.md.