Commit graph

6 commits

Author SHA1 Message Date
jedarden
dfc94f33d5 chore(bf-2yhak): relocate useful generators to tools/
Relocate convert_to_scanned.sh from tests/fixtures/scanned/ to tools/
with comprehensive documentation header. Delete incomplete
regenerate.sh stub from tests/fixtures/grep-corpus/. Create
tools/README.md cataloging all 18 generators with usage examples.

Changes:
- Move: tests/fixtures/scanned/convert_to_scanned.sh → tools/convert_pdf_to_scanned.sh
- Delete: tests/fixtures/grep-corpus/regenerate.sh (incomplete stub)
- Create: tools/README.md (comprehensive generator catalog)
- Enhance: convert_pdf_to_scanned.sh with detailed documentation

Closes bf-2yhak
2026-07-05 20:17:04 -04:00
jedarden
b970bc2d66 feat(bf-2f5ew): add Tier 4 competitive benchmark runner and results structure
- Create benches/results/.gitkeep and README.md
- Create benches/competitors/run_all.py Python orchestration script
- Script runs competitor benchmarks (pdftract, pdfminer.six, pypdf, pdfplumber)
- Emits benches/results/<commit-sha>.json with throughput metrics
- Add tier4-competitor-runner to pdftract-ci Argo WorkflowTemplate
- Runs only on main branch to track performance over time
- Acceptance criteria: ratio_pdfminer ≥ 10.0, ratio_pypdf ≥ 5.0

Closes bf-2f5ew

Files created:
- benches/results/.gitkeep
- benches/results/README.md
- benches/competitors/run_all.py
- notes/bf-2f5ew.md

Files modified:
- .ci/argo-workflows/pdftract-ci.yaml
2026-07-05 12:42:15 -04:00
jedarden
9bac0f3009 feat(bf-2kre2): add validate-corpus Makefile target and verify complete workflow
- Add validate-corpus target to Makefile (calls scripts/validate-corpus.sh)
- Regenerate corpus manifest with 1000 synthetic PDF entries
- Validate corpus integrity: 1000 files, 10,590 pages, ~6.9 MB
- Update tests/fixtures/grep-corpus/README.md with complete workflow documentation
- Document Makefile targets (validate-corpus, download-grep-corpus)
- Add manual usage instructions for advanced users
- Verify complete end-to-end workflow: generation → manifest → validation

Acceptance criteria:
- ✓ make validate-corpus runs successfully
- ✓ Manifest contains 1000 entries with all required fields
- ✓ Validation confirms corpus meets size/count targets
- ✓ README.md documents workflow
- ✓ All child beads' outputs integrated

Closes bf-2kre2
2026-07-05 12:39:04 -04:00
jedarden
9a8252e92d feat(bf-20fot): extend download script to generate manifest entries
- download-grep-corpus.sh now generates manifest.csv entries during download
- Implements SHA256 checksum computation via sha256sum
- Extracts page counts using pdfinfo
- Captures file sizes in bytes via stat
- Records source URLs for each downloaded file
- Appends entries to manifest.csv with all 6 required fields
- Handles incremental downloads (skips existing files, appends to manifest)
- Added grep-corpus-generate-manifest.sh helper for bootstrapping existing corpus
- Generated manifest entries for all 1,260 existing PDFs
- Verified checksum accuracy against actual files

Acceptance criteria:
-  download-grep-corpus.sh writes manifest.csv entries for each downloaded PDF
-  All 6 fields populated: filename, source_url, page_count, file_size, checksum, license
-  Script handles incremental downloads (appends to existing manifest)

Closes bf-20fot

Verification: notes/bf-20fot.md
2026-07-05 12:26:55 -04:00
jedarden
a0c3ebb237 feat(bf-5for4): design manifest schema for grep-corpus
- Add manifest.csv with header row: filename,source_url,page_count,file_size,checksum,license
- Update README.md with comprehensive schema documentation and field descriptions
- Schema supports provenance tracking, integrity verification, and license compliance

Closes bf-5for4
2026-07-05 12:21:25 -04:00
jedarden
bae41cc771 feat(pdftract-5bzpg): implement pdftract-grep-1000 CI benchmark skeleton
Add Cargo bench target for grep performance measurement across 1000-PDF corpus.
Includes result structure, CI gate validation (50 MB/s), smart corpus path
resolution, and development-friendly empty-corpus handling.

Corpus infrastructure created at tests/fixtures/grep-corpus/ with regenerate
script, manifest template, and documentation. Benchmark ready to wire to
actual grep implementation once 7.8.3-7.8.8 sub-tasks complete.

Closes: pdftract-5bzpg

Files:
- crates/pdftract-cli/Cargo.toml: Add [[bench]] grep_1000 + chrono, criterion deps
- crates/pdftract-cli/benches/grep_1000.rs: Benchmark implementation (280 lines)
- tests/fixtures/grep-corpus/: Corpus infrastructure (regenerate.sh, manifest, README)
- notes/pdftract-5bzpg.md: Verification note with acceptance criteria status

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-25 08:53:23 -04:00