# Release Notes This file is the public release history for Feynman. Keep entries user-facing: what changed, why it matters, and anything users should do after upgrading. GitHub release notes are generated from the matching `## vX.Y.Z` section in this file. ## v0.2.40 - 2026-04-19 ### Fixes - Fixed local-model web-search failures where a model calls non-existent search aliases such as `google:search`; Feynman now maps those aliases to Pi's real `web_search` tool when it is available. - Granted the bundled researcher and verifier agents access to Pi web-access tools (`web_search`, `fetch_content`, and `get_search_content`) so their prompts and allowed tools match. - Made `feynman doctor` and `feynman search status` explicitly show when `web-search.json` has not been created and how to initialize it. - Stopped treating expired OAuth credentials as authenticated model availability, so `doctor`, `model list`, and onboarding guide users to re-login instead of failing later in chat. - Added a package-workspace setup lock so concurrent Feynman invocations do not race while restoring `.feynman/npm`. ### Validation - Full local tests passed: 137/137. - Typecheck, build, vendored runtime regeneration, runtime archive inspection, sequential CLI smoke, and parallel CLI smoke passed. ## v0.2.39 - 2026-04-19 ### Fixes - Fixed TUI-selected thinking/reasoning effort persistence. Feynman no longer passes an implicit `--thinking medium` on every launch, so thinking levels saved by Pi after `Shift+Tab` survive restarts. - Explicit `--thinking ` and `FEYNMAN_THINKING=` still override the saved default for that launch. ### Validation - Added regression coverage that Feynman only passes a launch thinking override when it was explicitly configured. - Full local tests passed: 126/126. - Typecheck and build passed. ## v0.2.38 - 2026-04-19 ### Fixes - Fixed `feynman update memory` and `feynman update session-search` so friendly core-package aliases resolve to the correct npm package sources and use Feynman's npm install path with peer-dependency compatibility flags. - Fixed `feynman summarize ... --window-size ...` and related summarize tuning flags when the flags appear after the source positional. - Fixed `feynman setup preview` so it actually runs the preview dependency check, matching the legacy `--setup-preview` alias. - Made optional `generative-ui` install/update failures degrade cleanly on macOS toolchains where upstream `glimpseui` cannot compile, without dumping thousands of Swift compiler lines. - Reduced deepresearch TUI redraw churn by freezing the Feynman header's Last Activity snapshot during live streaming work instead of recomputing it every render. - Fixed bundled skills that referenced prompt templates through broken installed relative paths. - Fixed the embedded Pi patcher so repeated runtime preparation does not duplicate the TUI stdin error handler. ### Documentation - Documented `feynman setup preview`. - Documented the existing `Shift+Tab` thinking-level hotkey and `/hotkeys` discovery path. ### Validation - Full local tests passed: 124/124. - Typecheck, build, and clean website build passed. - Local CLI matrix passed for help, doctor, status, model list/tier, search status/set, alpha status, setup preview, packages list/install, and package update aliases. - End-to-end workflow runs completed for chat, summarize, review, compare, audit, draft, lit, deepresearch with confirmation, replicate, watch/jobs, log, and a bounded autoresearch loop. ## v0.2.37 - 2026-04-19 ### Fixes - Hardened `/deepresearch` reviewer/audit fix handling so Feynman may only claim a patch landed after the edit/write tool succeeds and an explicit on-disk check proves the old unsupported content is gone and the corrected content exists. - Added provenance requirements for failed edit recovery so verification notes cannot mark an issue fixed before the final candidate actually reflects the fix. - Corrected MiniMax model preference casing to match Pi's exposed model IDs. ### Performance - Resolved preview/runtime executables in parallel before launching Pi, reducing synchronous startup work while preserving Windows, macOS, and Linux fallback behavior. ### Fork Review - Scanned all public forks and selectively adopted the low-risk startup/model-test improvements. Rejected product-specific or bloated fork changes such as Claude CLI bypass mode, ValiChord, Overleaf export, and an external `parallel-cli` dependency. ### Validation - Full local tests passed: 121/121. - Typecheck, build, local CLI doctor, and real one-shot launch smoke test passed. - Fork scan compared 676 accessible forks: 666 behind, 2 identical, 8 with unique commits inspected. ## v0.2.36 - 2026-04-18 ### Fixes - Hardened `/review` so it writes a durable plan, evidence notes, and `outputs/-review.md` instead of stopping after a planning/narration response. - Added blocked-review fallback behavior for PDFs or external sources that cannot be parsed, so failed extraction still produces an explicit review artifact with `Verification: BLOCKED`. - Fixed subagent child-process spawning under Feynman's Pi wrapper so writer/reviewer subagents no longer treat `--mode` as a module path. - Made optional package presets platform-aware so Linux users do not see or attempt to install the macOS-only `generative-ui` package. - Added the Release Notes entry to the website docs sidebar. ### Documentation - Updated peer review docs to describe the concrete output files and blocked-extraction behavior. - Updated package docs to clarify that memory and session search are core packages and `generative-ui` is macOS-only upstream. ### Validation - Added regression coverage for the `/review` durable-artifact contract. - Added regression coverage for platform-aware optional presets and Feynman-aware subagent spawning. - Real installed-global review, package-list/install, subagent, and extension-load checks were run before release. ## v0.2.35 - 2026-04-18 ### Fixes - Restored the `/deepresearch` confirmation gate: the workflow now writes `outputs/.plans/.md`, summarizes the plan, and waits for explicit user approval before searching, drafting, citing, or delivering final artifacts. - Changed top-level workflow invocation so `feynman deepresearch ...` behaves like the REPL workflow in a real terminal instead of forcing one-shot execution. - Added a Feynman wrapper around Pi's CLI entrypoint so completed print-mode runs exit cleanly after Pi finishes. - Tightened direct-mode `/deepresearch` artifact paths so research notes and verification files are written under `outputs/.drafts/`. ### Features - Added section-focused `alpha_get_paper` extraction with `section` / `sections` filters for abstract, introduction, methodology, experiments, results, discussion, limitations, and conclusion. - Added configurable `/summarize` context-window controls via flags and `FEYNMAN_SUMMARIZE_*` environment variables. ### Documentation - Added public `RELEASES.md` and website release notes so each release has visible fix and feature history. - Updated deep research docs to describe the plan-confirmation workflow and current PDF-safety behavior. ### Validation - Real installed-global REPL test: typed `/deepresearch what is BM25`, verified that only the plan existed before approval, then replied `yes` and verified final report, provenance, draft, cited draft, research notes, and verification artifacts. - Full local tests passed: 117/117. - Typecheck, build, website build, local pack, and local global install checks passed. ## v0.2.34 - 2026-04-18 ### Fixes - Tightened `/deepresearch` so direct-mode research must use at least three distinct search terms or angles before drafting. - Required direct-mode `/deepresearch` to record the exact search terms in the direct research artifact. - Added regression coverage for the multi-query deep research contract. ### Validation - Real RPC smoke test for `/deepresearch what is BM25` completed and wrote the required plan, draft, cited draft, final report, and provenance artifacts. - Release CI published npm and native bundles for macOS arm64/x64, Linux x64, and Windows x64. ## v0.2.33 - 2026-04-18 ### Fixes - Rewrote `/deepresearch` from a long protocol-style prompt into a shorter execution checklist so local models are less likely to echo instructions instead of doing work. - Made narrow direct-mode research complete without spawning verifier or reviewer subagents. - Avoided the crash-prone PDF parser path in `/deepresearch` unless PDF extraction is explicitly requested. ### Validation - Real RPC `/deepresearch what is BM25` completed with required artifacts and `agent_end`. - Full local tests, typecheck, build, audits, website build, and pack dry-run passed before release. ## v0.2.32 - 2026-04-18 ### Fixes - Fixed Pi subagent parallel output propagation so top-level task `output` paths are honored. - Added foreground and async regression coverage for subagent output handoff behavior. - Hardened deep research prompts around durable artifacts and provenance. ## v0.2.31 - 2026-04-17 ### Fixes - Fixed Feynman runtime auth environment propagation so launched Pi sessions can see the expected model provider credentials. - Revalidated setup and runtime startup paths after the auth fix. ## v0.2.30 - 2026-04-17 ### Fixes - Fixed Pi subagent task output handling in the runtime patch layer. - Preserved bundled research-agent file handoffs for multi-agent workflows. ## v0.2.29 - 2026-04-17 ### Maintenance - Updated bundled Pi runtime packages. - Rebuilt native release artifacts against the refreshed runtime package set. ## v0.2.28 - 2026-04-17 ### Maintenance - Removed runtime hygiene extension bloat and kept the bundled runtime closer to upstream Pi behavior. - Reduced custom extension surface area to keep the research agent simpler. ## v0.2.27 - 2026-04-17 ### Fixes - Added Pi event guards for workflow state transitions. - Improved workflow state tracking around long-running research operations. ## v0.2.26 - 2026-04-17 ### Fixes - Switched research context hygiene onto Pi runtime hooks instead of extra custom runtime logic. - Improved compatibility with upstream Pi runtime behavior. ## v0.2.25 - 2026-04-17 ### Fixes - Fixed workflow continuation and provider setup gaps. - Improved setup flow behavior for model-provider configuration. ## v0.2.24 - 2026-04-16 ### Fixes - Linked bundled runtime dependencies for core Pi packages. - Addressed missing dependency errors for installed core packages. ## v0.2.23 - 2026-04-16 ### Features - Added LM Studio setup support for local model workflows. - Added blocked-research artifact handling so interrupted runs keep useful state. ## v0.2.22 - 2026-04-16 ### Features - Added first-class LM Studio setup. - Improved local model onboarding defaults. ## v0.2.21 - 2026-04-16 ### Fixes - Fixed extension repair behavior. - Added the Opus 4.7 model overlay. ## v0.2.20 - 2026-04-16 ### Release - Restored publish workflow behavior after a duplicate npm version blocked release. - Native bundles remained available through GitHub releases. ## v0.2.19 - 2026-04-16 ### Fixes - Skipped release publication when the npm version already exists. - Prevented repeat publish attempts from failing the pipeline after npm publication succeeds. ## v0.2.18 - 2026-04-16 ### Release - Prepared the release automation baseline used by the current npm and native-bundle pipeline.