SPB Git

Repository Public

FEATURE_PARITY.md 13.8 KB 132 lines markdown

1<!-- Author: Simon-Pierre Boucher — contact@spboucher.ai · File: docs/FEATURE_PARITY.md -->2# Feature parity — web app 6.0 "VQuant Next" ↔ VQuant for macOS 2.0.034Classes: **native** (done on the Mac), **server-backed** (native interface, the server does the work), **kit** (built on5the shared package VQuantKit, same code as iOS), **not ported**, **does not exist** (on the server).67Evidence — one or more per line, never more than what was really done:8**T** integration test of this repository against the real test backend (M2U64:5058) ·9**U** XCUITest that clicks through it (passed on the merged tree, see TEST_REPORT) ·10**S** seen in a window capture of the running app on 5058 ·11**L** exercised live from the running app (a real run on 5058) ·12**unit** unit test of the logic ·13**—** written, not exercised.14"Touch ID" is never claimed: Debug builds cannot use system passkeys and nobody was at the sensor.1516## Research (the centre) — CONTRACT §2, §91718| Web 6.0 | macOS 2.0.0 | Class | Evidence |19|---|---|---|---|20| Chat with the agent, modes fast / standard / deep / ultra | Research composer, same modes | server-backed | L (fast), U (open a stored conversation); deep and ultra not run for 2.0 |21| Research mode (autonomous study in a sandboxed workspace) | Research mode, offered only when the sandbox route answers | kit + native | L (one study: generation `b6a72f8d…`, Sonnet 5.5, $0.318), S |22| Model picker from the registry, provider logos, "Auto", routing reason | Same, registry-driven; 1.x static list only as a stated fallback | kit | S, L (`auto` → `model_routed` line with reason); choosing by click: U failed in the engineer's run, then passed on the merged tree (see TEST_REPORT) |23| Budgets (cost, minutes) | Budget popover, defaults from `preference.budget` | server-backed | L (cap 3 USD sent); a `budget` event was never observed |24| Dataset attachment → inspection | Drop or file importer → workspace → multipart upload → inspection card | kit + native | T (201, 415 with the server's sentence), L, S; the drop gesture itself — |25| Usage and cost line, per-model breakdown | Usage line under each answer; "not priced" when the server has no price | kit | L, S |26| Research cockpit: activity, code, experiments, figures, files, environment | Inspector tabs Activity · Code · Experiments · Figures · Files · Environment (kit views) | kit + native | L, S (all six tabs on the live study and on a recorded one), U (tabs clicked) |27| Quality gate, figure linter verdicts | Shown in Activity and Figures | kit | L, S |28| Approvals (open network, send data, raise budget) | Banner + sheet + background notification routed to the conversation | kit + native | S with a recorded event only. No approval occurred in the live study: answering from the Mac and the notification are **not verified** |29| Research sessions list, resume on another device | "Studies" scope; reopen rebuilds from REST; attach to a running stream | kit | U (Studies scope, row click), S (study reopened by REST); attaching to a study running elsewhere — |30| Workspace files | Tree, paged text, Quick Look, drag-out to Finder, Save As, Inspect | native | S (tree and preview); Quick Look, drag-out, Save As — |31| Runs (background programs), logs, cancel | Environment tab | kit | — (no background run occurred) |32| Provenance of an answer, trace of a generation | Provenance popover, trace sheet | kit | L, S, U (trace sheet opened by click) |33| Replay after a dropped connection, Stop | Unchanged 1.x runner | server-backed | unit (replay, reconnection); Stop and mid-stream join were T in 1.0.1 and were **not re-run** for 2.0 (they need a second model call beyond the allowance) |34| History: search, rename, pin, delete; PDF / Word / slides export; share | Unchanged | server-backed | code carried over; not re-exercised for 2.0 |35| Image attachment | Unchanged | server-backed | — |36| LaTeX in reports | Formulas made readable and set in mono (kit) / TeX source (1.x renderer) | **gap** | no native TeX engine without a dependency |37| Voice dictation | — | not ported | the server has no speech key |3839## Terminal — CONTRACT §34041| Web 6.0 | macOS 2.0.0 | Class | Evidence |42|---|---|---|---|43| Market overview (sections, yield curve, calendar) | Overview: session badge (never "live"), indices, Treasury curve vs previous, rates, volatility, FX, commodities, crypto, sectors, movers, calendar; freshness chip or "Unavailable + reason" per section | kit + native | S (light, dark), U (an index opens in Charting) |44| Watchlists (synced) | Synced `watchlist` objects: create / rename / delete, add, multi-select (click, ⌘, ⇧), drag-reorder, drag a ticker out, v2 quotes with chips | kit + native | U (selection, create, delete, add, remove), S; drag-reorder: see TEST_REPORT |45| Universal search / palette | ⌘K palette: `/api/v2/search` + local commands, keyboard navigation | kit + native | S, U (see TEST_REPORT for the keyboard path) |46| Statements (compare, common-size, formulas) | Five tabs, annual / quarterly, period compare, common size, formula inspector, TSV copy, CSV export | kit + native | U (tab, common size, inspector, compare), S; CSV export and copy — |47| Charts | Native Core Graphics chart on `/api/v2/data/bars` with provenance; candles / OHLC / line / area, volume, SMA / EMA / Bollinger / RSI / MACD, log scale, comparison, crosshair, pan / zoom, linked and detached windows, PNG / PDF / CSV | native | T (`^GSPC`), S; exports written by the same code through a debug argument (PNG and CSV opened); gestures, log scale, linked crosshair not re-checked by hand |48| Drawing tools | Trend, horizontal, ray, rectangle, Fibonacci, note, measure; anchored to time + price; undo / redo | native | S (all kinds rendered), unit (geometry), U (horizontal line by click, undo); drag-created shapes and handles: see TEST_REPORT |49| Chart layout sync | One `chart` object per symbol, id `sym-<SYMBOL>` as the web derives it; unknown keys kept; live from another device | kit + native | T (raw GET / PUT round trips), S (remote edit appears) |50| Ask the agent about the visible range | Builds the question with symbol, interval, exact visible dates, indicators, drawn levels; lands in the composer, never sends | native | unit (text), U (lands in Research) |51| Markets (indices, movers, exchange hours), Data Explorer (15 datasets) | Unchanged from 1.0.1 | server-backed | U (sidebar navigation, dataset list click); content not re-inspected for 2.0 |5253## Quant Lab — CONTRACT §45455| Web 6.0 | macOS 2.0.0 | Class | Evidence |56|---|---|---|---|57| Catalogue of 19 tools by category | Catalogue with search, categories, versions, unavailable engines | kit + native | T (19), S, U |58| Forms generated from the tool spec | Every param type, groups, help, bounds, conditional fields (`visibleWhen` / `requiredWhen`), JSON editors with row editor | kit + native | S, U (fill and run) |59| Jobs with progress and cancel | Progress, cancel (three outcomes explained), limit of 3 explained, hint-driven refresh | kit | T (lifecycle, cancel lab and legacy, failures), U (progress and cancel) |60| `lab/1` results (one renderer) | Kit `LabResultView`; the six legacy tools keep their 1.x views | kit / native | S (volatility, risk, regression, portfolio, options, backtest, legacy GARCH) |61| Compare two results | Side by side: parameters that differ, metric deltas, charts | native | S, U (see TEST_REPORT) |62| Options: pricer, strategy builder, chain | Modes shaping one engine call; hero for price / Greeks and payoff; chain slices | native | S |63| Backtest: walk-forward, sensitivity, integrity warnings | Slices; look-ahead and survivorship statements always pinned above the result ("not reported / not checked" when the engine says nothing) | native | S, T (lifecycle) |64| Add to project | Appends `{type: quant_job}` to a synced project | kit | — (see TEST_REPORT) |65| Review ("Request review") | Sheet always labelled "Automated review — not a human peer review" | kit | S (an existing review object). Starting a review calls a model: **never started from the Mac** |66| Exports | PDF / PNG / CSV / JSON / Python through the save panel | native | — |6768## Portfolios — CONTRACT §1.4, §3, §46970| Web 6.0 | macOS 2.0.0 | Class | Evidence |71|---|---|---|---|72| Multiple portfolios, `main` = the agent's | List with `main` first (badge AGENT), create / rename / duplicate / delete (never `main`) | kit + native | U, S |73| Positions and cash editor | In-place table, cash by currency, base currency, benchmark, undo | native | U (add, edit, ⌘Z, remove), S |74| CSV import with preview | Column mapping, flagged rows, merge or replace | native | unit (11 tests), S (sheet through a debug argument); file importer and drop — |75| Valuation | `/api/v2/data/quotes` in batches of 60; grouped by currency, never summed across currencies; missing symbols stated | native | T (batching), S |76| Analysis | `portfolio_lab` and `risk_lab` runs rendered by the kit | kit | S, U (tabs) |77| Rebalancing | Shown as "Proposal — not an order. VQuant cannot place orders."; "Apply to a Copy" | native | S; the copy action — |78| Risk Analytics (1.0.1) | Unchanged, reads the bridged `main` | native | U (navigation); not exercised with positions (`main` is empty on the test copy) |7980## Research Studio — CONTRACT §5, §68182| Web 6.0 | macOS 2.0.0 | Class | Evidence |83|---|---|---|---|84| Projects: question, hypotheses, sources, summary | Editorial project page edited in place | kit + native | U (create, open, delete), S |85| Items from the bundle route | Resolved / unresolved items, open in place, add existing, remove, reorder | kit | T (bundle), S; drag-reorder — |86| Run research in the project | Composer hands the question to Research with `projectId` (never sends by itself) | native | S (hand-off); a project-filed run was **not** started (model call) |87| Notes: markdown editor, versions | `NSTextView` source + live preview, ⌘B / ⌘I, autosave through sync, versions with restore | native + kit | U (new note, typing, preview), T (versions, restore), unit (editing) |88| Reviews | Listed with checks and verdict, always labelled automated | kit | S |89| Exports PDF / MD / LaTeX / ZIP | Export sheet → native save panel; `compiled: false` stated | server-backed | T (all four formats); the save panel — |90| Project memory | Add, edit, pin, expiry, delete | server-backed | T (routes), S |9192## One account, synced — CONTRACT §19394| Web 6.0 | macOS 2.0.0 | Class | Evidence |95|---|---|---|---|96| Object store + change feed + stream | `VQSyncEngine`, replica sealed with the cache key, started at sign-in, erased at sign-out | kit | S (toolbar "Synced"), L (edits from another client appear), kit tests (51 sync tests) |97| Conflict policy | Lists element-wise, fields last-writer-wins per field, workspace whole-object; notices with keep mine / theirs | kit | kit tests; the notice UI was not seen with a real conflict |98| Migration of local data | 1.x watchlists and mappable layouts moved once, nothing deleted | native | unit (5 tests of the rule against the kit's fake server; the app's own function is not unit-testable and was **not run on a Mac holding 1.x data**) |99| Preferences | Synced except theme (per device) | kit | U (routing strategy written and read back — see TEST_REPORT) |100| Offline edits queue | Durable queue, replayed in order | kit | kit tests; not exercised with the network physically off |101102## Mac citizenship103104| Item | Class | Evidence |105|---|---|---|106| Multiple windows with per-window state; detached charts | native | U (⌘N, section per window); restoration after relaunch: see TEST_REPORT |107| Saved layouts → synced `workspace` objects (local when they do not map) | native + kit | unit (mapping both ways, web conventions); menus: see TEST_REPORT |108| Menus with shortcuts for every destination, Research and Lab menus, collision-checked table | native | U, unit |109| Settings: 20 panes (models and routing with live preview, budgets, memory, usage and cost, audit log, data providers, sync, research sandbox, plus the 1.0.1 panes) | native + kit | S (all panes, light and dark), U (panes by click) |110| Notifications: job finished, analysis finished, approval needed; click routed to the window | native | U (the router, through a debug argument); a real system notification was **not** delivered and clicked |111| Menu-bar extra: session, indices, running work, quick ask | native | S (preview window); the real status item: see TEST_REPORT |112| Keychain token, Touch ID app lock, device and passkey management with reauth-gated revocation | native (unchanged) | T (API: enrol by link, sign-in, second device, revocation, sign-out — software authenticator); Touch ID ceremonies **not verified** |113| Offline reading from the encrypted cache (now also overview, lab results, research workspace) | native | unit (1.x rules); 2.0 additions seen only through a simulated-offline flag (overview) |114115## Not ported / does not exist116117| Item | Finding |118|---|---|119| Web workspace canvas (free arrangement of panels inside one window) | Not ported: the Mac arranges windows; a web-made workspace opens as windows on the nearest sections |120| `POST /api/v2/projects/:id/run` | Not used: the project composer goes through Research |121| Admin console, documentation pages | Not ported (unchanged from 1.0.1) |122| WebSocket / real-time feed, trading, orders | Do not exist on the server; nothing is called "live", no order can be placed |123| Metal chart renderer | Evaluated, not adopted — numbers in `docs/CHART_PERFORMANCE.md` |124125## Known gaps of 2.0.0126127- Keyboard arrow navigation exists in the watchlist table and the palette only; other lists select on click128  (`List(selection:)` still does not select on macOS 27).129- Numbers follow the account's synced number format (fr-CA on the owner's account) while labels are English.130- LaTeX is not typeset. No dictation. No admin console.131- Instruments was not run; measurements come from the app's own benchmark harness, `ps` and wall clock.132
Files main
Menu

Theme