Skip to content

Releases

BugNarrator 1.1.2

Choose a tag to compare

@deffenda deffenda released this 13 Nov 18:51

BugNarrator 1.1.2 fixes upgrading older Local (Parakeet) helpers.

  • Automatically upgrades a legacy managed helper before launch, retaining downloaded models and the shared authentication token.
  • Verifies replacement packages before gracefully stopping same-user helpers whose running signature and canonical executable path match the managed server. Unrelated listeners are never stopped by port or name.
  • Replaces the helper atomically and records protocol compatibility only after installation.
  • Fixes startup waiting on an installation so the helper launches exactly once.
  • Adds live-process regression tests proving SIGTERM retirement, preserved model/token fixtures, refusal to stop unverified code, legacy-package filtering, and concurrent installation/startup.

Install the updated app; with Local (Parakeet) selected, allow its compatibility update to finish. An internet connection is required for the download. You do not need to delete models. Manually run server.py installations still require a source update and restart.

These macOS downloads are for Apple Silicon (arm64). Both app and server DMGs are signed, notarized and stapled, with SHA-256 checksums and versioned provenance.

Verification: CI passed 1,099 unit tests and all 8 UI tests. Repository validation, 71 Python tests, release smoke checks and packaged generated-speech transcription passed. Published artifact candidates passed signature, stapled-ticket, checksum and clean tagged-source provenance checks.

BugNarrator 1.1.1

Choose a tag to compare

@deffenda deffenda released this 11 Nov 17:12

BugNarrator 1.1.1 is a security and reliability update for the macOS app and matching Local (Parakeet) transcription server.

Update Local (Parakeet) too

After updating the app, open Settings → AI Engines, stop and remove the installed local server, then install it again. Existing managed servers do not update automatically. This release requires the new server authentication and health proof; an older server will appear unreachable. If running server.py manually, update the source and restart it. The default address is now http://127.0.0.1:8422.

Changes

  • Protect local transcription with per-user authentication tokens and verified server identity.
  • Harden credential handling, network redirects, response-size limits, logs, diagnostic bundles, and session cleanup.
  • Bound local transcription memory during long recordings and release model caches between decoding windows.
  • Improve recording cleanup and handle silent transcription chunks safely.
  • Make Settings fit the window, separate optional exports from recording setup, and show the correct Local Parakeet capabilities and privacy controls.
  • Update pinned dependencies and record the installed server dependency version in build provenance.

Downloads

These macOS downloads are for Apple Silicon (arm64). Download BugNarrator-macOS.dmg for the app and the local transcription server DMG for Local (Parakeet). Stable and versioned packages include SHA-256 checksums; versioned packages also include build provenance.

This release publishes macOS artifacts. Windows changes in the repository changelog are not Windows release downloads.

Verification

GitHub CI passed 1,096 macOS unit tests and all 8 UI tests. Repository validation, accessibility checks, 71 local-server tests, Release build and startup smoke checks passed. Both DMGs are Developer ID signed, notarized and stapled; their checksums and provenance were verified. The packaged local server passed a generated-speech transcription test.

BugNarrator 1.1.0

Choose a tag to compare

