SPB Git

Repository Public

PROGRESS.md 5.6 KB

# 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 AVAudioFile wrote its final header (explicit close() added).
  • A cancelled export left an AVAssetWriter side 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)

  1. Record a real 10-minute lecture on the Mac with the notarized app (dist/SPLectureStudio-1.0.0.dmg) and watch the export.
  2. Install the TestFlight build on a real iPad with Apple Pencil and a real iPhone; run acceptance tests 1–3 for 10 minutes each.
  3. Try the camera, on-device transcription (install the language model in System Settings) and the lock-screen / phone-call cases.
  4. Decide whether to publish the Mac DMG and whether to keep ITSAppUsesNonExemptEncryption = false.
Files main
Menu

Theme