Commit graph

2 commits

Author SHA1 Message Date
jedarden
3155510a5e feat(pdftract-4q8cq): implement 14 environment checks for pdftract doctor
Implemented all 14 environment checks as specified in the bead description:
- pdftract binary: version + git-sha + compiled features
- tesseract install: version check (major >= 5 OK, == 4 WARN, <= 3 FAIL)
- tesseract languages: eng + requested langs present
- leptonica install: pkg-config check >= 1.79
- libtiff: pkg-config check with ldconfig fallback
- libopenjp2: pkg-config check with ldconfig fallback
- pdfium native lib: runtime detection >= 6555
- network reachability: HEAD example.com 5s timeout
- cache directory: writable + 1 GiB free + layout version
- profile search path: YAML parse + PROFILE_SECRETS_FORBIDDEN
- ulimit -n: getrlimit check >= 1024
- available RAM: /proc/meminfo or sysctl
- system locale: UTF-8 check
- temp dir writable: TMPDIR + 100 MiB free

All checks feature-gated appropriately. Panic-safe via run_check_safe().
CLI output layer integrated with --json and --features flags.

Acceptance criteria:
-  Unit tests for OK/WARN/FAIL paths in each check
-  Runtime < 6s (network: 5s, others: <100ms)
-  Panic catching via catch_unwind
-  Feature-gated checks return NotApplicable
-  pkg-config fallback to ldconfig
-  Profile secret detection with PROFILE_SECRETS_FORBIDDEN

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-05-23 07:05:49 -04:00
jedarden
8abf01cea3 feat(pdftract-4q8cq): implement 14 environment checks for pdftract doctor
Implement all 14 environment checks for the `pdftract doctor` subcommand.
Each check returns a CheckResult with status (OK/WARN/FAIL/NotApplicable)
and a human-readable detail message.

Checks implemented:
- pdftract binary (version, git SHA, compiled features)
- tesseract install (version check: >=5 OK, ==4 WARN, <=3 FAIL)
- tesseract languages (eng + requested langs present)
- leptonica install (>=1.79 OK, older WARN, not found FAIL)
- libtiff (pkg-config check with ldconfig fallback)
- libopenjp2 (pkg-config check with ldconfig fallback)
- pdfium native lib (version >=6555 OK, older WARN, not found FAIL)
- network reachability (HEAD example.com with 5s timeout)
- cache directory (writable, free space >=1 GiB, layout version)
- profile search path (YAML parse, PROFILE_SECRETS_FORBIDDEN detection)
- ulimit -n (>=1024 OK, 512-1024 WARN, <512 FAIL)
- available RAM (>=256 MiB OK, 128-256 WARN, <128 FAIL)
- system locale (UTF-8 OK, non-UTF-8 WARN, unset FAIL)
- temp dir writable (writable + free space >=100 MiB)

Core module with Check trait, CheckResult, CheckStatus, DoctorCtx,
DoctorFeatures, and panic-safe run_check_safe wrapper.

Build script injects GIT_SHA and COMPILED_FEATURES at compile time.

All checks feature-gated appropriately (ocr, full-render, remote, profiles).

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-05-23 06:47:07 -04:00