Releases: whoisjayd/notewise
Releases · whoisjayd/notewise
v1.4.3
Full Changelog: v1.4.2...v1.4.3
v1.4.2
Patch release focused on hardening the next-release branch after v1.4.1. This release improves setup wizard failure handling, YouTube transcript/metadata reuse, pipeline caching/concurrency behavior, configuration safety, generated document sanitization, and release/test infrastructure.
Highlights
- Safer setup wizard flow when the LiteLLM model catalog is empty or unavailable.
- More robust YouTube processing with reusable video detail payloads and transcript extraction helpers.
- Stricter transcript, export-format, and chapter-cache validation before expensive generation work starts.
- Safer CLI/config/provider error handling with redaction for sensitive payloads and clearer configuration failures.
- More complete regression coverage, including HTTP replay tests for YouTube caption and metadata fetching.
What's Changed
Setup wizard and provider catalog fixes
- Guard the setup wizard when the bundled or fetched model catalog has no usable models.
- Extract setup guard messages into reusable constants so tests and UI behavior stay aligned.
- Add retry-oriented messaging for catalog setup failures instead of letting users continue into invalid provider/model prompts.
- Use provider display names from the provider catalog in unsupported-model messages.
Pipeline, caching, and concurrency
- Add bounded video worker scheduling through
max_concurrent_videoswhile preserving cancellation propagation. - Add chapter output manifests and validate cached chapter directories against expected chapter files before reuse.
- Prevent failed chapter generation from emitting
CHAPTER_COMPLETEevents. - Reject empty or whitespace-only transcripts before LLM generation, cache writes, or filesystem output.
- Tighten transcript chunking so overlap rollover and hard-split paths respect the configured token budget.
- Optimize chapter transcript splitting with sorted chapters and cursor-based segment selection.
YouTube transcript and metadata handling
- Reuse full YouTube video detail payloads for transcript extraction instead of refetching or losing detail context.
- Add sync and async
transcript_from_video_datahelpers in the extractor clients. - Separate raw video detail fetching from stable
VideoMetadatamapping. - Normalize transcript export formats and reject unsupported transcript formats earlier.
CLI, configuration, and secrets safety
- Surface configuration validation errors as explicit CLI configuration failures.
- Prevent invalid
config.envvalues from leaking into the process environment for later loads. - Add shared provider/OAuth error summarization that redacts LLM payload details and terminal-unsafe content.
- Avoid API-key-shaped literals in OAuth tests.
Output and document safety
- Sanitize rendered Markdown HTML links by stripping unsafe
hrefschemes and control characters. - Preserve safe URLs and anchors while preventing unsafe link output.
- Ensure quiz and artifact output paths create required destination directories.
Storage and playlist inspection
- Add bulk cache lookup support with
get_cached_video_ids. - Use bulk cache lookup in playlist inspection to avoid per-video repository checks.
Tests and release infrastructure
- Add
pytest-vcrdevelopment dependency for replay-backed integration tests. - Add sanitized YouTube HTTP replay cassettes for caption and metadata fetching.
- Expand CLI, config, pipeline, storage, setup wizard, OAuth, Markdown rendering, LLM generation, and YouTube transcript coverage.
- Add release/version sync coverage for package, docs, website, and test metadata.
- Add agent workflow documentation for Beads, review-fix discipline, hook usage, and final verification expectations.
Pull Requests
- #117 —
fix(ui): guard setup wizard when model catalog is emptyby @qorexdevs - #122 —
feat(release): prepare for next releaseby @whoisjayd
New Contributors
- @qorexdevs made their first contribution in #117
Verification
- Version metadata aligned at
1.4.2. - Targeted updater tests passed.
- Full Python test suite passed before release tagging:
819 passed, 3 skipped. - Pre-commit hooks passed, including Python lint/type checks, Bandit, website lint/typecheck, version sync, docs JSON parse, and docs JavaScript syntax checks.
Full Changelog: v1.4.1...v1.4.2
v1.4.1
What's Changed
New
- Added a detailed Rich process dashboard for
notewise process, giving clearer live visibility into pipeline progress, batch work, skipped videos, generated outputs, and run status. - Added Vercel rewrite configuration so website/docs routes continue to resolve cleanly after the docs source layout was flattened.
- Added
docs/llms-full.txtalongside the existing LLM-facing docs metadata for better AI/tool consumption of the documentation.
Improved
- Flattened the Mintlify docs source layout from
docs/docs/...todocs/..., reducing path nesting and keeping docs routing easier to maintain. - Updated process documentation to describe the new Rich dashboard behavior.
- Improved dashboard rendering and display behavior across single-video and batch processing flows.
- Improved website/docs metadata and sitemap-related routing after the docs path restructure.
Fixed
- Fixed docs proxy routing so flattened docs paths resolve correctly.
- Fixed dashboard rendering for batch chapter titles by escaping title text before display.
- Fixed dashboard edge cases found during review, including skipped-video event handling and cross-platform path assertions.
Developer Notes
- Expanded test coverage around the dashboard wiring, display formatting, skipped events, and cross-platform path behavior.
- Updated internal docs and agent guidance to match the flattened docs layout.
Full Changelog
Source Evidence
Release range checked: v1.4.0..v1.4.1
Commits included:
8290c13 chore(release): v1.4.1
6b854db test(cli): make dashboard path assertions cross-platform
e8eebe0 fix(ui): resolve remaining dashboard review items
620eb71 fix(ui): address dashboard review findings
238ce42 fix(cli): escape batch chapter dashboard titles
771a499 test(cli): expect explicit skipped dashboard events
2ae45e3 docs(cli): describe Rich process dashboard
09f8ad8 feat(ui): add detailed Rich process dashboard
1a862ad fix: route docs proxy to flattened paths
5aa6ca6 docs: flatten mintlify source
f2cd2a2 feat: add vercel configuration for document rewrites
Diff summary: 157 files changed, 7027 insertions(+), 3569 deletions(-)
Commands used:
git tag --list "v1.4.*" --sort=version:refname
git --no-pager log --oneline v1.4.0..v1.4.1
git diff --stat v1.4.0..v1.4.1
git diff --name-status v1.4.0..v1.4.1v1.4.0
v1.3.1
Full Changelog: v1.3.0...v1.3.1
v1.3.0
What's Changed
- build(deps): bump litellm in the python-dependencies group by @whoisjayd in #81
- feat(pipeline): add multi-format note renderers by @whoisjayd in #82
- feat(cli): add throttle pacing by @whoisjayd in #83
- feat(cli): add target language for beginner-friendly notes by @whoisjayd in #84
- release: promote dev to main by @whoisjayd in #85
Full Changelog: v1.2.1...v1.3.0
v1.2.1
What's Changed
- feat(pipeline): stitch chunked notes by default by @whoisjayd in #69
- build(deps): bump the dependencies group across 1 directory with 2 updates by @dependabot[bot] in #70
- feat: sync with main by @whoisjayd in #76
- feat(cli): add timestamped chapter headers by @mikepatraw in #68
- release: merge dev into main by @whoisjayd in #79
New Contributors
- @mikepatraw made their first contribution in #68
Full Changelog: v1.1.2...v1.2.1
v1.1.2
Full Changelog: v1.1.0...v1.1.2
v1.1.0
What's Changed
- build(deps): bump codecov/codecov-action from 5 to 6 in the dependencies group by @dependabot[bot] in #63
- docs!: update docs layout,styling and structure by @whoisjayd in #64
Full Changelog: v1.0.0...v1.1.0
v1.0.0
Full Changelog: v0.2.7...v1.0.0