docs-puller v0.5.0

Added

• Compact human and JSON help projections so agents can discover the public verb surface without loading the full command reference.
• Batch search now preserves per-query intent, caller, run-context, source, and retrieval-mode telemetry using the same bounded local log as individual searches.
• Repeatable local make publish-ready, verification, help-size, and isolated smoke gates for contributors and release preparation.

Measured retrieval

Benchmark	Queries	Mode	Hit@1	Hit@5	MRR	Reproducible by you
Full fixture suite	258	HyDE + hybrid + LLM rerank	69.0%	92.2%	0.786	No — maintainer's private corpus mirror
Sample corpus	24	BM25 / FTS5 only	95.8%	100%	0.979	Yes — pinned public pages, no API key

Reproduce the sample corpus baseline in a few minutes with no account:

corpus="$(mktemp -d)"
docs-puller pull --from eval/sample-corpus/sources.md --out "$corpus"
docs-puller reindex --out "$corpus"
docs-puller eval --fixture eval/sample-corpus/fixture.yaml --out "$corpus" \
  --diff eval/sample-corpus/baseline-2026-07-03.json

Verification

make publish-ready · make help-sizes · make smoke · CI green

Full changelog: v0.4.0...v0.5.0

docs-puller v0.4.0

Search telemetry now records client and run-context provenance, separates real from synthetic traffic, and exports real dogfood fixtures by default. Embedding refreshes prune stale vectors, while source-scoped hybrid reranking filters embedding candidates before top-k selection. This release also opens one paid hosted Team design-partner intake while preserving the OSS/open-core boundary.

docs-puller v0.3.1

Patch release for current nship compatibility.

• Upgrades the launch contract to schema v2.
• Declares an explicit managed runtime for public installation.
• Marks release and distribution verification as credential-free read operations.

Code is unchanged from v0.3.0; build, vet, tests, and gitleaks remain green.

docs-puller v0.3.0

Blender corpus and retrieval release.

• Adds generic Git and reStructuredText ingestion with authoritative source replacement.
• Adds and hardens the 40-query Blender Manual retrieval fixture.
• Excludes reference-repository scaffold prose from retrieval.
• Keeps source-scoped FTS5 reads concurrent and safe.

Verified with build, vet, tests, race detector, staticcheck, gitleaks, VS Code compilation, and 100% Hit@1/3/5/10 with MRR 1.000 on the 2,222-page Blender 5.1 corpus.

docs-puller v0.2.3

Hardening patch: malformed embedded source-hygiene policy now degrades safely instead of panicking; unreachable helpers and current Go 1.26 staticcheck findings were cleared without changing retrieval scoring or CLI behavior. Build, vet, normal/race tests, current staticcheck, zero-critical/high Go footgun audit, and VS Code extension compile passed.

docs-puller v0.2.2

Patch release: top-level help now advertises the existing version --expect VERSION fail-closed release gate. Full Go build, vet, normal/race tests, and VS Code extension compile passed.

docs-puller v0.2.1

Public v0.2 release: stable version and capability contract, first-class llms.txt discovery, guarded authoritative replacement, unchanged-file telemetry, FTS self-healing, eval progress, and VS Code extension compile coverage. v0.2.1 fixes the nship verifier to validate the versioned public Go module directly instead of a potentially stale PATH binary.

docs-puller v0.1.0 — measured local documentation retrieval

docs-puller is a local-first documentation retrieval CLI for coding agents.
It mirrors vendor, GitHub, and local project documentation into Markdown,
indexes it with SQLite FTS5, and exposes both CLI search and a loopback-first
HTTP API.

The release includes a reproducible BM25 fixture containing 24 pinned public
documentation pages and 24 queries. Its frozen baseline is Hit@1 95.8%, Hit@5
100%, and MRR 0.979. The fixture can be replayed without an API key.

Install:

go install github.com/nstranquist/docs-puller@v0.1.0

The repository is Apache-2.0. The local CLI, eval harness, server, web UI, and
VS Code client are open source; a future hosted Team tier remains outside this
release.