PROGRESS — SP Lecture Studio
Session of 2026-11-18. Every command below was actually run; results are quoted from its output.
Phase checklist
- Phase 0 — audit: Xcode 27.2 / Swift 6.4.2, SDKs macOS 27.2 and iOS 27.2, simulator runtime iOS 26.5, signing identities and
notary profile present, no pre-existing repository. Capability matrix and decisions in
docs/ARCHITECTURE.md. - Phase 1 — scaffold: monorepo, SwiftPM package with 8 targets, XcodeGen project with macOS and iOS targets, scripts, tests.
- Phase 2 — PDF and ink: import, view, navigate, search, zoom/pan; PencilKit ink on iPad/iPhone, mouse/tablet ink and shape tools on Mac; time-coded vector strokes saved and reloaded; undo/redo; annotated PDF.
- Phase 3 — recording: real microphone, page/ink/pointer/viewport events, pause/resume/stop, markers and retake, segmented media, atomic manifest checkpoints, interruptions, route changes, low-disk / thermal / battery warnings, crash recovery.
- Phase 4 — render: deterministic MP4 export (H.264, HEVC), synchronized audio, progress, cancellation, verification by decoding.
- Phase 5 — editing: nondestructive timeline, cut / split / ripple delete / trim / mute, undo/redo, long-silence and retake suggestions with before/after audition and approval, fades, crossfade, loudness normalization, cleanup, chapters.
- [~] Phase 6 — advanced: camera picture-in-picture (implemented, never run with a camera); transcription providers and captions (implemented, on-device recognition never run); optional remote transcription and tus upload (tested against stubs only); presentation window (implemented, untested on a second display). Not implemented: Mac screen/window capture, device-to-device sync UI (only the encrypted bundle and upload building blocks), transcript-based AI cut suggestions.
- [~] Phase 7 — release: macOS notarized; iOS uploaded to App Store Connect; French + English; accessibility labels on controls. Not done: VoiceOver pass, real-device stress (disk, battery, thermal).
Commands and results
| Command | Result |
|---|---|
scripts/build-all.sh |
OK Swift packages · OK macOS app (Debug) · OK iOS/iPadOS app (Debug, simulator) · OK iOS/iPadOS app (Release, device) |
swift test (via scripts/test-all.sh) |
Unit: 44 tests, 0 failures · Integration: 16 tests, 1 skipped (the long one), 0 failures |
LECTURE_LONG_TESTS=1 swift test --filter testNinetyMinuteSyncAndResources |
passed in 122 s — "90-min export: 99.3 s wall, 162000 frames (160606 reused), 27.5 MB file, peak RSS 600 MB, project 520 MB on disk" |
scripts/test-ui.sh iphone / ipad |
TEST SUCCEEDED — testAnnotateRecordEditExport (52 s / 56 s), testPreflightPoliciesAndSearchSheets (21 s / 20 s) |
App self-test, iPhone simulator (-LectureSelfTest YES) |
SELFTEST PASSED — microphone granted, 16.2 s in 2 segments, 1920x1080 avc1, ink 3/3 on time |
| App self-test, iPad simulator | SELFTEST PASSED — same, export in 2.8 s |
| App self-test, macOS | SELFTEST PASSED — microphone granted, 16.2 s in 2 segments (−32 dBFS), 1920x1080 avc1, ink on time (an earlier run, with the prompt unanswered, passed in PDF-only mode) |
swift test --filter testRealMicrophoneCaptureWhenPermitted |
passed — "device Micro MacBook Pro, 48000 Hz, 3.3 s in 4 segments" |
scripts/test-ui.sh mac |
TEST SUCCEEDED — testMacAnnotateNavigateAndExportPDF (17 s). While the Mac screen was locked it could not launch at all ("does not have a process ID") |
scripts/archive-macos.sh |
"Built dist/SP Lecture Studio.app version 1.0.0 (1) archs: x86_64 arm64", hardened runtime yes, sandbox yes |
scripts/notarize-macos.sh |
both submissions "Accepted"; "RESULT: notarized and stapled"; spctl "accepted, source=Notarized Developer ID" |
scripts/archive-ios.sh all |
"archive : 1.0.0 (1)", IPA 3.0 MB |
scripts/archive-ios.sh validate / upload |
"VERIFY SUCCEEDED with no errors" / "UPLOAD SUCCEEDED with no errors" |
scripts/localize.py --strict |
"503 keys, 503 translated to English, 0 missing" |
Bugs found by the tests and fixed
- Segment checksums were computed before
AVAudioFilewrote its final header (explicitclose()added). - A cancelled export left an
AVAssetWriterside file (exports now run in a scratch folder that is removed). - Silence detection took the noise floor at the 10th percentile and failed on lectures with little silence (now 3rd).
- The maximum-duration countdown restarted right after it had fired.
- Session state was read before the engine's asynchronous callback (zoom recorded right after "resume" was dropped).
- macOS: thumbnails stayed blank (lazy rows did not observe the session); an empty banner container sat above the canvas.
- iPhone: the PencilKit palette covered the navigation bar and floated over sheets; compact record bar and title were squeezed; the Export button and the exported files were below the fold.
Blockers and next actions (owner)
- Record a real 10-minute lecture on the Mac with the notarized app (
dist/SPLectureStudio-1.0.0.dmg) and watch the export. - Install the TestFlight build on a real iPad with Apple Pencil and a real iPhone; run acceptance tests 1–3 for 10 minutes each.
- Try the camera, on-device transcription (install the language model in System Settings) and the lock-screen / phone-call cases.
- Decide whether to publish the Mac DMG and whether to keep
ITSAppUsesNonExemptEncryption = false.