| status | active | ||
|---|---|---|---|
| owner | backend-and-platform | ||
| reviewed | 2026-11-21 | ||
| summary | Current resume checkpoint; config/roadmap.json owns open work, config/roadmap-archive.json holds finished work, and older narrative lives in git history. | ||
| sourceOfTruth |
|
Start here, then follow config/roadmap.json's primaryPlan and the
release-first execution plan.
This is a narrative, not a second work ledger. Product source, contracts and scripts win.
Older checkpoints live in git history (git log -p -- docs/development-progress.md): commit
3eeed981 holds October 26 through November 15, 20533a12 holds October 23 to 25, and
a0597deb every checkpoint before them.
November 21, late night: c0750fe7 pushed & native CI green; CI lint/test fix landed; roadmap retargeted to 3.2.0 (RF-68..RF-71)
Local main (4f273cb4..c0750fe7) was pushed to origin/main at the maintainer's request, both
triggered workflows completed, the small lint/test regressions were fixed locally (65436f01), and
the roadmap was updated per the maintainer's 2026-11-21 decision.
- Push CI & Release Rehearsal on
c0750fe7:- All native Xcode jobs PASSED on GA
xcode-27:macOS deterministic tests(12m09s, incl. Main Thread Checker, CLI identity, macOS XCUITest compile),iOS compile check (device SDK)(11m39s, incl.VocelloiOS, policy tests, and all 3 iOS XCUITest bundles),macOS ThreadSanitizer subset(10m04s), andRehearse iOS archive prerequisites(2m55s). - Fixed locally in
65436f01(DW-04): cleared 5 unused imports flagged by pinnedruff 0.17.1(check_ios_ui_benchmark.py,check_ios_ui_perf.py,check_macos_ui_perf.py) and updatedtest_ios_ui_preflight.py(signing-identity stub +ROOT_DIR/lane/no_publish) andtest_required_step_ledger.py(ui-buildinui-ios-control-auditoptionalSteps), which were the sole failures inRepository contracts,Python tests (linux)(3/2,749), andRehearse macOS package(3/3,161). Verified locally withruff(0 findings PASS) and routedscripts/dev.sh check(108/108 passed).
- All native Xcode jobs PASSED on GA
- 2026-11-21 Roadmap Decision (
config/roadmap.json,docs/ROADMAP.md,AGENTS.md,release-first-execution-2026-09.md):- No more 3.1 TestFlight builds and no iOS 3.1 release (Mac & CLI 3.1.0 shipped Nov 17 under
RF-61; internal 3.1.0 builds 31–33 are historical/superseded). - 3.2.0 is the new target for the iOS App Store submission (
v3.2.0-ios.Ncandidates). - Pack B & Pack C pulled ahead of 3.2:
RF-68: Engine Pack B (part 1) — sample-preserving MLX/Metal safety, memory (A-08,A-27) & hot-loop performance.RF-69: Engine Pack B (part 2) — sample-preserving runtime, Mac/CLIEngineHostLease, Fast QC & delivery hardening.RF-70(blocked byRF-68): Engine Pack C —RF-57-screened quality upgrades (zero-weight KoreanD1, Bundle A+24.12 MB, Bundle B+99.62 MB).RF-71(blocked byRF-68,RF-69,RF-70): Ship Vocello and thevocelloCLI 3.2 on the Mac.
RF-12,RF-15,RF-16,RF-17,RF-62,RF-63retargeted to3.2.0(RF-12,RF-16,RF-17blocked byRF-68,RF-69,RF-70);RF-35,RF-41,RF-42moved back toplannedbehindRF-12(0 staleness warnings; all 3 focus-lockin-flightslots free forRF-68..RF-70).
- No more 3.1 TestFlight builds and no iOS 3.1 release (Mac & CLI 3.1.0 shipped Nov 17 under
- Docs, instructions &
AGENTS.mdreconciled (2026-11-21): syncedAGENTS.md,ARCHITECTURE.md,native-engineering.md,tooling-and-evidence.md,development-workflow.md,ios-device-testing.md,telemetry-and-benchmarking.md,hybrid-model.md,ios-appstore-submission.md,app-store-listing.md, and.agents/plugins/vocello/skills/*with the 15-target / 8-scheme project (VocelloiOSPolicies, warnings-as-errors onVocelloiOSUITests&VocelloiOSCandidateUITests), Wave 5 calibrated iOSui-perfenforcement (12 scenarios, 7 enforced), wired-USBxctraceMetal/CPU/witness profiling,RB-11hybrid attribution rendering, and the 3.2.0 iOS submission target. - Next (next session):
- Confirm push CI & Release rehearsal green on the pushed 2026-11-21 tip.
- Begin Pack B (
RF-68&RF-69, sample-preserving, Mac-driven) in parallel or sequence, then run Pack C (RF-70,RF-57-screened KoreanD1, Bundle A, Bundle B) before bumping to3.2.0for Mac/CLI (RF-71) and cuttingv3.2.0-ios.1(RF-12).
November 21, night: Wave 5 physical-iPhone 3.1.0 calibration & qualification complete (c0750fe7, pushed)
Physical-iPhone Wave 5 completed on the paired iPhone 17 Pro (iOS 27.2.1, Xcode 27.2, wired USB
- clean checkpoints) and was pushed to
origin/mainatc0750fe7.
- Wave 5 On-Device Evidence & Calibrations:
ios benchmark(3.1 hybrid, 29/29 PASS, 0 refusals):ios-xcui-benchmark-20261121-180730-f1e8631c(5cc8ed43; 10 Custom + 10 Design + 9 Clone withA_warm_elderly_woman; 4 named screenshots verified clean).ios_device.sh memory(3.1 hybrid, 9/9 PASS, 0 MB retained growth) + calibration:ios-memory-qualification-20261121-182637-c2b75046(5cc8ed43) calibratedconfig/memory-qualification-policy.json(retainedMemoryV2.calibration.iosgrowthLimitMB = 16.0,floorTiersfloorMS = 500.0). WarmphysFoot: Custom1969 MB, Design1949 MB, Clone2503 MB(cold peak3584 MB,2560 MBheadroom remaining — confirms Pack ARB-054.5 GiBClone gate).- Wired-USB
xctraceprofiling baselines +axiom_xcprof_analyzevalidation:metal(ios-metal-profile-20261122-004303-62fc2244,1a10801d):23.3 tok/swarm,1952 MB physFoot, 142,990 captured Metal/signpost/Time Profiler rows (fixedbenchmarks/schema-v3.jsonprofileKindenum +scripts/benchmark_history.pyembeddedtime-profileacceptance + unit test).cpu --keep-trace(ios-cpu-profile-20261122-010506-af2fc0e1,9fcfb630):24.4 tok/swarm (1.95×RT),1987 MB physFoot, validated end-to-end withaxiom_xcprof_analyze+ preserved iOS dSYM (17,997symbolicated CPU samples; noted non-shippedIOSPullableDiagnosticsMirror.syncGenerationTelemetryat ~75% of diagnostics-runner CPU).witness(ios-witness-profile-20261122-010852-a0085eed,43371913):25.7 tok/swarm (2.06×RT),377 msfirst chunk,1975 MB physFoot.memory(ios-memory-profile-20261122-010716-e232a884&011044-6468584f): captured Allocations + VM Tracker.tracecleanly over USB; publication tripped the newly tightened uninstrumented500 msfloorTiersunobserved-gap bound (669.4 ms/789.9 msunder malloc-stack instrumentation during cold load; traces retained, policy kept strict).
- 3× counted snapshot-free
ios perf+AV-14closed (bc350530):ios-xcui-perf-20261121-200255-00f49267,ios-xcui-perf-20261122-012923-b890c982, andios-xcui-perf-20261122-014227-2dc60e89all passed 12/12 with 100% probe coverage; derivedspread-v1ceilings and enabled confirmatory enforcement inconfig/ui-perf-thresholds-ios.json, closingAV-14(18/18test_check_ios_ui_perf.pyPASS). - Pack A model delivery & RF-59 upgrade proofs live on device:
ios model-download --scenario queue(ios-xcui-model-download-20261121-201559-ff88637e): PASS (108.8s) —RB-06,RB-08,RB-10,RB-12(prepare cancel +Queuedrelaunch restoration; screenshots reviewed clean).ios model-download --scenario upgrade(ios-xcui-model-download-20261122-012545-cdcd6211): PASS (91.5s) — normal Update prompt +Laterrelaunch persistence + low-space Make Room prompt + active transfer (10.9 MB/s) + clean cancel (fixedrootTab_studiorelaunch wait at8eb44950; screenshots reviewed clean).
- Full
ios smoke(ios-xcui-smoke-20261122-030658-6da29045): 4/4 PASS (15 min):testPhysicalDeviceSmokeJourney(518.8s, including critical memory-pressure recovery and visually verifiedRB-11hybridAdditional base/Built fromattribution in010-ios-settings-model-attribution-pro_custom-speed.png),testRecordThenPlayReviewsTheClip(34.0s),testStudioModesKeepTheirDockLayout(46.3s),testZLongFormProjectJourney(290.7s, 2:17 project complete). - Headless
lang-bench --subset full(ios-lang-bench-20261122-011722-250a84c4): 23/23spoken_content=PASS,hint_gate=PASS,diagnostics_fail=0across all 10 languages on bothqwen3-asrandwhisper(nearly all0.000WER/CER); on-device Apple Speechoutput_gatepassed all 12 installed locales (en-CA,fr-CA,de-DE,zh-CN) and flagged only the 6 locales without iOS dictation packs installed (es,ja,ru,pt,it,ko). ios localization(ios-xcui-localization-20261122-021927-fcb2d313) + harness fixes: Passed all 10 languages, Default, French-Default, AX-L (incl. Voice Models), and AX-XXXL Audio/About; fixed the final AX-XXXLVocelloUISettingsRevealshort-drag stall and cached per-step staticText frames (31a71e40,12a76ed3,2ecf5ceb,9b68d928). An optional fullios localizationre-run can confirm AX-XXXL Voice Models green in the next window.
- Outcome: Pushed at
c0750fe7(see entry above); superseded for TestFlight by the 2026-11-21 decision targeting3.2.0.
November 21: iOS dev/test/bench overhaul (Waves 1–4) & Pack A release blockers (RB-01..RB-12) landed locally
Six commits landed on local main ahead of origin/main (4f273cb4; not yet pushed), bringing
iOS development, profiling, UI-perf testing, and policy modularization to parity with macOS and
resolving all twelve sample-preserving Pack A Release Blockers (RB-01..RB-12) ahead of the
physical-iPhone 3.1.0 calibration and qualification window (Wave 5). Packs B/C remain deferred
post-3.1 behind RF-57.
- iOS Dev/Test/Bench Overhaul — Waves 1–4 (
c43f825f,4783d725,553d4e4a,deca64ee,DW-03/DW-04/RF-59, Waves 2–4Reviewed-by: vocello-swift-review):- Wave 1 (
c43f825f): aligned owned-only-Ononedev vs-Omeasured iOS build lanes, enabledSWIFT_TREAT_WARNINGS_AS_ERRORS: YESonVocelloiOSUITestsandVocelloiOSCandidateUITests, and hardened CI parity. - Wave 2 (
4783d725): brought iOS profiling,Metal System Trace(os_signpost), app-layer memory sampling, and benchmark history contracts to macOS parity. - Wave 3 (
553d4e4a): overhauledVocelloiOSPerfUITeststo snapshot-free parity, wiredui_test.shhitch/stall gates and visual QA, and aligned iOSui-perflineage contracts. - Wave 4 (
deca64ee): extracted static frameworkVocelloiOSPolicies(linked only byVocelloiOSand iOS/core test bundles, zero link on macOS/CLI), added hermetic RF-59 upgrade and attribution XCUITests, burned iOS Python pyright findings to 0, and upgradedscripts/dev.shiOS ergonomics.
- Wave 1 (
- Engine & Hybrid Delivery Pack A — Commit A1 (
1d8397f6,RF-35/RF-59,Reviewed-by: vocello-swift-review): resolvedRB-01..RB-05— MLX async readback safety, deterministicprewarmSlotwaiting (prewarm_slot_wait_ms),MLXModelLoadCoordinatorload-state consistency,BG-01background-transition generation guard +inFlightPreparationDepth, andIOSMemoryBudgetPolicy.minimumCloneCapableProcessLimitBytes()(4,779 MiB). - Engine & Hybrid Delivery Pack A — Commit A2 (
f269200d,RF-59,Reviewed-by: vocello-swift-review): resolvedRB-06..RB-12+runQueueScenarioassertions —RB-06: relaunch.queuedsnapshot publication, synchronous coordinator state checks, andIOSModelDownloadLedger.isCurrentArtifactFailed(modelID:artifactVersion:)so 3.0 → 3.1 superseded ledger entries never suppress the RF-59 Update prompt.RB-07:SharedStorageBackgroundActivity(ProcessInfo.performExpiringActivity),StorageBackgroundExpirationFlagpropagation across everyIOSBackgroundTime.holdApp Groupflock(LOCK_EX)site, dedicated non-cancellationbackgroundAssertionUnavailable, and expiration checks before post-tombstone reclamation.RB-08: pureIOSBackgroundSessionCompletionCoordinatorinVocelloiOSPoliciesplus exact-oncelogicalRequestID-scopedHuggingFaceDownloaderbackground task submission flushing (closing Race A wake-before-restore, Race BbeginDownload→runDownload/Model 1→2 handoffs, dead-task retries, and >6-file rollovers).RB-09: immediate unreferenced shared-blob reclamation onreleaseUpdatePins(off-actor on macOS, serialized viapinReleaseTaskon iOS) + 24 h abandoned-pin fallback sweep.RB-10:.preparing/.startingcancellation targets,admissionSettlementWaitersteardown sync before deletion, and pre-existing ledger tombstoning before discarding staging.RB-11: extractedIOSAttributionManifestintoVocelloiOSPoliciesand rendered hybridadditionalBasesandbuiltFromprovenance inOpenSourceLicensesScreen.RB-12: subtracted verified shared-component bytes from Make Room space estimates, added typedModelUpdateFailureClassifiable(ENOSPC/EDQUOT/Carbon-34), gated Make Room consent onafterMakingRoom == .startUpdate, and addedrunQueueScenarioRB-06/RB-10 XCUITest checks.
- Verification on
f269200d:scripts/dev.sh lintPASS (35 paths privacy scan, pyright 0 new, strict SwiftLint 0 warnings/errors), 39/39 contract validators PASS, 44 Python tests PASS,./scripts/macos_test.sh testPASS (VocelloCoreTests+Qwen3RuntimeTests),scripts/dev.sh iosPASS (VocelloiOS+ iOS executable scan +VocelloiOSLogicTests),scripts/dev.sh ios --uiPASS (all 3 iOS XCUITest bundles),scripts/dev.sh buildPASS (Vocello.app), and./scripts/build.sh cli --versionPASS (vocello 3.1.0). - Next: push these local
maincommits when explicitly requested, watch push CI onxcode-27, and then execute Wave 5 in a single announced physical-iPhone window (iPhone Mirroring quit,QVOICE_LEAD_ONLY=1): 3× iOSui-perfcalibrations + threshold calibration,model-management(queue/relaunch + upgrade Make Room),profile --kind metal, and the iOS 3.1.0 candidate qualification/TestFlight tag (v3.1.0-ios.4).
Phases A, B and C of the Antigravity harness & engineering-velocity upgrade landed on local main
(ahead of origin/main 670f7e77; not yet pushed), closing five authorized backlog items
(BKL-63, BKL-74, BKL-79, BKL-87, BKL-90) with zero audio-sample changes and zero
product-binary regressions.
- Phase A — Harness safety, CI blind spots & workflow kit (
0e207be0..f5b1879f, closesBKL-63,BKL-74,BKL-87,BKL-90): fixed Sparkle incrementalCodeSignrace + macOS/iOS build-log mirroring (live macOS smokemacos-xcui-smoke-20261120-202030-03d22d24and perfmacos-xcui-perf-20261120-223253-e83975d812/12 PASS); upgraded irreversible external/destructive commands & MCP writes to uncacheable"force_ask"withPostInvocationdrift reminders, non-loopingStopwhitespace guard, in-processagent_guardand Antigravity worktree leases; gatedios_control_audit.py validateincontract_gate.py; fixednightly.ymlandrelease-rehearsal.ymlreporttriggers (always() && !cancelled()); added.agents/workflows/(swift_adversarial_review.py,xcuitest_visual_qa.py,debt_burndown_pipeline.py,qc_experiment_synthesizer.py). - Phase B — Lint burndown, Swift 6 hardening, security & perf harness (
f466500e..81b0dbf8,aa97fb2e, closesBKL-79):- Burned Ruff
44 → 0(f466500e) and Pyright789 → 81across 72 Python files via two 3-worker parallelshare-worktree waves (08c70744,aa97fb2e; 0# type: ignore; 3,149 pytest passed). - Hardened
Packages/VocelloQwen3Core(cc305197,Reviewed-by: vocello-swift-review):swift-tools-version: 6.2,.treatAllWarnings(as: .error)on 4/5 targets (MLXAudioTTSdocumented as waiting on upstreammlx-swiftMLXArray: Sendable), SwiftLint expanded toPackages/VocelloQwen3Core/(0/0) +no_if_debugrule, pure-Swift parameterized Swift Testing suite (Qwen3PropertyInvariantTests, 9@Testsuites); audited all 164try?sites inSources/(zero silent data-loss sites). - Hardened
HuggingFaceDownloader(1251fcc4,Reviewed-by: vocello-swift-review, closesBKL-79) to fail closed when any planned/installed file lacks a valid 64-hex SHA-256 or disagrees betweenfilesandinstalledFiles, with zero-request/zero-staging tests. - Eliminated XCUITest accessibility snapshot walks in
test05DeliveryMenu()(81b0dbf8,BKL-77) using window-anchored coordinate clicks + keyboard, exposedactionHitchTimeMSPerS/queryHitchTimeMSPerS, bumped("ui-perf", "macos")lineage to v3 (e073bbb8), ran 3 clean canonical calibrations (8f412666,8b059da3,b6cfbcce:[59.446, 55.426, 53.901]ms/s, median55.426vs84.168), recalibratedconfig/ui-perf-thresholds.json(72.5 ms/s,130 ms), addeddelivery-menutoenforce, and closedBKL-77(4974d4e9).
- Burned Ruff
- Phase C — Metal profiling,
VocelloSharedPoliciesmodularization, Xcode 27.2 CI cutover & playbook (2aea00c9,91f5eae6): addedmacos_test.sh profile --kind metal(Metal System Trace+os_signpost) across trace retention and benchmark history contracts; extracted pure multiplatform static frameworkVocelloSharedPolicies(91f5eae6,Reviewed-by: vocello-swift-review) compiling 7 runtime/Studio/ownership/retry policy files once instead of 4–5x across 5 targets (macOS, iOS, CLI and all 3 UI test bundles verified green; push CI44853701944green); cut overconfig/toolchain.json(Xcode 27.2/Swift 6.4.2) and all 6 macOS GitHub workflows (ci.yml,nightly.yml,promote-release.yml,release-rehearsal.yml,release.yml,security.yml) frommacos-26to GAxcode-27(DW-04, matching localXcode 27.2build27B52); documented the Repeatable Innovation Playbook indocs/reference/development-workflow.md. - Next: push the
BKL-77calibration +DW-04Xcode 27.2 cutover commits when requested, observe the firstxcode-27push CI run, and resume iOS 3.1.0 candidate work (RF-12/RF-15/RF-35–RF-42) in the next iPhone window.
The repository-owned agent harness moved from Claude Code (.claude/, CLAUDE.md,
website/CLAUDE.md) to Antigravity (AGENTS.md, website/AGENTS.md, .agents/hooks.json,
.agents/plugins/vocello/ and scripts/hooks/agy_hook_adapter.py) under RF-67, with zero Swift
or product-binary changes. Pushed through 670f7e77 with CI green (44831811307). main stays on
the iOS 3.1.0 TestFlight candidate track (v3.1.0-ios.3, focusLock active; RF-35, RF-41,
RF-42 remain in flight awaiting an iPhone window).
- Live verification (2026-11-20): Antigravity loaded
AGENTS.md, all sixvocello-*skills and both read-only subagents (vocello-swift-review,vocello-xcresult-triage). LivePreToolUseprobes deniedgit push --force --dry-run origin main,edit_fileondocs/ROADMAP.md,mobilebuildmcp:list_simsandcua-driver_cua-driver:list_apps, while allowinggit status --short --branchandmobilebuildmcp:list_schemes.RF-67is closed.
The maintainer uploaded the promotion manifest to the v3.1.0 draft and dispatched Promote verified
release from the tag (run 44036811898, approved on the release environment). Every step passed,
and at 07:17 UTC the release went public as the latest: 13 assets, and releases/latest's
appcast.xml now resolves to v3.1.0, so Sparkle offers it. Two stray drafts that a release-edit
link had created on the phone were deleted first. main was pushed through f99b5c33 with CI and
the release rehearsal green.
The post-promotion refresh is committed on local main (ac173582): the six promotion records,
and the README chart, performance art and website pooled over the two build-31 records through
0b6bc26b (0.29 to 0.41 warm RTF).
The published, notarized 3.1.0 CLI then passed cli_package.py qualify on this Mac: Built-in
English, French Voice Design and Clone (a Vocello-generated reference) each with a strict QC pass
and EOS, the two-item batch, cancellation (exit 130, cleanup acknowledged, no output) and the error
exits. Its report stays untracked under build/artifacts/macos/release. RF-61 is closed. The 3.1
website is live; its pooled performance numbers deploy with the next push of main.
At the maintainer's request (work for a follow-up release, Mac-only, no lanes on the screen), the
roadmap gained a needs tag (mac, keyboard, iphone) on every open item and the first wave of
Mac-only backlog fixes landed on main with tests; the routed check, the full macOS deterministic
suite, the CLI, the iPhone compiles and the UI-test bundles pass.
- Closed: BKL-18, 20, 21, 22, 24, 25, 26, 32, 37, 46, 47, 48, 58, 64, 66, 70 and 73; DA-14; RF-64, superseded by RF-63 (iPhone Settings already has a Help & Support row).
- Engine-remediation parts done: B-02 (BKL-73), B-12 (
_exitin the CLI's forced exit), C-13 (the QC observer above 102.4 kHz) and BKL-01 (control-token-only scripts have nothing to speak). - Fixed, waiting on a run: BKL-33 and BKL-19 on the next macOS smoke, BKL-28 on the marketing lane, BKL-23 on a production Mac language bench, BKL-50 on the next Linux CI run, BKL-60 on the phone.