SPB Git

Repository Public MIT

RELEASE-REPORT.md 20.2 KB

# ORIX Calc — release report

Version 1.0.0 (build 1)
Date 2026-11-20
Bundle ID ai.spboucher.orix.calc
Platforms iPhone, iPad — iOS / iPadOS 26.0 or later
Toolchain Xcode 27.2 (27B52), Swift 6.4.2, iOS 26.5 simulator runtime
State Feature-complete; all automated tests pass; build 1.0.0 (1) uploaded to TestFlight, processed, available to internal testers; repository public on git.spboucher.ai

Summary. The eight environments and the six signature features are implemented with real engines. 786 automated tests pass. On 2026-11-20 the owner authorised the TestFlight upload and the public repository: the App Store Connect record was created, build 1.0.0 (1) was uploaded and processed, and the repository was published on git.spboucher.ai. What remains is a pass on physical devices (none was connected during development) and the owner's App Store Connect entries (EU trader status, privacy-policy and support URLs) before any public release.


# 1. Implemented features

Area Implemented
Shell Adaptive iPhone / iPad shell, instant environment switching with state preserved, favourites, recents, configurable launch environment, ⌘1–⌘8, companion calculator on iPad, shared history and variables, settings, JSON backup export / import
Standard Arithmetic, percent (documented convention + strict mode), sign change, parentheses, memory, C / AC, backspace, undo / redo, copy, paste expression, live preview, history, reuse of results, notation and precision settings, locale separators
Scientific Powers, roots, logarithms, factorials, nPr, nCr, modulo, rounding, trigonometric / inverse / hyperbolic functions, three angle modes, complex numbers, vectors, matrices (determinant, inverse, rank, RREF, systems, eigenvalues), constants, user variables and functions, numerical differentiation and integration, RPN
Financial TVM (any variable, P/Y, C/Y, BGN/END), cash flows (NPV, IRR incl. multiple / none, MIRR, payback, PI), loans and mortgages (six payment frequencies, Canadian and US conventions, schedules, prepayments, rate changes, refinancing, affordability), bonds (price, YTM, YTC, accrued interest, durations, convexity, five day counts), investment analysis (11 calculators), options (BSM, Greeks, implied volatility, parity, binomial, strategies), sensitivity studio
Graph Explicit, parametric, polar, implicit curves, inequalities, scatter data; pan / zoom / reset / auto-fit; trace; roots, extrema, intersections, tangents, derivative curves, integrals, areas, arc length, tables; parameter sliders; 3D surfaces with orbit camera, contours, probe; PNG and CSV export
Math Solve, derivative, integral, limit, series, simplify / expand / factor, linear and nonlinear systems, optimisation, ODEs, matrices; typeset notation; result kinds
Statistics Data editor and descriptive statistics, 14 distributions, confidence intervals, hypothesis tests, ANOVA, simple / curve / multiple regression with diagnostics, Monte Carlo, scenarios, sampling distributions, bootstrap; 32 functions exported to the shared engine
Convert 331 units in 33 categories with exact factors, all-units view, rate conventions, manual and ECB currency rates with source and timestamp
Workspace Formula cells, live parameters, tables, graph cells, notes, templates, dependency graph with cycle detection, incremental recalculation, undo / redo, auto-save, exports (PDF, CSV, text, Markdown, LaTeX, PNG, .orixcalc), import with corruption recovery
Signature Live Variables, Explain, Verified Results, Classic Modes (algebraic, RPN, financial keypad, scientific keypad, graphing keyboard), Quick Actions, Math Camera (Beta)
Apple integration SwiftUI, SwiftData, Swift Charts, Accelerate, Vision, App Intents (Calculate, Open Environment), Share Sheet, Files (.orixcalc document type, importer / exporter), hardware keyboard, haptics, Dynamic Type, VoiceOver labels, Dark Mode

# 2. Verification status

"Tested" means covered by automated tests that pass. "Seen" means I looked at the screen in the running app in the simulator. "Not exercised" means the code exists and compiles but the interaction itself was never performed.

