SPB Git

Repository Public

MIGRATION_PLAN.md 3.8 KB

# 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

  1. Keyboard navigation in lists (own key handling, or the system selection once it works on macOS 27).
  2. 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.
  3. A streaming quote feed, if the data plan allows — then, and only then, a "live" state in Freshness.
  4. LaTeX rendering; dictation once the server has a speech key.
  5. 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.

Files main
Menu

Theme