Repository Public
1<!-- Author: Simon-Pierre Boucher — contact@spboucher.ai · File: docs/MIGRATION_PLAN.md -->2# Migration plan and status34| Phase | Planned | Status (2026-11-18) |5|---|---|---|6| 1 Discovery | Read the repository, list routes, auth, engines, streams | Done. Findings in MACOS_ARCHITECTURE (no Pyrus, no WebSocket, no trading). |7| 2 Foundation | SwiftPM core, XcodeGen app, windows, navigation, DI, settings | Done. |8| 3 Authentication | Native passkeys on the same accounts | Done: backend bridge v5.8.0 in production; sign-in verified by the owner. |9| 4 Core platform | Markets, charts, watchlists, data explorer | Done. |10| 5 Computation and research | Quant Engine jobs; research agent with live runs | Done (the "Pyrus" phase maps to the Python engine). |11| 6 Remaining features | Portfolio, risk, agent workspace, jobs, documents | Done. Not ported: dictation, admin console, LaTeX rendering. |12| 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). |13| 8 Release | Sign, notarize, staple, package | Done: 1.0.1 (2), Developer ID, notarized (Apple: Accepted), stapled app and DMG, installed. |1415## Backend changes made for the migration (repository `vquant.git`, commit `9cfea72`, v5.8.0, additive)1617`server/native.ts` (bridge + AASA), `server/routes/quant.ts` (computation jobs, table `vq_quant_jobs`),18`/api/fmp/search`, three lines in `server/access.ts` (accept a device token, open the AASA path) and two in19`server/routes.ts`. New tables are created at start. No existing route or table was changed; the web app is20unaffected. The iOS client (`~/Desktop/Cluster/apple/VQuant-iOS`, another session) uses the same bridge and the21same App ID.2223## What would come next24251. Keyboard navigation in lists (own key handling, or the system selection once it works on macOS 27).262. Server: persist analysis jobs across restarts; a cancel path for Python engines; a batch quote route (one request27 per refresh instead of one per symbol); offsets for datasets.283. A streaming quote feed, if the data plan allows — then, and only then, a "live" state in `Freshness`.294. LaTeX rendering; dictation once the server has a speech key.305. Instruments passes (Time Profiler on chart interaction, Allocations on long runs) and an automatic update channel.3132## 2.0.0 "VQuant Next" (2026-11-20) — status3334| Step | Status |35|---|---|36| Shared package VQuantKit adopted (`../VQuantKit`: `VQuantKit`, `VQuantUI`), header `vquant-macos/2.0.0` | Done |37| 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 |38| Research: mode, datasets, registry and routing, budgets, cockpit, approvals, studies, trace | Done; approvals not exercised from the Mac |39| Terminal: overview, synced watchlists, command palette, statements | Done |40| Charting: v2 bars, drawings in the synced chart object, ask about the visible range, Metal evaluation | Done; Core Graphics kept |41| Quant Lab: 19 engines, generated forms, progress and cancel, compare, review, options and backtest layouts | Done; a review was never started from the Mac |42| Portfolios and Research Studio | Done |43| Mac citizenship: menus, 20 Settings panes, synced layouts, notification routing, menu-bar extra | Done; real status item and delivered notification not verified |44| 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 |4546Work was done on the local branch `next` (feature branches `next-*` merged into it); nothing was pushed or tagged.47The backend this version needs is backend 6 (branch `next` of `vquant.git`, test copy on M2U64:5058); it is additive,48so 1.0.1 keeps working against it.49