Item Tested Seen in the running app Notes
Expression engine (parser, exact arithmetic, complex, matrices, formatting, RPN) yes yes
Standard and Scientific keypads yes (model + XCUITest) yes (iPhone, iPad, light, dark) Hardware keyboard not exercised
Financial: engine yes —
Financial: screens view-model tests TVM, bonds (iPhone, iPad) Other sections rendered off-screen by their builder only
Graph: engine yes, incl. discontinuity proofs —
Graph: screens model + pixel tests 2D (iPhone), 3D (iPad) Gestures never exercised by hand or by UI test
Math: engine yes —
Math: screens model + render tests Integral (iPhone), Solve (iPad)
Statistics: engine yes —
Statistics: screens model + render tests Data (iPhone) Other sections rendered off-screen only
Convert yes iPhone, iPad Real ECB download never executed from the app (parser tested on a real ECB document)
Workspace yes iPhone, iPad split Drag and drop, share sheet, file importer not exercised
History shared and persistent across relaunch XCUITest yes
Every environment opens and its demo loads XCUITest yes
Accessibility audit (Standard calculator) XCUITest — See docs/accessibility.md
Math Camera recognition benchmark test no Screen never opened in the simulator; camera needs a device
App Intents compile only no Not invoked through Siri or Shortcuts
Backup export / import unit test of the data path no File dialogs not exercised
Physical device no no No device was connected

# 3. Test results

Final full run on 2026-11-20 (Scripts/test-all.sh, summary in build/test-summary.txt): all suites passed.

Suite Where Tests Result
ORIXNumerics macOS, swift test 12 passed
ORIXExpression macOS 37 passed
ORIXWorkspace macOS 11 passed
ORIXFinancial macOS 67 passed
ORIXStatistics macOS 85 passed
ORIXUnits macOS 60 passed
ORIXSymbolic macOS 58 passed
ORIXGraph macOS 117 passed
ORIXMathCamera macOS 3 passed
ORIXFeatureCalculator iOS 26.5 simulator 11 passed
ORIXFeatureFinancial iOS 26.5 simulator 35 passed
ORIXFeatureConvert iOS 26.5 simulator 46 passed
ORIXFeatureGraph iOS 26.5 simulator 71 passed
ORIXFeatureMath iOS 26.5 simulator 48 passed
ORIXFeatureStatistics iOS 26.5 simulator 66 passed
ORIXFeatureWorkspace iOS 26.5 simulator 46 passed
App unit tests iOS 26.5 simulator 5 passed
UI tests (XCUITest) iOS 26.5 simulator 8 passed, 0 failures
Total 786 all passed

Engine packages were tested on macOS only (they use Foundation, Accelerate and Vision, which behave identically on iOS, but that equivalence was not itself tested). Code coverage was not measured.

Defects found by tests during development and fixed, each with a regression test or a corrected benchmark: equations with a built-in function on the left were read as definitions; long sums overflowed small thread stacks; a divergent integral (∫₀¹ 1/x) returned a finite number; verification notes were built inside inner loops; two UI-test findings (calculator keys without Large Content Viewer; an unlabelled display placeholder).

# 4. Mathematical accuracy

Domain Evidence
Exact arithmetic Integers and rationals are exact by construction; rational → double conversion is correctly rounded and tested on hard cases (subnormals, 2⁵³ + 1, the largest double)
Special functions Worst relative error 4.5·10⁻¹³ over 5 343 cases against 50-digit mpmath
Distributions Worst relative error 6.5·10⁻¹⁴ over 10 164 cases (tails to 10⁻³⁰⁰); discrete quantiles exact
Inference and regression Agreement with SciPy / statsmodels to 10⁻¹⁰; Longley coefficients within 8.8·10⁻¹² of a 60-digit solve
Financial 108 reference cases generated independently in Python; Canadian mortgage 1 744.81, Hull option example 4.7594 / 0.8086, double IRR 10 % / 20 % reproduced
Units 841 conversions against exact fractions; 590 match to the last digit, 251 to 33 significant digits
Symbolic 83 derivatives, 88 integrals, 37 limits, 20 series and more compared with SymPy / mpmath at random points; every antiderivative is re-differentiated before being returned
Graph Discontinuity locations within 10⁻⁹ to 10⁻¹⁵ of the analytic values; polylines verified by dense resampling never to span a pole or jump

