Migration plan and status
| Phase | Planned | Status (2026-11-18) |
|---|---|---|
| 1 Discovery | Read the repository, list routes, auth, engines, streams | Done. Findings in MACOS_ARCHITECTURE (no Pyrus, no WebSocket, no trading). |
| 2 Foundation | SwiftPM core, XcodeGen app, windows, navigation, DI, settings | Done. |
| 3 Authentication | Native passkeys on the same accounts | Done: backend bridge v5.8.0 in production; sign-in verified by the owner. |
| 4 Core platform | Markets, charts, watchlists, data explorer | Done. |
| 5 Computation and research | Quant Engine jobs; research agent with live runs | Done (the "Pyrus" phase maps to the Python engine). |
| 6 Remaining features | Portfolio, risk, agent workspace, jobs, documents | Done. Not ported: dictation, admin console, LaTeX rendering. |
| 7 Performance and security | Strict concurrency, authorisation tests, measurements | Swift 6 complete checking clean; authorisation boundaries tested; measurements by ps/timing only (no Instruments run). |
| 8 Release | Sign, notarize, staple, package | Done: 1.0.1 (2), Developer ID, notarized (Apple: Accepted), stapled app and DMG, installed. |
Backend changes made for the migration (repository vquant.git, commit 9cfea72, v5.8.0, additive)
server/native.ts (bridge + AASA), server/routes/quant.ts (computation jobs, table vq_quant_jobs),
/api/fmp/search, three lines in server/access.ts (accept a device token, open the AASA path) and two in
server/routes.ts. New tables are created at start. No existing route or table was changed; the web app is
unaffected. The iOS client (~/Desktop/Cluster/apple/VQuant-iOS, another session) uses the same bridge and the
same App ID.
What would come next
- Keyboard navigation in lists (own key handling, or the system selection once it works on macOS 27).
- Server: persist analysis jobs across restarts; a cancel path for Python engines; a batch quote route (one request per refresh instead of one per symbol); offsets for datasets.
- A streaming quote feed, if the data plan allows — then, and only then, a "live" state in
Freshness. - LaTeX rendering; dictation once the server has a speech key.
- Instruments passes (Time Profiler on chart interaction, Allocations on long runs) and an automatic update channel.
2.0.0 "VQuant Next" (2026-11-20) — status
| Step | Status |
|---|---|
Shared package VQuantKit adopted (../VQuantKit: VQuantKit, VQuantUI), header vquant-macos/2.0.0 |
Done |
| One account, synced (engine, sealed replica, migration of 1.x watchlists and layouts, preference bridge) | Done; the migration was not run on a Mac holding real 1.x data |
| Research: mode, datasets, registry and routing, budgets, cockpit, approvals, studies, trace | Done; approvals not exercised from the Mac |
| Terminal: overview, synced watchlists, command palette, statements | Done |
| Charting: v2 bars, drawings in the synced chart object, ask about the visible range, Metal evaluation | Done; Core Graphics kept |
| Quant Lab: 19 engines, generated forms, progress and cancel, compare, review, options and backtest layouts | Done; a review was never started from the Mac |
| Portfolios and Research Studio | Done |
| Mac citizenship: menus, 20 Settings panes, synced layouts, notification routing, menu-bar extra | Done; real status item and delivered notification not verified |
| Release | 2.0.0 (3) built and signed with the existing Developer ID identity and profile; notarized, installed and published on 2026-11-20 at the owner's request |
Work was done on the local branch next (feature branches next-* merged into it); nothing was pushed or tagged.
The backend this version needs is backend 6 (branch next of vquant.git, test copy on M2U64:5058); it is additive,
so 1.0.1 keeps working against it.