@deffenda deffenda released this 13 Sep 19:31
  • [FEATURE] Local (Parakeet) is now the default transcription provider for new installs, so recording can begin without an API key once the signed local server is installed and reachable (#1028).

  • [FEATURE] BugNarrator can discover, download, verify, install, start, stop, and remove the signed local transcription server and its managed model cache from Settings (#1051, #1059).

  • [FEATURE] Windows session review now renders screenshot-marker links and shares the expanded summary.md bundle contract with macOS (#1020, #1045, #1052).

  • [FIX] Existing provider selections and legacy OpenAI credentials survive upgrades without being overwritten or migrated to the wrong owner (#1050, #1056).

  • [FIX] Recording admission is serialized with quit and local-server controls, and app termination waits for bounded server cleanup (#1060, #1065).

  • [FIX] Transcript recovery and legacy index migration preserve recorded audio, screenshots, and recoverable sessions instead of risking data loss (#1064).

  • [FIX] Local server health refreshes asynchronously, test construction stays network-free, and isolated bootstrap paths retain their intended server ownership (#1049, #1057, #1066).

  • [FIX] Debug WAV recordings near the upload limit are re-encoded before upload, and sub-second transcription tails are folded into the preceding chunk (#1098, #1101).

  • [FIX] Near-zero marker intervals no longer duplicate the full transcript, and markers beyond the stopped recording clock no longer crash section building (#1108, #1110).

  • [FIX] Non-finite model numbers in confidence, timestamps, and screenshot annotations are rejected before integer conversion instead of crashing the app, and malformed timestamps such as 01:xx:00 are rejected instead of being reinterpreted (#1126, #1129).

  • [FIX] GitHub and Jira issue titles are normalized and capped to tracker limits, and exported GitHub bodies neutralize untrusted Markdown links, images, block syntax, and deduplication-hint escapes (#1112, #1118).

  • [FIX] Local helper shutdown now owns the complete process group, preserves the server's two-second graceful shutdown window, kills TERM-resistant descendants, and keeps wrapper diagnostics out of user-facing errors (#1124, #1130).

  • [FIX] Release smoke packaging runs the startup Keychain probe by default, Semgrep reports Docker-invisible mounts accurately, and the docs-site dependency graph pins patched qs and joi releases (#1032, #1034, #1131).

  • [FIX] Session export grammar now reads “Exported 1 issue” for a single issue (#1106).

  • [INTERNAL] Settings credential persistence, hotkey coordination, the issue-review workspace, and AppState runtime construction now have focused owners with their existing behavior preserved (#1073, #1075, #1122, #1123).

  • [INTERNAL] Validation now gates shell scripts with ShellCheck, Python scripts with ruff, the local transcription Python suite, source and test warnings, accessibility checks, shared bundle fixtures, and pinned Windows release actions (#1083, #1089, #1100, #1104, #1114, #1116).

  • [INTERNAL] Board audit state handling no longer deadlocks repair work for a red PR that is already in review (#1042).

  • [INTERNAL] Session-library filters and selection, Settings readiness, extraction budgets, display masking, export review policy, and local-first first-run behavior have focused regression coverage (#1040, #1041, #1092, #1096, #1106).

  • [INTERNAL] The docs-site qs and joi Dependabot alerts are resolved with patched transitive overrides; the remaining image-size build-only advisory remains documented as an accepted exception (#1131).

BugNarrator 1.0.46

Choose a tag to compare

@deffenda deffenda released this 25 Aug 16:14
  • [FIX] A session library stored in the oldest index format no longer opens empty. That index named its sessions only by id, which the current code refused to parse — so the library appeared empty while every session file sat intact on disk, and the recovery path written for exactly that format could never run. Worse, the empty read could then let a later save delete the very files that would have restored it (#1017).

  • [FIX] A failed transcription no longer deletes your recording. If transcription failed for the most common reason — an unparseable provider response, exhausted retries, an audio export error — the session's audio and screenshots were deleted instead of being kept for retry. A dropped network connection preserved the session; a malformed response destroyed it. Local-model users were most exposed. The recording is now preserved and retryable in every case where the audio still exists (#1015).

  • [INTERNAL] The semgrep scan's outcome now appears in CI output. It was written only to .validation-artifacts/semgrep-status.txt, which CI neither prints nor uploads — so a scan that reported "NOT RUN: neither docker nor a local semgrep on PATH is available" looked exactly like a clean scan in every log (#1012).

  • [INTERNAL] The accessibility regression check runs in the blocking validation path again. It was written for OPS-004, wired into CI, then orphaned when 1b8f3e2 removed that wiring in May — leaving a working, hermetic gate referenced by nothing. Verified it fails the build when broken (#1012).

  • [INTERNAL] Removed dead code: the unreferenced clickWhenHittable UI-test helper, orphaned when #949 dropped the typing assertions, and the generate_app_icon.sh / render_app_icon.swift scripts, which no workflow, script, or doc referenced (#1012).

  • [INTERNAL] Dropped a no-op @preconcurrency on AudioRecorder's AVAudioRecorderDelegate conformance, which the compiler reported as having no effect (#1012).

  • [DOCS] The site, its tagline, and the README now lead with what actually distinguishes BugNarrator — a whole exploratory session rather than one clip per ticket, desktop-wide rather than browser-bound, and local-first with an option where audio never leaves the Mac — instead of a feature list that reads like every other capture tool (#967).

  • [INTERNAL] The product spec is now enforced by a machine check instead of prose. The session-bundle layout is generated from the spec into contract-fixtures/session-bundle-layout.json, verified by scripts/validate.sh, and bound to the real exporter by a test that runs TranscriptExporter.writeBundle and compares the bundle's actual contents. A spec claim that stops being true now fails a build (#966).

  • [DOCS] The spec covers what shipped: the first-run welcome tour, the bundled sample session, the issue-extraction offer, recording without a configured provider, and the summary.md / manifest.json bundle contract. Two roadmap entries that reported CI wiring as complete are corrected — commit 1b8f3e2 removed it in May and scripts/accessibility_regression_check.sh and scripts/generate_release_summary.py were left referenced by no workflow (#966).

  • [INTERNAL] macOS and Windows now share committed contract fixtures for transcript.md, so a parity break fails a build instead of surviving as two green suites. Each side previously asserted against its own retyped literal — which is how the Windows test came to pin a macOS output macOS produces nowhere outside UTC (#1000).

  • [INTERNAL] Session timestamp rendering in exports is now injectable. The default is unchanged (the user's locale and timezone); fixtures pin en_US_POSIX/UTC with ASCII spaces, because Apple's formatter uses U+202F before AM/PM while .NET uses ASCII — two byte-different strings that look identical (#1000).

BugNarrator 1.0.45

Choose a tag to compare

@deffenda deffenda released this 14 Aug 18:22

Highlights

  • Fixes Local Parakeet failures on long recordings with supported 120-second chunks, a 15-minute local timeout, and no duplicate retry while MLX is still working.
  • Ships the standalone Parakeet server in a Developer ID-signed, notarized, stapled DMG. The packaged server passed a real generated-speech transcription before publication.
  • Signs PyInstaller embedded Python and native libraries with the same Developer ID and preserves the narrow MLX executable-memory entitlement required under hardened runtime.
  • Updates in-app Parakeet setup, user documentation, deployment guidance, checksums, provenance, and fail-closed release validation.
  • Includes the privacy, reliability, search, provider, UI-test, CodeQL, dependency, and release hardening accumulated in the unpublished 1.0.42-1.0.44 candidates.

Install

Install BugNarrator-macOS.dmg. For local transcription, install bugnarrator-transcription-macos-arm64.dmg and follow Settings > AI Engines. Both disk images are signed, notarized, and stapled. Apple Silicon is required for the standalone Parakeet server.

Fixes #987, #989, #991, and #993.

BugNarrator 1.0.41

Choose a tag to compare

@deffenda deffenda released this 05 Aug 19:08

Fixes

  • Settings opens where the work is. If no AI provider credential is configured, Settings now opens on the AI Engines pane instead of General — the pane a new user is sent there to fix is the one they land on. (#911)
  • No more dead-end invitations. The menu bar and empty session library no longer tell you that you can start recording while the record control is disabled. Setup copy names the prerequisite instead. (#910)
  • Session bundles carry the actual work product. Exports now include summary.md — the review summary and extracted issues — alongside transcript.md and screenshots/, plus a manifest.json describing the bundle's contents. (#914)
  • A missing screenshot no longer blocks an export. If a referenced screenshot file has been moved or deleted, the bundle still exports with the screenshots that remain, and the missing ones are listed in manifest.json. (#914)
  • Install docs corrected. They previously told you to Control-click past a Gatekeeper warning. Releases are Developer ID signed, notarized, and stapled, so that warning does not appear. (#909)

Validation

  • Developer ID signed: ABD Enterprises, Inc. (2R4WAH4R53)
  • Apple notarization accepted and stapled for both the app and the DMGs
  • Gatekeeper accepts the Release app as source=Notarized Developer ID
  • codesign --verify --deep --strict: clean
  • xcrun stapler validate: passes on the app and on both DMGs
  • Full unit suite and the macOS UI suite pass

Artifacts

  • BugNarrator-v1.0.41-macOS.dmg
  • BugNarrator-macOS.dmg (stable download link)
  • SHA-256 checksum files for both

Verify a download with shasum -a 256 -c BugNarrator-macOS.dmg.sha256.

BugNarrator 1.0.40

Choose a tag to compare

@deffenda deffenda released this 23 Jul 00:46

BugNarrator 1.0.40

Release build from main d5b3b19.

Highlights:

  • Clarifies system-audio recording setup failures and recovery guidance.
  • Keeps Local (Parakeet) transcription progress copy provider-aware.
  • Reports zero-frame system-audio recordings as capture/setup failures instead of blaming Parakeet.
  • Includes the 1.0.40 changelog fixes for system-audio permission diagnostics, recording audio setup hints, and internal hardening.

Validation:

  • scripts/validate.sh passed.
  • scripts/release_smoke_test.sh passed.
  • Developer ID signing verified for ABD Enterprises, Inc. (2R4WAH4R53).
  • Apple notarization accepted and stapler validation passed for the app and DMG.
  • Gatekeeper accepted the installed app as Notarized Developer ID.

SHA256:

  • BugNarrator-v1.0.40-macOS.dmg: 1866fb23f6ce791a0854b77726cf635a739b41b9e76f7abc389f9487faee3ad7
  • BugNarrator-macOS.dmg: 1866fb23f6ce791a0854b77726cf635a739b41b9e76f7abc389f9487faee3ad7

BugNarrator 1.0.39

Choose a tag to compare

@deffenda deffenda released this 11 Jun 17:34

BugNarrator 1.0.39

Signed and notarized macOS hotfix built from main commit d2481ba.

Fixes:

  • Stopped the menu bar microphone level meter from crashing when CoreAudio delivers level updates on its realtime callback queue.

Validation:

  • PASS: ./scripts/validate.sh origin/main
  • PASS: xcodebuild BugNarratorTests, 563 tests
  • PASS: focused microphone level realtime-queue regression
  • PASS: PR #415 CI and CodeQL checks
  • PASS: signed/notarized DMG build with NOTARIZE=YES NOTARY_PROFILE=BugNarratorNotary
  • PASS: stapler validation for app and DMG
  • PASS: spctl accepted the app as Notarized Developer ID
  • PASS: installed /Applications/BugNarrator.app 1.0.39 launched and stayed running after menu-bar click; no new crash report created

SHA-256:

b4cad71f377f29b48708fbf2ef82f74f09fb3b4af79dc10cd3656b20057d3437  BugNarrator-v1.0.39-macOS.dmg

BugNarrator 1.0.38

Choose a tag to compare

@deffenda deffenda released this 11 Jun 17:13

BugNarrator 1.0.38

Signed and notarized macOS release built from main commit 36bd7f1.

Highlights:

  • Refreshed menu-bar AI setup state when the saved OpenAI credential changes, so Settings and the menu agree about a usable key.
  • Blocked recording starts until AI transcription setup is usable, defaulted fresh installs to English transcription hints, and added transcript quality warnings for wrong-script output.
  • Hardened the macOS CI Xcode selector for self-hosted runners.

Validation:

  • PASS: ./scripts/validate.sh origin/main
  • PASS: actionlint .github/workflows/ci.yml
  • PASS: PR #413 CI and CodeQL checks
  • PASS: signed/notarized DMG build with NOTARIZE=YES NOTARY_PROFILE=BugNarratorNotary
  • PASS: stapler validation for app and DMG
  • PASS: spctl accepted the app as Notarized Developer ID

SHA-256:

cfb5e20a77b773d37f3808de78e31c8a5aeac44e76f2e4b17b5b98eefe100628  BugNarrator-v1.0.38-macOS.dmg

BugNarrator 1.0.37

Choose a tag to compare

@deffenda deffenda released this 01 Jun 22:09

Fixes

  • Refreshes the menu-bar AI setup state when saved OpenAI credential readiness changes, so Settings and the menu do not disagree about a usable key.
  • Adds UI regression coverage proving a saved OpenAI key shows Settings as ready and keeps Validate/Remove actions enabled.

Validation

  • Release smoke test passed.
  • Developer ID signed with ABD Enterprises, Inc. (2R4WAH4R53).
  • Apple notarization accepted and stapled for the app and DMG.
  • Gatekeeper accepted the Release app as Notarized Developer ID.

Artifacts

  • BugNarrator-macOS.dmg
  • BugNarrator-v1.0.37-macOS.dmg
  • SHA-256 checksum files for both DMGs