Details and the honest list of what is not independently validated: docs/mathematics/reference-tests.md and each Packages/*/VALIDATION.md.

# 5. Numerical limitations

  • Transcendental functions are IEEE-754 double precision (15–16 significant digits).
  • Exact fractions are kept to 8192 bits, then continue in double precision with a precision note; exact integers to about 1.2 million digits; exact factorials to 50000!; sums and products to 1000 terms per chain.
  • Root scans have finite resolution: two IRRs closer than about 0.025 % of the discount factor, or graph roots closer than 1/2000 of the visible range, can merge.
  • Bonds: regular coupons only; compound discounting in the final period (differs from Excel PRICE when one coupon or less remains); yield to call assumes a call on a coupon date.
  • Black–Scholes–Merton needs T > 0 and σ > 0; the binomial tree is capped at 5 000 steps in the interface.
  • Symbolic calculus: non-elementary integrals and irreducible cubic / quartic roots in closed form are reported as not supported; trigonometric input requires radians; definite-integral singularity detection is sampling-based.
  • Graphs: sub-pixel features between samples can be missed; implicit curves are limited by a 2-pixel grid.
  • Polynomial regression uses raw powers and is validated to degree 5.
  • Reference values for the financial, unit and symbolic engines were produced in the same development session as the engines (independent derivations, not independent authorship). No QuantLib or BA II Plus cross-check was made.

# 6. Performance measurements

Engine timings, release build, Apple M5 Max, median of repeated runs (Benchmarks/, full table in docs/development/benchmark-results.md):

Operation Median
Parse and evaluate 25 × 4 34 µs
Full run with explanation and verification 81 µs
2000! exact (5 736 digits) 0.63 ms
50 × 50 determinant, floating point 11 ms
50 × 50 determinant, exact rationals ≈ 1 s
Amortization schedule, 300 payments 1.6 ms
American put, 1 000-step tree 0.5 ms
Graph: tan x at 1200 px with discontinuity detection 0.5 ms
Monte Carlo, 1 000 000 trials 0.35 s
Workspace slider on a 14-cell NPV sheet 1.6 ms
Workspace slider with 500 dependent floating-point cells 17 ms
Workspace slider with 500 dependent exact-rational cells ≈ 1.2 s

Not measured: cold launch, memory, energy, and any timing on an iPhone or iPad. Release app bundle: 12 MB; exported IPA: 11 MB.

# 7. Known issues

  1. No physical-device testing (camera, haptics, Siri, performance, VoiceOver by a person).
  2. Math Camera is Beta: 92 % of 90 rendered, printed, single-line expressions were read correctly; photographs were not tested; the screen itself was not exercised in the simulator.
  3. Interface is English only; explanation text produced by the engines uses "." as decimal separator in every region.
  4. Workspace graph cells are not drawn in PDF / PNG exports (described in text instead).
  5. Exact-rational chains of hundreds of cells recalculate slowly (see performance).
  6. Cancelling a long symbolic, ODE, regression or binomial calculation discards the result but does not interrupt the engine thread.
  7. Results of Financial sections are not restored after relaunch (inputs are); the user taps Calculate again.
  8. Statistics: thousands separators are not recognised when pasting data; datasets are capped at 8 columns.
  9. Graph: analysis and trace work on explicit y = f(x) curves only; entries use "." as decimal separator.
  10. In the densest scientific layout on a small phone, keys are 28–44 pt tall, below the 44 pt guideline.
  11. Interactions never exercised by hand or UI test: graph gestures, drag and drop, share sheets, file importers, hardware-keyboard shortcuts inside feature screens, App Intents.
  12. Not implemented from the original brief: Home Screen widgets, Spotlight indexing, Apple Pencil input, multiple windows per workspace, quantities with units inside expressions, a layered Icon Composer icon, French interface.

# 8. Repository

Host https://git.spboucher.ai/orix-calc (SPB Git)
Visibility Public. git.spboucher.ai has no private repositories (every repository it serves is public). The work was first pushed to a private SSH-only repository (gitsrv:srv/git-private/orix-calc.git); the owner then authorised publication on 2026-11-20.
Remote gitsrv:srv/git/orix-calc.git · read-only clone: https://git.spboucher.ai/orix-calc.git
Branch main
Commit The hash of the commit containing this report is given by git log -1; it is also stated in the final summary of the session
Secret scan Scripts/secret-scan.sh — clean before every push. No key, certificate, profile, token or build product is tracked. The App Store Connect key ID and issuer ID in Scripts/ are identifiers, not secrets; the private key stays in ~/.appstoreconnect/ on the release Mac.
README Rendered page inspected on the forge after the push (see §8.1)

# 8.1 README verification

Checked on 2026-11-20 against the published page https://git.spboucher.ai/orix-calc with a headless Chromium (Playwright), after the push.

Check Result
Page, logo, icon, screenshot, badge endpoints HTTP 200
Images in the rendered page 59, 0 broken (after scrolling so that lazy images load)
Mermaid diagrams in the README 3 of 3 rendered to SVG, 0 syntax errors
Mobile rendering (390 pt wide) No horizontal overflow; header inspected visually
Desktop rendering Header, logo, icon and table of contents inspected visually
Relative links and images in all Markdown files Scripts/check-docs.py: 72 checked, all resolve
Read-only clone git ls-remote https://git.spboucher.ai/orix-calc.git returns main

Not checked: every one of the 54 external links individually, and the Mermaid diagrams inside docs/ (their fences are well-formed; they were not opened on the forge).

# 9. Apple Developer status

Read on 2026-11-20 from the authenticated Apple Developer site in Safari and from the App Store Connect API.

Item Value
Program Apple Developer Program, Individual
Team ID 3YM54G49SN
Membership renewal 5 September 2027
Bundle ID ai.spboucher.orix.calc — registered on 2026-11-20 by automatic signing (resource C9N359B98P)
Capabilities None beyond the defaults
Archive signing Apple Development (archive), re-signed Apple Distribution: Simon-Pierre Boucher (3YM54G49SN) on export
Provisioning "iOS Team Store Provisioning Profile: ai.spboucher.orix.calc", expires 2027-06-07
Icon requirements Checked on developer.apple.com (Human Interface Guidelines, "App icons") on 2026-11-20; see docs/release/app-store.md

# 10. App Store Connect status

Item State
Sign-in Safari session authenticated (observed)
App record "ORIX Calc" Created 2026-11-20 after the owner's authorisation, from the authenticated Safari session — Apple ID 6837544681, SKU orixcalc-ios-001, primary locale en-CA
Metadata Prepared in English (Canada) and French (Canada): docs/release/app-store.md
App Privacy answers Prepared: Data Not Collected
Account notice App Store Connect displays a request to declare EU trader status (Digital Services Act). It does not block TestFlight; it must be completed by the account holder before distribution in the EU
Still required from the owner Privacy-policy URL, support URL, price, age-rating questionnaire

# 11. TestFlight status

Read from the App Store Connect API on 2026-11-20 after the upload.

Stage State Evidence
Release archive Done build/ORIXCalc.xcarchive, 1.0.0 (1), no compiler warnings from project sources
Export Done dist/export/ORIX Calc.ipa (11 MB), Apple Distribution signature
Validation Done altool --validate-app: "VERIFY SUCCEEDED with no errors"
Uploaded Yes, with the owner's authorisation altool --upload-app: "UPLOAD SUCCEEDED", delivery a7521088-fd06-4241-8496-10b4a157c8da
Processing Finished —
Processed Yes build processingState = VALID, usesNonExemptEncryption = false
Internal testing available Yes internalBuildState = IN_BETA_TESTING; internal group "Test" has access to all builds and contains 1 tester, whose state is INVITED (the invitation has not been accepted yet)
External testing available No externalBuildState = READY_FOR_BETA_SUBMISSION: not submitted to Beta App Review; no external group
App Store submission Not requested —

Nobody has installed the build from TestFlight yet as far as the API shows; it has never run on a physical device.

# 12. Outstanding items for the owner

  1. Accept the TestFlight invitation and install build 1.0.0 (1) on an iPhone and an iPad.
  2. EU trader status declaration in App Store Connect.
  3. Privacy-policy and support URLs, price, age rating — needed for external testing and for the App Store.
  4. Decide whether to open external testing (requires Beta App Review) — not requested so far.

# 13. Remaining work

Priority Work
Before TestFlight testers Install on a physical iPhone and iPad; exercise gestures, share sheets, file import, camera, Siri; VoiceOver pass
Before public release Extend the accessibility audit to all environments; measure launch, memory and energy with Instruments; French interface; App Store screenshots at the required sizes
Improvements Real cancellation in long engine calls; graphs in PDF exports; restore Financial results after relaunch; layered icon; widgets and Spotlight; shared ORIX design package with ORIX Scan

# 14. Quality gates

Gate State
The application builds successfully Met (Debug and Release)
Core arithmetic is correct Met (tests)
Scientific operations are validated Met (tests)
Financial calculations pass reference tests Met (tests)
Graphs correctly represent functions Met for the tested corpus (engine and pixel tests)
Statistics modules pass reference tests Met (tests)
No known release-blocking crashes Met in the simulator; unknown on devices
No advertised feature is fake Met; Math Camera is labelled Beta, unimplemented items are listed
Calculation history persists Met (UI test across relaunch)
Workspaces remain intact after relaunch Met at the store level (tests); not verified by a UI test
Numerical errors are handled Met (tests)
Accessibility has been reviewed Partly — automated audit of one screen and design review; no assistive-technology testing
Privacy declarations are accurate Met
App icon assets are valid Met (three 1024 px opaque PNGs; archive built with them)
README is complete Met; rendered page inspected on the forge
Git repository is verified Met — public repository on git.spboucher.ai, remote branch verified
Signing is valid Met
TestFlight prerequisites are satisfied Met — build processed and available to internal testers

Conclusion. ORIX Calc 1.0.0 (1) is on TestFlight for internal testing. It is not release-ready for the public App Store until it has been run on physical devices and the outstanding App Store Connect items are completed.

Files main
Menu

Theme