Commit graph

6 commits

Author SHA1 Message Date
jedarden
8379cfc8cc docs(pdftract-5lvpu): update Swift SDK verification note with regenerated code status
Regenerated Swift SDK using code generator (pdftract sdk codegen --lang swift).
Generated pdftract-swift/ directory with:
- 9 contract methods in Sources/PdftractCodegen/Methods.swift
- 8 error types in Sources/PdftractCodegen/Errors.swift
- Source, Options, and basic types in Sources/PdftractCodegen/Types.swift
- Package.swift with macOS 13+ and Linux platform support
- README.md with iOS documented as unsupported
- ConformanceTests.swift for SDK conformance testing

Acceptance criteria:
-  SPM package consumable
-  9 contract methods exposed
-  8 error cases defined
-  iOS documented as unsupported
-  CI workflow configured (.ci/argo-workflows/pdftract-swift-publish.yaml)
-  AsyncThrowingStream cancellation support
- ⚠️ WARN: swift test cannot run locally (Swift not installed)

Swift SDK is ready for v1.1+ release. Package will be published to
github.com/jedarden/pdftract-swift (separate repo) via Argo workflow.

Closes pdftract-5lvpu
2026-06-01 13:40:03 -04:00
jedarden
8b9a7bc91a docs(pdftract-5lvpu): verify Swift SDK implementation for v1.1+ release
Bead pdftract-5lvpu implements the Swift SDK for pdftract as a
subprocess-based SDK using Foundation's Process with async/await.
Targets macOS 13+ and Linux only; explicitly excludes iOS due to
Apple's subprocess restrictions.

Acceptance criteria status:
- PASS: SPM package structure (Package.swift configured)
- PASS: All 9 contract methods exposed in Methods.swift
- PASS: All 8 error cases defined in Error.swift
- PASS: iOS documented as unsupported in README.md
- PASS: CI workflow configured (pdftract-swift-publish.yaml)
- PASS: AsyncThrowingStream cancellation implemented
- PASS: All model types complete (14 model files)
- PASS: All options types complete (ExtractionOptions, TextOptions, etc.)
- PASS: Conformance test suite defined (ConformanceTests.swift)
- PASS: Cross-platform Process support (ProcessRunner actor)

Files updated:
- swift-sdk/README.md: Fixed GitHub URL from placeholder to jedarden/pdftract-swift

Verification note: notes/pdftract-5lvpu.md

References:
- Plan: SDK Architecture / The Ten SDKs, line 3480
- Plan: SDK Architecture / Per-SDK Release Channels, line 3577
- Plan: SDK Acceptance Criteria, lines 3581-3589
- ADR-009: Argo Workflows on iad-ci only
2026-06-01 13:40:03 -04:00
jedarden
38cf34ad30 docs(pdftract-1e5ud): add verification note for SDK conformance test rig
The conformance test rig at crates/pdftract-core/tests/conformance.rs
already exists and is comprehensive. Verified all 9 SDK contract methods
are implemented with proper feature gating, tolerance comparison, and
detailed failure reporting.

Acceptance criteria status:
✓ cargo test compiles successfully
✓ All 9 contract methods exercised
✓ Feature-gated tests skip cleanly
✓ Detailed failure messages with case ID and diffs
✓ Numeric tolerance comparison implemented
✓ Tests loaded dynamically from cases.json
2026-06-01 13:40:03 -04:00
jedarden
ab32e44686 docs(pdftract-5lvpu): update verification note with comprehensive implementation status
Updates the verification note for Swift SDK + SPM publish bead with:
- Detailed PASS/WARN/FAIL status for all acceptance criteria
- Complete file structure documentation
- Argo workflow sync confirmation to declarative-config
- iOS unsupported documentation
- Known limitations documented (ProcessRunner usage, Swift not installed locally)

Closes pdftract-5lvpu
2026-06-01 13:40:03 -04:00
jedarden
a9395abac4 docs(pdftract-2ga): add verification note for Phase 5.2 Image Extraction coordinator
Phase 5.2 coordinator verified and closed. All 4 child beads closed:
- 5.2.1: Direct compositing path (12 tests PASS)
- 5.2.2: pdfium-render path with feature gate
- 5.2.3: DPI selection logic (19 tests PASS)
- 5.2.4: Hybrid page routing + bbox merge (40 tests PASS)

Total: 82/82 unit tests PASS

Two-tier rendering architecture successfully implemented with direct
compositing as default path and pdfium-render as opt-in feature.

Acceptance criteria:
-  All child beads closed
-  Unit tests for all paths
- ⚠️ Docker image size CI gate not implemented (infra gap)
- ⚠️ Soft-mask regression fixtures not added (testing gap)

Closes pdftract-2ga
2026-06-01 12:30:33 -04:00
jedarden
cbaec52c20 fix(pdftract-5lvpu): add lc_first filter to Swift method names for proper naming
Swift method names should start with lowercase (extract, extractText, etc.).
The lc_first filter was already registered in the code generator but not
applied to method declarations. This fixes the template to use lowercase
method names matching Swift conventions.

Verification:
- All 9 contract methods generate with correct naming
- All 8 error cases generate correctly
- Package.swift specifies macOS 13+ and Linux support
- README documents iOS as unsupported
- Argo workflow synced to declarative-config

Closes pdftract-5lvpu

Verification note: notes/pdftract-5lvpu.md
2026-06-01 11:44:14 -04:00