Skip to content

Turn any technical book PDF into a Claude Code skill — ready to study, reference, and use while you work.

chore(release): v1.4.0

virgiliojr94387d938ec58e
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7150da9..31ba423 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,28 +5,67 @@ All notable changes to **book-to-skill** are documented here.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-> **Do not edit this file by hand.** From the next release on it is generated
-> from Conventional Commit messages by [git-cliff](https://github.com/orhun/git-cliff)
+> **Do not edit this file by hand.** It is generated from Conventional Commit
+> messages by [git-cliff](https://github.com/orhun/git-cliff)
> (`git-cliff --tag vX.Y.Z -o CHANGELOG.md`). Write a good PR title instead — it
> becomes the changelog entry. See `cliff.toml` and CONTRIBUTING.md.
-## [Unreleased]
+## [1.4.0] - 2026-08-10
+
+### Added
+- Warn on unknown CLI flags instead of silently ignoring (#89)
+- Make the site indexable and shareable
+- Add Booklin banner and hand-made share card
+- Apply pdftotext cleanup to pypdf and pdfminer paths too (#101)
+
+### Documentation
+- Sync architecture, skill spec, and README with v1.3.0
+- Reserve README project listings for sponsors
+- Add Booklin mascot to the README (#106)
+- Split README into pages and add Booklin mascot set (#110)
+- State that scanned PDFs need OCR first (#132)
### Fixed
-- **CJK-aware token estimate** — `estimate_tokens` now counts CJK codepoints
- directly (against `CJK_CHARS_PER_TOKEN`) instead of whitespace-delimited words,
- fixing a ~1000× undercount for space-less Chinese/Japanese books in the cost
- pre-flight. Latin behavior is unchanged and the estimate stays deterministic
- and dependency-free (rescued from #70).
-
-### Removed
-- **Stale tracked bytecode** — `scripts/__pycache__/extract.cpython-313.pyc` was committed
- alongside the EPUB-support change and has been tracked ever since, despite `.gitignore`
- listing both `*.pyc` and `__pycache__/` (ignore rules do not untrack already-committed
- files). The file was inert — its timestamp-based header records a 11,321-byte source while
- `scripts/extract.py` is now 871 bytes, so Python always invalidated it and recompiled — but
- committed bytecode is not reviewable in a diff. A regression test now fails if any `.pyc`
- or `__pycache__/` path is tracked.
+- Gate lowercase Roman behind heading context, add FP coverage (#88)
+- CJK-aware token estimate (rescued from #70) (#103)
+- Support documented help flags (#97)
+- Emit block boundaries at end tags in the stdlib parser (#107)
+- Skip control destination groups in the dependency-free fallback (#109)
+- Scrub bidirectional controls and remaining invisible code points (#108)
+- Write metadata.json as UTF-8 (#105)
+- Detect Markdown-prefixed chapter headings (#91) (#92)
+- Reserve the banner's space on the site build
+- Abort early on scanned PDFs with an OCR hint (#130)
+- Stop edge-of-page cleanup deleting real one-word lines (#119)
+- Expand `~` in input paths (#118)
+- Skip an unreadable source instead of aborting the batch (#120)
+- Detect a table of contents in any source, not just the first (#114)
+- Scan nested chapters and report markdown left out of scope (#115)
+- Detect whitespace-separated CJK ToC headers (#112)
+- Stop duplicating the PR number in generated entries (#131)
+
+### Miscellaneous
+- Untrack stale compiled bytecode (#94)
+- Generate CHANGELOG from commits with git-cliff (#104)
+
+### Notes on selected changes
+
+*Written by hand before this file became generated; kept for the detail the
+one-line entries above do not carry.*
+
+**CJK-aware token estimate** — `estimate_tokens` now counts CJK codepoints
+directly (against `CJK_CHARS_PER_TOKEN`) instead of whitespace-delimited words,
+fixing a ~1000× undercount for space-less Chinese/Japanese books in the cost
+pre-flight. Latin behavior is unchanged and the estimate stays deterministic
+and dependency-free (rescued from #70).
+
+**Stale tracked bytecode** — `scripts/__pycache__/extract.cpython-313.pyc` was committed
+alongside the EPUB-support change and has been tracked ever since, despite `.gitignore`
+listing both `*.pyc` and `__pycache__/` (ignore rules do not untrack already-committed
+files). The file was inert — its timestamp-based header records a 11,321-byte source while
+`scripts/extract.py` is now 871 bytes, so Python always invalidated it and recompiled — but
+committed bytecode is not reviewable in a diff. A regression test now fails if any `.pyc`
+or `__pycache__/` path is tracked.
## [1.3.0] - 2026-07-30
diff --git a/cliff.toml b/cliff.toml
index b0d5f2f..747f96c 100644
--- a/cliff.toml
+++ b/cliff.toml
@@ -17,8 +17,12 @@ All notable changes to **book-to-skill** are documented here.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-This file is generated from Conventional Commit messages by
-[git-cliff](https://github.com/orhun/git-cliff) — do not edit it by hand.
+
+> **Do not edit this file by hand.** It is generated from Conventional Commit
+> messages by [git-cliff](https://github.com/orhun/git-cliff)
+> (`git-cliff --tag vX.Y.Z -o CHANGELOG.md`). Write a good PR title instead — it
+> becomes the changelog entry. See `cliff.toml` and CONTRIBUTING.md.
+
"""
body = """
{% if version %}\
diff --git a/pyproject.toml b/pyproject.toml
index 4a2f928..4aacdd1 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "book-to-skill"
-version = "1.3.0"
+version = "1.4.0"
description = "Convert books and documents into structured, on-demand agent skills."
readme = "README.md"
requires-python = ">=3.9"