rdmsm4x-changelog-20260827-1622-scanroo-prototype-milestone-resume

Finished and locally integrated ScanRoo's remaining reversible prototype milestone work so the project now has a tested capture-to-processing-to-persistence-to-export path instead of only scaffolded components.

Scope

• Host: rdmsm4x only.
• Canonical project: /Users/richh/dev/apps/scanRoo.
• Task branch/worktree: codex/scanroo-milestone-resume-20260827 at /Users/richh/dev/_worktrees/rscan.app/codex-scanroo-milestone-resume-20260827.
• Starting commit: 9bcfae9ab52a8406e8c5e8875c18fdbbabbc6be5.
• Integrated commit: 859148f50bb5fb0acb755dfa9fb7e4eef1b3437b.
• main was advanced locally by fast-forward only. No push, PR, release, signing, device install, deployment, CloudKit production operation, bundle-ID change, RDReceipt architecture decision, publication, or destructive cleanup occurred.

Project files changed

• .codex/environments/environment.toml
• Apps/Mac/MacCaptureView.swift
• Apps/Mac/RScanMacApp.swift
• Apps/Mobile/RScanMobileApp.swift
• Apps/Vision/RScanVisionApp.swift
• Design/IconComposer/Layers/background.svg
• Design/IconComposer/Layers/kangaroo.svg
• Design/IconComposer/Layers/magnifier.svg
• Design/IconComposer/Layers/papers.svg
• Design/IconComposer/README.md
• ISSUES.md
• PRD.md
• Packages/ScanRooKit/Sources/RScanPersistence/AssetFileStore.swift
• Packages/ScanRooKit/Sources/RScanProcessing/ImageRenditionGenerator.swift
• Packages/ScanRooKit/Sources/RScanProcessing/PageRectangleDetector.swift
• Packages/ScanRooKit/Sources/RScanProcessing/ScanRasterImageCodec.swift
• Packages/ScanRooKit/Sources/RScanUI/CaptureReviewModel.swift
• Packages/ScanRooKit/Sources/RScanUI/ScanDetailView.swift
• Packages/ScanRooKit/Sources/RScanUI/ScanExportService.swift
• Packages/ScanRooKit/Sources/RScanUI/ScanIngestionService.swift
• Packages/ScanRooKit/Sources/RScanUI/ScanRooAppModel.swift
• Packages/ScanRooKit/Sources/RScanUI/ScanRooRootView.swift
• Packages/ScanRooKit/Sources/RScanUI/ScanRooRuntime.swift
• Packages/ScanRooKit/Tests/RScanExportTests/SearchablePDFExporterTests.swift
• Packages/ScanRooKit/Tests/RScanProcessingTests/PageRectangleDetectorTests.swift
• Packages/ScanRooKit/Tests/RScanUITests/ScanIngestionServiceTests.swift
• Packages/ScanRooKit/Tests/RScanUITests/ScanRooAppModelTests.swift
• SESSION-STATE.md
• STATUS.md
• docs/validation/2026-08-27-scanroo-milestone-resume.md

Adjacent records changed

• /Users/richh/dev/PROJECTS.md
• /Users/richh/Library/Mobile Documents/com~apple~CloudDocs/Codex/projects/AGENTS.md principles/PROJECTS.md
• /Users/richh/.agent-coordination/checkins/codex-rdmsm4x-scanroo-milestone-resume-20260827.json
• This changelog file and its matching Apple Notes entry in the canonical iCloud llmlog folder, titled rdmsm4x - changelog - scanroo-prototype-milestone-resume - codex - 01a04089 - scanRoo - 20260827-1623.

Behavior delivered

• Added verified .preview and .export image renditions while keeping captured originals immutable.
• Added real pixel-derived classifier signals for whiteboard, marker, and photographic content.
• Added Vision page-rectangle detection and conditional perspective/illumination correction that refuses fabricated full-frame geometry.
• Added a SwiftData-backed export service and detail UI for searchable PDF, Markdown, text, HEIF, JPEG, and PNG artifacts.
• Added macOS captured-page thumbnails, ordered review, per-page removal, explicit Cancel and Save Scan actions, and an empty-save guard.
• Added the project-local Codex Run action for ./script/build_and_run.sh --verify.
• Added a deterministic editable SVG icon-source packet and immutable-raster hash manifest.

Commands and verification

• swift test --package-path Packages/ScanRooKit --parallel — passed repeatedly before commit and again after local integration: 58 tests, 15 suites, zero failures.
• xcodegen generate — passed with XcodeGen 2.46.0 and left no unintended generated-project diff.
• Fresh unsigned xcodebuild commands for RScanMac, RScanMobile, and RScanVision using isolated DerivedData — all returned exit 0.
• ./script/build_and_run.sh --verify — returned exit 0, reported BUILD SUCCEEDED, and launched the exact worktree binary as PID 97792.
• Exact-path accessibility/screenshot inspection — confirmed the current three-column library UI, empty-state guidance, filters, search, import/sync controls, and truthful no-camera state.
• Built Info.plist inspection — all products use app.scanroo.ScanRoo; macOS/iOS have point-of-use camera descriptions; visionOS has no camera purpose string.
• PDFKit/ImageIO reopen tests — two-page searchable PDF plus HEIF/JPEG/PNG dimension reopening passed.
• xmllint --noout Design/IconComposer/Layers/*.svg — passed.
• SHA-256 reproduction — every icon raster in Design/IconComposer/README.md matched its recorded hash.
• git diff --check and git diff --cached --check — passed.
• Gitleaks full-repository and staged scans with redaction — no leaks found.
• Canonical main post-merge status — clean at 859148f50bb5fb0acb755dfa9fb7e4eef1b3437b, nine commits ahead of unchanged origin/main.

Preservation and backup

• Task worktree and branch are retained at the paths above.
• The pre-integration RDReceipt-originated issue patch remains in stash@{0} at object ddc87522688d2b0e8e8c5a0e3e25977f1b227ec4.
• Recovery tip 47aff4e…, migration evidence, historical worktrees, and every original icon input were left unchanged.
• No ScanRoo process remains running after validation.

Undo

• Because main advanced by one local fast-forward commit and nothing was pushed, the non-destructive rollback reference is the preserved task branch plus parent commit 9bcfae9ab52a8406e8c5e8875c18fdbbabbc6be5.
• Do not reset or delete automatically. If rollback is desired, first preserve any later work, then create a new revert commit for 859148f50bb5fb0acb755dfa9fb7e4eef1b3437b or explicitly coordinate a local branch move.
• Restore the two PROJECTS entries from their previous Git/iCloud versions if the milestone commit is reverted.

Outstanding owner/human actions

• Accept Apple's first-run Icon Composer software-license agreement if desired, then import the four SVG layers and save/visually approve Design/IconComposer/ScanRoo.icon. The agent did not accept the agreement.
• Perform one real-paper capture on physical camera hardware and confirm it appears in the live library.
• Decide the canonical bundle identifier and whether RDReceipt consumes ScanRoo's ingestion layer.
• Separately authorize any production CloudKit, signing, notarization, TestFlight/App Store, push, publication, or distribution work.