Skip to content

chore: periodic maintenance - update deps, docs, and add maintenance spec#15

Merged
chaliy merged 1 commit intomainfrom
claude/update-deps-docs-drgTr
Feb 12, 2026
Merged

chore: periodic maintenance - update deps, docs, and add maintenance spec#15
chaliy merged 1 commit intomainfrom
claude/update-deps-docs-drgTr

Conversation

@chaliy
Copy link
Contributor

@chaliy chaliy commented Feb 12, 2026

What

Periodic maintenance run covering dependency updates, documentation improvements, and a new maintenance specification.

Why

Keep the repo healthy with current dependencies, accurate documentation, and a defined process for recurring maintenance.

How

Dependency Updates

  • thiserror 1 → 2 (no code changes needed)
  • schemars 0.8 → 1.2.1 (no code changes needed)
  • pyo3 0.22 → 0.28 (added from_py_object attribute, removed obsolete clippy allow)
  • Minor/patch updates via cargo update (reqwest 0.13.2, clap 4.5.58, etc.)

Documentation Improvements

  • Added doc examples to all key public types: FetchRequest, FetchResponse, Tool, ToolBuilder, FetcherRegistry, FetchError, html_to_markdown, html_to_text, fetch()
  • Added crate-level quick-start examples in lib.rs
  • Added CLI usage docs to fetchkit-cli
  • Fixed README code snippets (builder pattern, correct method names, Python module name, response field types)
  • 12 doc tests now pass

Spec-Code Alignment

  • Verified specs/initial.md and specs/fetchers.md fully match code (100% compliance)
  • Fixed stale module doc comment (WebFetch → FetchKit in error.rs)

New Maintenance Spec

  • specs/maintenance.md defines 7-section periodic checklist: dependency updates, docs quality, spec-code alignment, example verification, CI health, security/license, changelog
  • Updated AGENTS.md to reference the new spec

Risk

  • Low
  • Major dep bumps (thiserror, schemars, pyo3) are well-tested; all 85 tests pass

Checklist

  • Unit tests are passed (44 unit + 25 integration + 4 CLI)
  • Doc tests are passed (12 doc tests)
  • Clippy clean (-D warnings)
  • Format clean (cargo fmt --check)
  • Documentation builds without warnings
  • Specs are up to date and not in conflict

https://claude.ai/code/session_01Cd9tmq3DoJ5dVFHZvkBGR3

…nce spec

- Update major deps: thiserror 1→2, schemars 0.8→1, pyo3 0.22→0.28
- Update minor/patch deps via cargo update
- Add doc examples to all key public types (FetchRequest, FetchResponse,
  Tool, ToolBuilder, FetcherRegistry, FetchError, html_to_markdown, etc.)
- Add crate-level doc examples with quick-start code
- Fix README code snippets (use builder pattern, correct method names,
  fix Python module import, fix response field types)
- Remove obsolete clippy::useless_conversion allow (fixed in pyo3 0.28)
- Fix pyo3 0.28 deprecation warnings (add from_py_object attribute)
- Fix stale module doc comment (WebFetch → FetchKit in error.rs)
- Add specs/maintenance.md defining periodic maintenance checklist
- Update AGENTS.md to reference maintenance spec
- Verified: specs/initial.md and specs/fetchers.md fully match code

https://claude.ai/code/session_01Cd9tmq3DoJ5dVFHZvkBGR3
@chaliy chaliy merged commit c2e7985 into main Feb 12, 2026
7 checks passed
@chaliy chaliy deleted the claude/update-deps-docs-drgTr branch February 12, 2026 04:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants