Skip to content

v2.0.0-alpha.3

Choose a tag to compare

View all tags
@curdriceaurora curdriceaurora released this 30 Mar 01:27
· 391 commits to main since this release
v2.0.0-alpha.3
7eaae2c
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

v2.0.0-alpha.3 Release Notes

Release Date: March 2026
Compare: v2.0.0-alpha.2...v2.0.0-alpha.3

Summary

Alpha 3 focuses on architectural modernization, comprehensive test coverage hardening, provider ecosystem expansion, and production-grade reliability. This release introduces multi-LLM provider support (OpenAI-compatible, llama.cpp, MLX, Anthropic Claude), a search foundation with BM25+vector hybrid retrieval, memory management primitives, and extensive guardrails to prevent regressions.

Key highlights: 4 new AI providers, search system (G-1/G-2), proactive memory management, 4100+ integration tests, branch coverage ratcheting, and security/correctness detector packs.

Features

AI Provider Ecosystem

  • OpenAI-compatible provider tier — Generic interface supporting any OpenAI-compatible API endpoint (#335, PR #689)
  • llama.cpp provider support via plugin registry (#723, PR #835)
  • MLX provider support via plugin registry — Native Apple Silicon optimization (PR #838)
  • Anthropic Claude provider (text + vision) — Full-featured integration with Claude models (PR #840)

Search Foundation (G-1 & G-2)

  • G-1 search foundation — Interfaces, BM25 lexical search, vector index, embedding cache infrastructure (#715, PR #846)
  • G-2 hybrid BM25+vector retrieval — RRF (Reciprocal Rank Fusion) fusion strategy for combined ranking (#715, PR #851)

Core Platform Enhancements

  • Architecture modernization Phase A — Refactored interfaces and protocol contracts (#710, #711, #712, PR #744)
  • Architecture modernization Phase B — Signal isolation and module boundary enforcement (#707, #708, #709, PR #749)
  • Double-buffered processing — I/O-compute overlap in PipelineOrchestrator for improved throughput (#713, PR #764)
  • Proactive memory management primitives — Buffer pool and batch sizer integration (#714, PR #801, #808)
  • Runtime controls + vision fail-fast containment — Organize operation sandboxing and error bounds (PR #812)

TUI & CLI Enhancements

  • Persistent runtime settings controls — User preferences saved and restored across sessions (PR #817)
  • Parallel flags for preview command — Concurrent file analysis with configurable concurrency (#727, PR #841)

AI-Powered File Organization

  • AIHeuristic with Ollama semantic classification — Intelligent paragraph-based categorization (PR #884)
  • AIHeuristic prompt system/user role separation — Enhanced semantic reasoning with explicit role framing (PR #895)
  • AIHeuristic LRU result cache — Bounded result caching for performance optimization (PR #897)

Rules & Anti-Pattern Framework

  • Anti-pattern framework augmentation G1–G6 — Six gap pattern definitions for comprehensive rule coverage (#922, PR #922)

Infrastructure & Tooling

  • Claude GitHub Actions workflow — Automation for PR review and code analysis (PR #821)
  • Benchmark suite-specific runners — Standardized benchmark contracts across suites (#815, PR #815)
  • Integration test harness — 39 tests across 7 gap categories for anti-pattern validation (#728, PR #736)

Fixes

Core Functionality

  • Config profile overrides ignored (#724) — Restore proper override precedence (PR #730)
  • Model cleanup race condition (#726) — Eliminate concurrent access issues (PR #730)
  • Pipeline prefetch timing, FileNotFoundError consistency, failed-file display — Robust error handling and reporting (PR #811)
  • Path validation hardening — Guard against directory traversal and Windows drive escape attacks (PR #809)
  • Pre-epic tier 1 cleanup — Resolve critical #725, #697 issues (#725, #697, PR #740)
  • Count deduplicated files in OrganizationResult — Fix result counting logic (PR #937)
  • Feature extractor path keyword matching — Match as exact components, not substrings (PR #948)

Dependencies & Security

  • PyPDF2 → pypdf migration — Resolve GHSA security vulnerability (#848, PR #852)
  • Passlib → direct bcrypt — Simplify password hashing, allow bcrypt <6 (PR #879)
  • Security audit findings — Address search, CLI, cache, and CI vulnerabilities (PR #869)

CI/Tests

  • macOS CI mock optional dependencies — Fix test failures on macOS runners (#716, PR #716)
  • Mock model_type for TextProcessor validation — Resolve validation test flakes (PR #721)
  • Organizer test fixture for provider factory — Update test infrastructure (PR #722)
  • Main CI regressions from run 23080275631 — Fix #805 integration test failures (PR #806)
  • Windows/macOS failures in ci-full daily matrix — Cross-platform stability (PR #829)
  • nightly CI Full Matrix failures — macOS and Windows environment fixes (PR #887, #860)
  • Silence 60 spurious failures from optional search deps — Guard tests against missing dependencies (#913, PR #916)
  • Replace busy-wait loop with threading.Event() — Remove flaky time.sleep assertions in test_warmup (PR #938)
  • Asyncio mode=auto + local coverage ratchet gates — Async test reliability (PR #858)
  • Diff-cover for PR gate; fix integration coverage floor — Accurate PR coverage delta reporting (PR #864)
  • Single-doc corpus edge cases and OOV zero-similarity regression — Handle search corpus boundary conditions (PR #893)
  • Nightly CI failures 2026-03-17 — Resolve environment-specific test failures (PR #860)
  • Remove -n=auto from Windows CI — Prevent spurious KeyboardInterrupt on Windows (PR #910)
  • 5 failing integration tests on main — Fix regression blockers (PR #945)
  • 7 test failures across main (#968) — Address stability issues (PR #969)
  • pytest-timeout<2.4.0 pin — Prevent Windows CI crashes (PR #970)
  • Restore compatibility for health, CLI, and web routes — Fix routing regressions (PR #982)
  • OSError in _build_tree_context for non-existent paths — Graceful error handling (PR #983)

Documentation & Examples

  • Stale reference and doc-path checkers — Use my_service example names (PR #890)

Infrastructure & Hardening

CI/CD Enhancements

  • Node 24-compatible Actions migration — Update GitHub Actions to modern Node runtime (PR #759)
  • CI organizer compatibility seams — Restore backward compatibility infrastructure (PR #756)
  • Restore PYPI_TOKEN test for OIDC publishing — Modern PyPI authentication (#702, PR #702)
  • Split benchmark lane and add desktop rust checks — Isolate benchmarks; enable Rust/Tauri validation (PR #825)
  • Fix nightly CI Full Matrix stability — Cross-platform test reliability (PR #887)
  • stabilize CI Full Matrix on macOS/Windows — Deterministic platform behavior (PR #833)
  • Dedupe docs workflow triggers for PR CI — Reduce redundant pipeline runs (PR #834)
  • Add Rust/Tauri build to PR CI workflow — Desktop application validation (PR #1006)

Coverage & Quality Gates

  • Integration test harness — 39 branch-coverage tests across 7 gap categories (#728, PR #736)
  • Branch-coverage integration test suite — Comprehensive edge-case coverage (PR #924)
  • 212 branch-coverage tests for feature_extractor, template_manager, cleanup, history — Gap coverage (PR #867)
  • Branch coverage ratcheting — Enable and enforce growing coverage floors (PR #915)
  • PR coverage gate (80%) + integration coverage gate (70%) — Mandatory baseline coverage (#861, PR #861)
  • Integration coverage floor progression — Ratchet from 35% → 45% → 50% → 55% → 56% → 60% (#856, PR #949, #953, #958, #960, #961, #963)
  • Docstring coverage gate 90% → 95% — Higher documentation standards (#854, PR #859)
  • Move coverage floor enforcement out of pre-commit — Shift to CI for faster feedback (PR #917)
  • Diff-cover gate in pre-commit validation — Catch PR delta coverage drops early (PR #940)
  • MD031 ratchet — Enable blanks-around-fences markdown enforcement (PR #941)
  • 4112 tests added in integration suite — Comprehensive scenario coverage (#856, PR #961)

Guardrails & AST Detectors

  • Foundation hardening checks promotion — Elevate critical validations (PR #772)
  • AST weak assertion detector — Detect brittle isinstance checks (PR #773)
  • Docs-code contract checks for prefetch surfaces — Prevent doc-implementation drift (PR #774)
  • Traceback preservation guard — Maintain error context through exception chains (PR #775)
  • Review-regression audit framework — Track and prevent regressions across reviews (PR #792)
  • Security detector pack — Comprehensive security pattern detection (PR #793)
  • Correctness detector pack — Logic and type safety checks (PR #794)
  • Test-quality detector pack — Test robustness and assertion patterns (PR #795)
  • Memory-lifecycle AST detector pack — Detect resource leaks and improper cleanup (#803, PR #810)
  • #813 PR-1 API compatibility contracts (A + D) — Backward compatibility validation (PR #827)
  • #813 PR-2 degraded runtime + fallback integrity contracts — Graceful degradation paths (PR #830)
  • #813 PR-3 runtime truth contracts — Correctness under failure modes (PR #831)
  • #813 PR-4 schema and test-proof guardrails — Data shape contracts (PR #832)
  • Replace string matching with AST call nodes in S1/S2 guardrail — Robust pattern detection (PR #928)
  • Harden search S1/S2 AST matching and add memory-lifecycle guardrails — Enhanced validation (PR #929)
  • MECE-harden correctness, memory-lifecycle, and security guardrails — Comprehensive, non-overlapping checks (PR #935)
  • T10 predicate negative-case guardrail and backfill — Cover assertion negations (#930, PR #939)
  • Promote T10 predicate negative-case check to pre-commit — Catch violations early (PR #942)

Protocol & Type Contracts

  • Tighten Protocol contracts — Positional-only parameters, no-ambiguous-None, typed kwargs, registry clones (PR #807)
  • Modern type annotations (UP045) — PEP 646 TypeVarTuple, PEP 692 TypedDict unpack (PR #899)

Test Infrastructure

  • AsyncClient, CliRunner, and FakeTextModel fixtures — Reusable testing infrastructure (PR #954)
  • Replace isinstance assertions in tracked test files — Use specific type checks (PR #925)
  • Broaden isinstance guardrail to full test suite — Comprehensive type safety (PR #926)
  • Parametrize TestDisplaySummary — Reduce test duplication (PR #965)
  • Move private helper tests to unit module — Improve test organization (PR #966)
  • Eliminate time.sleep and vacuous bounds — Remove flaky sleeps; use events (#900, PR #907)
  • Guard 8 test files against optional-dep failures — Graceful missing-dependency handling (#918, #919, PR #921)
  • Add branch-coverage tests for 4 low-coverage modules — Targeted coverage (#866, PR #947)
  • Add cli + models tests; ratchet coverage floor 45% → 50% — CLI and provider coverage (PR #957)
  • PR2 api+web integration tests — API and web layer validation (PR #958)
  • Web+plugins coverage — Extension point validation (PR #960)
  • Add 211 tests for methodologies, events, parallel — Concurrent execution paths (PR #963)

Dependency Management

  • Remove stale [dependency-groups] — Consolidate uv dependency specification (PR #956)
  • Bump multiple Action versions — Keep GitHub Actions current (PR #871–#876, #971–#975)
  • Bump cargo/npm dependencies — Security and feature updates (PR #923, #932, #978, #979)
  • Update pytest-timeout requirement — Fix Windows test infrastructure (#976)

Pre-commit & Validation

  • Canonicalize pre-pr validation flow — Standardized pre-submission checks (PR #788)
  • Lock canonical pre-pr commands — Prevent drift in validation gates (PR #790)
  • Phase 4 pre-commit hooks — Threshold drift and search corpus safety (PR #927)
  • Fix warnings import, add fallback failure guard, add sync comment — Robust CI error handling (PR #944)

Documentation & Planning

  • Full-repo audit artifact + reconciled backlog — Comprehensive issue triage (#782, PR #796)
  • Legacy review applicability review — Assess historic findings (#791, PR #791)
  • Issue #783 security remediation verification — Hardened CI security checks (PR #797)
  • Issue #784 correctness remediation verification — CI contract enforcement (PR #798)
  • Issue #785 test-quality findings remediation — Zero low-quality test patterns (PR #799)
  • Issue #787 first-wave closeout guardrails — Finalize epic validation (PR #800)
  • Reconcile provider/CI closeout and codify 7-stream MECE plan — Organize parallel work streams (PR #837)
  • Remove historical planning docs and dependent CI tests — Clean up pre-v2 artifacts (#908, PR #909)
  • Document [llama] optional dependency — Add llama.cpp to dependencies.md (PR #839)

Documentation

Guides & Onboarding

  • AI Provider Setup Guide — Configure OpenAI-compatible, llama.cpp, MLX, Claude (PR #997)
  • Root Troubleshooting Guide Expansion — Common issues and resolution paths (PR #995)
  • Real-World Plugin Development Example — Walk-through of plugin architecture (PR #998)
  • Audio Transcriber Test Coverage Verification — Audio pipeline validation (PR #999)
  • GLM-OCR Evaluation Deferral — Document postponed decision (PR #1001)
  • Skipped Tests for Alpha.3 Documentation — Explain test skip rationale (PR #1002)
  • Search API Documentation Expansion — Detailed search endpoint docs (PR #1004)
  • Audio and Video Enablement Guide — Configure multimedia support (PR #1007)
  • Guided Optional Dependency Installer (fo doctor) — Interactive dependency setup (PR #1008)
  • Guided Setup Wizard & Onboarding Experience — First-run configuration flow (PR #1009)
  • Create Feature-to-Install Matrix for Optional Dependencies — Dependency availability map (PR #994)

Issue Closures

  • Close Testing Umbrella Issue #611 — Comprehensive test coverage complete (PR #1005)
  • Verify Release Pipeline and Tag Alpha.3 — Release validation (PR #1013)

Known Limitations & Deferrals

  • GLM-OCR evaluation deferred — Decision postponed pending further evaluation (PR #1001)

Statistics

Category | Count | Notes -- | -- | -- Features | 13 | Provider ecosystem, search, memory mgmt, rules Fixes | 27 | Core logic, security, dependencies, cross-platform Infrastructure | 57 | CI/CD, coverage, guardrails, test infrastructure Documentation | 13 | Guides, setup, API docs, troubleshooting Dependency Updates | 20+ | Action versions, cargo, npm, Python packages Total PRs | 130+ | v2.0.0-alpha.2 → v2.0.0-alpha.3 Integration Tests Added | 4,100+ | Branch coverage ratcheting New AI Providers | 4 | OpenAI-compat, llama.cpp, MLX, Claude

Migration & Upgrade Notes

Breaking Changes

None documented. Alpha 3 maintains API compatibility with alpha.2.

Optional Dependency Changes

  • New optional [llama] group for llama.cpp provider
  • MLX provider optional support
  • Search features require optional embedding dependencies

Configuration Updates

  • Provider factory now handles all model vendors via plugin registry
  • Runtime controls persist to user settings file

Testing

  • Windows CI no longer uses -n=auto due to KeyboardInterrupt issues
  • Optional dependency tests now gracefully skip if dependencies unavailable

Contributors

This release includes contributions from the core team and the Dependabot automation service.

Next Steps

  • Alpha.4 roadmap — Continued search refinement, provider hardening
  • Beta planning — Performance optimization, production deployment patterns
  • Community feedback — Encourage early testing and issue reporting

Download: Releases Page

# v2.0.0-alpha.3 Release Notes

Release Date: March 2026
Compare: [v2.0.0-alpha.2...v2.0.0-alpha.3](v2.0.0-alpha.2...v2.0.0-alpha.3)

Summary

Alpha 3 focuses on architectural modernization, comprehensive test coverage hardening, provider ecosystem expansion, and production-grade reliability. This release introduces multi-LLM provider support (OpenAI-compatible, llama.cpp, MLX, Anthropic Claude), a search foundation with BM25+vector hybrid retrieval, memory management primitives, and extensive guardrails to prevent regressions.

Key highlights: 4 new AI providers, search system (G-1/G-2), proactive memory management, 4100+ integration tests, branch coverage ratcheting, and security/correctness detector packs.

Features

AI Provider Ecosystem

  • OpenAI-compatible provider tier — Generic interface supporting any OpenAI-compatible API endpoint (#335, PR #689)
  • llama.cpp provider support via plugin registry (#723, PR #835)
  • MLX provider support via plugin registry — Native Apple Silicon optimization (PR #838)
  • Anthropic Claude provider (text + vision) — Full-featured integration with Claude models (PR #840)

Search Foundation (G-1 & G-2)

  • G-1 search foundation — Interfaces, BM25 lexical search, vector index, embedding cache infrastructure (#715, PR #846)
  • G-2 hybrid BM25+vector retrieval — RRF (Reciprocal Rank Fusion) fusion strategy for combined ranking (#715, PR #851)

Core Platform Enhancements

  • Architecture modernization Phase A — Refactored interfaces and protocol contracts (#710, #711, #712, PR #744)
  • Architecture modernization Phase B — Signal isolation and module boundary enforcement (#707, #708, #709, PR #749)
  • Double-buffered processing — I/O-compute overlap in PipelineOrchestrator for improved throughput (#713, PR #764)
  • Proactive memory management primitives — Buffer pool and batch sizer integration (#714, PR #801, #808)
  • Runtime controls + vision fail-fast containment — Organize operation sandboxing and error bounds (PR #812)

TUI & CLI Enhancements

  • Persistent runtime settings controls — User preferences saved and restored across sessions (PR #817)
  • Parallel flags for preview command — Concurrent file analysis with configurable concurrency (#727, PR #841)

AI-Powered File Organization

  • AIHeuristic with Ollama semantic classification — Intelligent paragraph-based categorization (PR #884)
  • AIHeuristic prompt system/user role separation — Enhanced semantic reasoning with explicit role framing (PR #895)
  • AIHeuristic LRU result cache — Bounded result caching for performance optimization (PR #897)

Rules & Anti-Pattern Framework

  • Anti-pattern framework augmentation G1–G6 — Six gap pattern definitions for comprehensive rule coverage (#922, PR #922)

Infrastructure & Tooling

  • Claude GitHub Actions workflow — Automation for PR review and code analysis (PR #821)
  • Benchmark suite-specific runners — Standardized benchmark contracts across suites (#815, PR #815)
  • Integration test harness — 39 tests across 7 gap categories for anti-pattern validation (#728, PR #736)

Fixes

Core Functionality

  • Config profile overrides ignored (#724) — Restore proper override precedence (PR #730)
  • Model cleanup race condition (#726) — Eliminate concurrent access issues (PR #730)
  • Pipeline prefetch timing, FileNotFoundError consistency, failed-file display — Robust error handling and reporting (PR #811)
  • Path validation hardening — Guard against directory traversal and Windows drive escape attacks (PR #809)
  • Pre-epic tier 1 cleanup — Resolve critical #725, #697 issues (#725, #697, PR #740)
  • Count deduplicated files in OrganizationResult — Fix result counting logic (PR #937)
  • Feature extractor path keyword matching — Match as exact components, not substrings (PR #948)

Dependencies & Security

  • PyPDF2 → pypdf migration — Resolve GHSA security vulnerability (#848, PR #852)
  • Passlib → direct bcrypt — Simplify password hashing, allow bcrypt <6 (PR #879)
  • Security audit findings — Address search, CLI, cache, and CI vulnerabilities (PR #869)

CI/Tests

  • macOS CI mock optional dependencies — Fix test failures on macOS runners (#716, PR #716)
  • Mock model_type for TextProcessor validation — Resolve validation test flakes (PR #721)
  • Organizer test fixture for provider factory — Update test infrastructure (PR #722)
  • Main CI regressions from run 23080275631 — Fix #805 integration test failures (PR #806)
  • Windows/macOS failures in ci-full daily matrix — Cross-platform stability (PR #829)
  • nightly CI Full Matrix failures — macOS and Windows environment fixes (PR #887, #860)
  • Silence 60 spurious failures from optional search deps — Guard tests against missing dependencies (#913, PR #916)
  • Replace busy-wait loop with threading.Event() — Remove flaky time.sleep assertions in test_warmup (PR #938)
  • Asyncio mode=auto + local coverage ratchet gates — Async test reliability (PR #858)
  • Diff-cover for PR gate; fix integration coverage floor — Accurate PR coverage delta reporting (PR #864)
  • Single-doc corpus edge cases and OOV zero-similarity regression — Handle search corpus boundary conditions (PR #893)
  • Nightly CI failures 2026-03-17 — Resolve environment-specific test failures (PR #860)
  • Remove -n=auto from Windows CI — Prevent spurious KeyboardInterrupt on Windows (PR #910)
  • 5 failing integration tests on main — Fix regression blockers (PR #945)
  • 7 test failures across main (#968) — Address stability issues (PR #969)
  • pytest-timeout<2.4.0 pin — Prevent Windows CI crashes (PR #970)
  • Restore compatibility for health, CLI, and web routes — Fix routing regressions (PR #982)
  • OSError in _build_tree_context for non-existent paths — Graceful error handling (PR #983)

Documentation & Examples

  • Stale reference and doc-path checkers — Use my_service example names (PR #890)

Infrastructure & Hardening

CI/CD Enhancements

  • Node 24-compatible Actions migration — Update GitHub Actions to modern Node runtime (PR #759)
  • CI organizer compatibility seams — Restore backward compatibility infrastructure (PR #756)
  • Restore PYPI_TOKEN test for OIDC publishing — Modern PyPI authentication (#702, PR #702)
  • Split benchmark lane and add desktop rust checks — Isolate benchmarks; enable Rust/Tauri validation (PR #825)
  • Fix nightly CI Full Matrix stability — Cross-platform test reliability (PR #887)
  • stabilize CI Full Matrix on macOS/Windows — Deterministic platform behavior (PR #833)
  • Dedupe docs workflow triggers for PR CI — Reduce redundant pipeline runs (PR #834)
  • Add Rust/Tauri build to PR CI workflow — Desktop application validation (PR #1006)

Coverage & Quality Gates

  • Integration test harness — 39 branch-coverage tests across 7 gap categories (#728, PR #736)
  • Branch-coverage integration test suite — Comprehensive edge-case coverage (PR #924)
  • 212 branch-coverage tests for feature_extractor, template_manager, cleanup, history — Gap coverage (PR #867)
  • Branch coverage ratcheting — Enable and enforce growing coverage floors (PR #915)
  • PR coverage gate (80%) + integration coverage gate (70%) — Mandatory baseline coverage (#861, PR #861)
  • Integration coverage floor progression — Ratchet from 35% → 45% → 50% → 55% → 56% → 60% (#856, PR #949, #953, #958, #960, #961, #963)
  • Docstring coverage gate 90% → 95% — Higher documentation standards (#854, PR #859)
  • Move coverage floor enforcement out of pre-commit — Shift to CI for faster feedback (PR #917)
  • Diff-cover gate in pre-commit validation — Catch PR delta coverage drops early (PR #940)
  • MD031 ratchet — Enable blanks-around-fences markdown enforcement (PR #941)
  • 4112 tests added in integration suite — Comprehensive scenario coverage (#856, PR #961)

Guardrails & AST Detectors

  • Foundation hardening checks promotion — Elevate critical validations (PR #772)
  • AST weak assertion detector — Detect brittle isinstance checks (PR #773)
  • Docs-code contract checks for prefetch surfaces — Prevent doc-implementation drift (PR #774)
  • Traceback preservation guard — Maintain error context through exception chains (PR #775)
  • Review-regression audit framework — Track and prevent regressions across reviews (PR #792)
  • Security detector pack — Comprehensive security pattern detection (PR #793)
  • Correctness detector pack — Logic and type safety checks (PR #794)
  • Test-quality detector pack — Test robustness and assertion patterns (PR #795)
  • Memory-lifecycle AST detector pack — Detect resource leaks and improper cleanup (#803, PR #810)
  • #813 PR-1 API compatibility contracts (A + D) — Backward compatibility validation (PR #827)
  • #813 PR-2 degraded runtime + fallback integrity contracts — Graceful degradation paths (PR #830)
  • #813 PR-3 runtime truth contracts — Correctness under failure modes (PR #831)
  • #813 PR-4 schema and test-proof guardrails — Data shape contracts (PR #832)
  • Replace string matching with AST call nodes in S1/S2 guardrail — Robust pattern detection (PR #928)
  • Harden search S1/S2 AST matching and add memory-lifecycle guardrails — Enhanced validation (PR #929)
  • MECE-harden correctness, memory-lifecycle, and security guardrails — Comprehensive, non-overlapping checks (PR #935)
  • T10 predicate negative-case guardrail and backfill — Cover assertion negations (#930, PR #939)
  • Promote T10 predicate negative-case check to pre-commit — Catch violations early (PR #942)

Protocol & Type Contracts

  • Tighten Protocol contracts — Positional-only parameters, no-ambiguous-None, typed kwargs, registry clones (PR #807)
  • Modern type annotations (UP045) — PEP 646 TypeVarTuple, PEP 692 TypedDict unpack (PR #899)

Test Infrastructure

  • AsyncClient, CliRunner, and FakeTextModel fixtures — Reusable testing infrastructure (PR #954)
  • Replace isinstance assertions in tracked test files — Use specific type checks (PR #925)
  • Broaden isinstance guardrail to full test suite — Comprehensive type safety (PR #926)
  • Parametrize TestDisplaySummary — Reduce test duplication (PR #965)
  • Move private helper tests to unit module — Improve test organization (PR #966)
  • Eliminate time.sleep and vacuous bounds — Remove flaky sleeps; use events (#900, PR #907)
  • Guard 8 test files against optional-dep failures — Graceful missing-dependency handling (#918, #919, PR #921)
  • Add branch-coverage tests for 4 low-coverage modules — Targeted coverage (#866, PR #947)
  • Add cli + models tests; ratchet coverage floor 45% → 50% — CLI and provider coverage (PR #957)
  • PR2 api+web integration tests — API and web layer validation (PR #958)
  • Web+plugins coverage — Extension point validation (PR #960)
  • Add 211 tests for methodologies, events, parallel — Concurrent execution paths (PR #963)

Dependency Management

  • Remove stale [dependency-groups] — Consolidate uv dependency specification (PR #956)
  • Bump multiple Action versions — Keep GitHub Actions current (PR #871–#876, #971–#975)
  • Bump cargo/npm dependencies — Security and feature updates (PR #923, #932, #978, #979)
  • Update pytest-timeout requirement — Fix Windows test infrastructure (#976)

Pre-commit & Validation

  • Canonicalize pre-pr validation flow — Standardized pre-submission checks (PR #788)
  • Lock canonical pre-pr commands — Prevent drift in validation gates (PR #790)
  • Phase 4 pre-commit hooks — Threshold drift and search corpus safety (PR #927)
  • Fix warnings import, add fallback failure guard, add sync comment — Robust CI error handling (PR #944)

Documentation & Planning

  • Full-repo audit artifact + reconciled backlog — Comprehensive issue triage (#782, PR #796)
  • Legacy review applicability review — Assess historic findings (#791, PR #791)
  • Issue #783 security remediation verification — Hardened CI security checks (PR #797)
  • Issue #784 correctness remediation verification — CI contract enforcement (PR #798)
  • Issue #785 test-quality findings remediation — Zero low-quality test patterns (PR #799)
  • Issue #787 first-wave closeout guardrails — Finalize epic validation (PR #800)
  • Reconcile provider/CI closeout and codify 7-stream MECE plan — Organize parallel work streams (PR #837)
  • Remove historical planning docs and dependent CI tests — Clean up pre-v2 artifacts (#908, PR #909)
  • Document [llama] optional dependency — Add llama.cpp to dependencies.md (PR #839)

Documentation

Guides & Onboarding

  • AI Provider Setup Guide — Configure OpenAI-compatible, llama.cpp, MLX, Claude (PR #997)
  • Root Troubleshooting Guide Expansion — Common issues and resolution paths (PR #995)
  • Real-World Plugin Development Example — Walk-through of plugin architecture (PR #998)
  • Audio Transcriber Test Coverage Verification — Audio pipeline validation (PR #999)
  • GLM-OCR Evaluation Deferral — Document postponed decision (PR #1001)
  • Skipped Tests for Alpha.3 Documentation — Explain test skip rationale (PR #1002)
  • Search API Documentation Expansion — Detailed search endpoint docs (PR #1004)
  • Audio and Video Enablement Guide — Configure multimedia support (PR #1007)
  • Guided Optional Dependency Installer (fo doctor) — Interactive dependency setup (PR #1008)
  • Guided Setup Wizard & Onboarding Experience — First-run configuration flow (PR #1009)
  • Create Feature-to-Install Matrix for Optional Dependencies — Dependency availability map (PR #994)

Issue Closures

  • Close Testing Umbrella Issue #611 — Comprehensive test coverage complete (PR #1005)
  • Verify Release Pipeline and Tag Alpha.3 — Release validation (PR #1013)

Known Limitations & Deferrals

  • GLM-OCR evaluation deferred — Decision postponed pending further evaluation (PR #1001)

Statistics

Category Count Notes
Features 13 Provider ecosystem, search, memory mgmt, rules
Fixes 27 Core logic, security, dependencies, cross-platform
Infrastructure 57 CI/CD, coverage, guardrails, test infrastructure
Documentation 13 Guides, setup, API docs, troubleshooting
Dependency Updates 20+ Action versions, cargo, npm, Python packages
Total PRs 130+ v2.0.0-alpha.2 → v2.0.0-alpha.3
Integration Tests Added 4,100+ Branch coverage ratcheting
New AI Providers 4 OpenAI-compat, llama.cpp, MLX, Claude

Migration & Upgrade Notes

Breaking Changes

None documented. Alpha 3 maintains API compatibility with alpha.2.

Optional Dependency Changes

  • New optional [llama] group for llama.cpp provider
  • MLX provider optional support
  • Search features require optional embedding dependencies

Configuration Updates

  • Provider factory now handles all model vendors via plugin registry
  • Runtime controls persist to user settings file

Testing

  • Windows CI no longer uses -n=auto due to KeyboardInterrupt issues
  • Optional dependency tests now gracefully skip if dependencies unavailable

Contributors

This release includes contributions from the core team and the Dependabot automation service.

Next Steps

  • Alpha.4 roadmap — Continued search refinement, provider hardening
  • Beta planning — Performance optimization, production deployment patterns
  • Community feedback — Encourage early testing and issue reporting

Download: [Releases Page](https://github.com/curdriceaurora/Local-File-Organizer/releases/tag/v2.0.0-alpha.3)

What's Changed

New Contributors

Full Changelog: v2.0.0-alpha.2...v2.0.0-alpha.3

Contributors

curdriceaurora and dependabot
Assets 4
Loading