The Workspace

A hundred-plus crates, one workspace.

One acyclic Rust workspace, roughly 160K lines, depending on the Franken constellation and nothing else. Every layer points strictly downward, and unsafe is confined to audited leaf capsules under 300 lines, each sealed behind a safe façade and registered with the policy checker.

Rust crates
104
acyclic layers
7
lines of Rust
~160K
inline tests
1,300+
CONTRACT.md contracts
52
non-Franken runtime deps
0
The Crate Atlas

Every crate, by layer.

The complete inventory, grouped by the seven strictly-acyclic layers. A layer may depend only on the layers beneath it: L6 Helm sees everything, L0 Substrate sees nothing but the machine. Each group is color-coded by its layer along the spectrum.

L6HELM

Helm

Orchestration, ledger & agent interface

15 crates
fs-bisect

Physics-VCS bisect (addendum Proposal 10): git-bisect for a wrong number.

fs-checker

The standalone evidence-package checker (addendum Proposal 12): an independently distributable verifier that re-verifies a package's completeness.

fs-frame

Flagship 2 (plan 15.2): the seismic-minimal building frame - ground-structure layout LP with duality certificates, code-checked sizing.

fs-ir

FrankenScript, the system's one true interface: a typed, versioned IR with isomorphic s-expr + JSON syntaxes and structured errors that teach.

fs-ledger

The Design Ledger on FrankenSQLite: content-addressed artifacts, event-sourced ops, lineage, tune cache, and time-travel / explain().

fs-marquee

The P2 marquee demo: shape/topology optimization on a raw SDF with no mesh in the loop.

fs-package

Machine-checkable evidence packages (addendum Proposal 12): a content-addressed Merkle bundle of color-typed claims + provenance.

fs-plan

Per-operator error & cost models, the Error Ledger / Time Ledger attribution trees, and a plan-cost oracle rebuilt from tune records.

fs-recompute

A content-addressed Merkle DAG with per-node slack = tolerance − achieved error, for certified-skip incremental recomputation.

fs-report

Automatic lab notebooks + semantic design diffs (fs-report): every study emits a deterministic, content-addressed.

fs-roofline

Machine-axis probing, kernel specs, the roofline registry, a measurement harness, and staleness checks.

fs-session

Sessions, capability tokens, an enforcing resource governor, idempotency keys, and estimate() dry runs.

fs-spececo

Certified-speculation accept/reject economics (addendum Proposal 9): the decision rule.

fs-vskeleton

The vertical skeleton: a deliberately tiny SDF → PDE → objective → adjoint → optimize → ledger → replay demonstrator.

fs-wasm

Browser (WASM) surface over FrankenSim's pure numerical leaves — real math in the browser, no mocks.

L5LUMEN

Lumen

Rendering & visualization

3 crates
fs-img

Deterministic PNG / OpenEXR image plumbing, film / display transforms, and bias-labeled denoising for the render lane.

fs-render

Unbiased spectral path-tracing core (fs-render): the verifiable Monte-Carlo foundations.

fs-viz

Scientific visualization (fs-viz): the topological summaries that make a 10^8-cell field legible to an agent in one image.

L4ASCENT

Ascent

Optimization & uncertainty

20 crates
fs-archive

Quality-diversity archives (fs-archive): MAP-Elites and CVT illumination archives that ILLUMINATE a behavior space.

fs-ascent

The gradient-based optimizer stack: L-BFGS with strong-Wolfe search, trust-region Newton-Krylov (Steihaug).

fs-assimilate

Data assimilation: validation as a living belief (addendum Proposal 11).

fs-bo

Bayesian optimization: Matern-family Gaussian processes with QMC-multistart hyperparameter fitting, EI/q-EI acquisitions, and deterministic BO loops.

fs-constraint

A constraint calculus with semantics: Hard / Soft / Chance / Robust / Certification / Fabrication kinds, evidence-typed violations, and minimal unsat cores.

fs-dfo

Derivative-free engines: CMA-ES as a natural-gradient flow, BIPOP restarts, and Nelder–Mead, all deterministic from seed and cross-ISA golden-hashed.

fs-dimine

Dimensional knowledge mining (addendum Proposal 9): fit closed-form power-law scaling laws over a certified corpus in dimensionless-group.

fs-eproc

Betting e-processes, pairwise races, Gaussian-mixture confidence sequences, and e-Benjamini–Hochberg for anytime-valid stopping.

fs-fab

Manufacturing, fabrication, and code compliance as its own layer (fs-fab): optimization without fabrication semantics produces fantasy artifacts.

fs-geocon

First-class manufacturability constraints: min-thickness (the anti-paperclip constraint), draft angle, symmetry-by-construction, and keep-out envelopes.

fs-opt

The optimization problem IR: typed objective / constraint graphs over manifold variables, with the Goodhart guard.

fs-robust

Objective epistemics (addendum Proposal F): apply the three colors to the GOAL itself.

fs-sos

Proof-carrying optimization (fs-sos): sum-of-squares certificates as executable PROOFS of polynomial lower bounds.

fs-surrogate

Learned accelerators with guarantees (fs-surrogate): classical reduced-order models permitted ONLY inside certified validity bands.

fs-toleralloc

Adjoint-driven tolerance allocation (addendum Proposal 11's commercial kicker): spend tight manufacturing tolerances.

fs-topols

Level-set topology optimization: WENO narrow-band advection, fast-iterative-method redistancing, normal velocity extension.

fs-topopt

Density-based topology optimization: SIMP with Helmholtz filtering, Heaviside projection, exact chain-rule sensitivities.

fs-truss

Ground-structure truss layout optimization: fnx candidate graphs, PDHG plastic-design LP with duality-gap certificates.

fs-uq

Uncertainty quantification: Karhunen-Loeve random fields with captured-variance evidence, polynomial chaos by regression, QMC propagation.

fs-voi

Value-of-information and active validation (fs-voi): the strategic layer deciding what information to acquire next.

L3FLUX

Flux

Physics kernel

23 crates
fs-adjoint

Gradient truth: IFT discrete adjoints through solvers, time-dependent adjoints under revolve checkpointing, Hadamard shape gradients.

fs-bem

Laplace BEM panel methods: 3D exterior potential flow with FMM-accelerated GMRES, 2D Hess-Smith airfoils with Kutta condition and adjoint gradients.

fs-contract

Assume-guarantee component contracts (addendum Proposal E): certified design motifs.

fs-couple

Multiphysics composition through port-Hamiltonian Dirac structures (fs-couple): partitioned coupling that is PASSIVE BY CONSTRUCTION.

fs-cutfem

CutFEM on SDFs: certified cut-cell classification, cut quadrature with error control, ghost-penalty stabilization, aggregation fallback.

fs-dd

Domain decomposition: BDDC substructuring with corners-primal coarse spaces, sheaf-harmonic edge enrichment (Bet 11's second consumer).

fs-dwr

Dual-weighted-residual goal-oriented adaptivity: enriched-adjoint DWR estimates, Doerfler marking, octree h-refinement loops.

fs-feec

Exterior-calculus core: cochains on complexes, exact integer incidence d, Hodge stars / Whitney masses, and grad→curl→div identities to machine precision.

fs-flux

Incompressible Navier-Stokes, FEEC-native: H(div)-conforming RT0 velocities (exactly divergence-free, pressure-robust), interior-penalty viscous DG.

fs-iface

Interface types and a coupling-graph checker: Arnold's FEEC periodic table as a type lattice; illegal couplings become compile-time rejections.

fs-iga

Isogeometric analysis (fs-iga): Galerkin directly on B-spline spaces.

fs-ladder

The fidelity-ladder registry: ordered rungs per kernel (correlation → RANS → LES) with typed prolongation / restriction.

fs-lbm

Lattice Boltzmann core (fs-lbm): a D2Q9 BGK stream-and-collide solver with Guo body forcing and halfway bounce-back walls.

fs-material

Constitutive-law kernel: elastic, hyperelastic, J2 plasticity, Mander concrete / Menegotto–Pinto steel, with consistent tangents.

fs-opdsl

A typed operator IR: one symbolic definition yields residual, JVP, VJP / adjoint, DWR indicators, and MMS studies. A kernel-generating algebra.

fs-probe

Discrepancy probes + budget pie (addendum Proposal 3): runs adjacent-rung model-form probes over the fidelity-ladder registry.

fs-regime

Physics-regime & nondimensionalization: which solver is even valid here? Buckingham-π groups, scaling maps, and alternatives-ranked refusals.

fs-scenario

A boundary-condition & load-case algebra: what is being done to it? as a typed, dimensioned value with frames and stochastic ensembles.

fs-solid

Elasticity core: small-strain and finite-strain hyperelasticity (via fs-material), locking-free B-bar, body-fitted and CutFEM frontends.

fs-solver

Matrix-free Krylov (CG / MINRES / GMRES) plus p-multigrid: resumable, cancellable, deterministic, and adjoint-equipped by construction.

fs-time

Structure-preserving integrators: symplectic Verlet, Lie-group SE(3) / SO(3), generalized-α, IMEX / exponential, with adjoints.

fs-verify

The certified-speculation verifier: an equilibrated-flux (Prager–Synge) a-posteriori accept test that stamps candidates verified or fails closed.

fs-vpm

Vortex particle method (fs-vpm): 2-D inviscid vortex dynamics by direct desingularized Biot-Savart induction and RK4 advection.

L2MORPH

Morph

Geometry kernel & representations

17 crates
fs-asbuilt

As-built ingestion: reality as another chart (addendum Proposal 11).

fs-conform

Restriction-map plugin conformance SDK (addendum Proposal 7): third-party chart-to-chart converters are certified into tiers.

fs-fmm

Kernel-independent black-box FMM: Chebyshev interpolation operators on octrees (P2M/M2M/M2L/L2L/L2P), direct near field.

fs-ga

Geometric algebra: PGA Cl(3,0,1) motors / screws and CGA Cl(4,1), with const-evaluated multiplication tables.

fs-geom

The Region / Chart abstraction, chart-agreement as a checkable proposition, the Rep Router, and sheaf certificates.

fs-io

Import / export with quarantine: dirty geometry lands as Quarantined and only promotes to Evidence after repair + validity.

fs-mesh

Incremental Delaunay / tet scaffolding, exact audits, quality refinement, metric fields, and remeshing.

fs-query

Uniform geometry queries across chart types: closest point, sphere-trace raycast, offsets, certified clearance, and curvature.

fs-rep-frep

CSG / F-rep builders, differentiable R-function Booleans, and interval / Lipschitz / gradient evaluators.

fs-rep-mesh

Half-edge surfaces, oriented tet complexes, soup repair, generalized winding numbers, dual contouring, and quality.

fs-rep-neural

Neural implicit charts (fs-rep-neural): small coordinate MLPs as shapes (DeepSDF-style) with SPECTRAL-NORM/Lipschitz-constrained layers.

fs-rep-nurbs

Rational B-spline charts with exact knot insertion & degree elevation (i128 rationals), trimmed patches, and certified closest-point.

fs-rep-sdf

Dense tiled SDF grids, the FrankenVDB sparse tree, adaptive octree SDF, narrow-band, and SDF charts.

fs-rep-voxel

Occupancy / multi-material voxel charts on VDB, exact Euclidean distance transforms, point clouds, and lattice graphs.

fs-shapeprog

Generative geometry program synthesis (fs-shapeprog): a typed constructive-geometry DSL with SDF semantics.

fs-topo

Validity & topology certificates: manifoldness, self-intersection proofs (exact orient3d), and cubical Betti numbers.

fs-xform

FFD lattices, RBF morphs, level-set velocity bands, SIMP density fields, composed parameterizations, and foldover detection.

L1BEDROCK

Bedrock

Numerical foundations

10 crates
fs-ad

Forward-mode duals, the Real trait, gradient checks, implicit-function adjoint hooks, and revolve checkpointing.

fs-cheb

Adaptive 1D Chebyshev, Lobatto points, differentiation matrices, and Orr–Sommerfeld growth rates.

fs-fft

Complex and real FFTs, DCT-II/III, Stockham structure, and transform conformance.

fs-ivl

What the word Certified means: outward-rounded intervals, affine arithmetic, Taylor models, Newton / Krawczyk, and exact geometric predicates.

fs-la

Dense BLIS-style GEMM, batched small-dense, factorizations, mixed precision, eigensolvers, and randomized NLA.

fs-rand

Counter-based Philox streams keyed by logical identity, Sobol / Owen QMC, lattice rules, and distributions.

fs-sparse

COO / CSR / BSR / SELL formats, deterministic assembly, SpMV / SpMM, Chebyshev smoothers, ILU0, PCG, and smoothed-aggregation AMG.

fs-spectral

Spectral health monitoring (addendum Proposal 5): track the sheaf-Laplacian lambda-gap as a runtime health metric with hysteresis.

fs-symmetry

Symmetry harvesting (addendum Proposal 13): detect cyclic symmetry with a certified asymmetry residual.

fs-tropical

Tropical (max-plus) critical-path analytics (fs-tropical): task-DAG timing in the max-plus semiring.

L0SUBSTRATE

Substrate

Hardware, execution & determinism

7 crates
fs-alloc

128-byte aligned allocation, cache padding, scoped arenas, arena pools, and hugepage policy.

fs-exec

The Cx context, two-lane executor, cancellation gates, tile kernels, deterministic reductions, speculative races, and resumable solvers.

fs-math

Deterministic elementary functions with declared ULP budgets, complex arithmetic, error-free transforms, and double-double.

fs-simd

Scalar baseline plus registered NEON / AVX-512 unsafe capsules behind safe façades and alignment contracts.

fs-soa

Structure-of-arrays runtime: 128-byte-aligned per-field buffers, SIMD across elements, zero-copy views. No unsafe.

fs-substrate

Machine capability probes, fingerprints, topology maps, dispatch tiers, and Morton / tile IDs.

fs-tilelang

A safe tile-kernel DSL: one body lowers to scalar and lane-shaped variants (bitwise-equal) with roofline metadata and auto-generated determinism twins.

CROSS-CUTTING

Owned by no single layer

Quantities, evidence, macros, governance & benchmarks

9 crates
fs-benchmark

The wedge-vertical benchmark & trace corpus (addendum Proposal 7): a single versioned, deterministic artifact.

fs-crosswalk

Regulatory vocabulary crosswalk (addendum Proposal 12): a machine-readable mapping of evidence-package fields onto the regulator's existing language.

fs-evidence

Evidence<T> / Certified<T>: a value plus four uncertainty slices, composed conservatively, with model cards, the three colors, and falsifiers.

fs-govern

Addendum governance as machine-readable data: the design principles (P1-P8), the governance rules.

fs-obs

Structured event schema, emitters, and content hashing: the shared observability spine.

fs-qty

Compile-time dimensional quantities Qty<M,KG,S,K,A>, SI parsing, and dimension checks.

fs-soa-derive

The #[derive(Soa)] procedural macro.

fs-tilelang-macros

The kernel! macro implementation for fs-tilelang.

fs-wedge

Go-to-market wedge selection as data (addendum Proposal 7): the conjugate-heat-transfer beachhead scored on four criteria.

fs-qty, fs-obs, and fs-evidence are the load-bearing three of this cross-cutting set: threaded through all seven layers rather than owned by any single one. Dimensional quantities are compile-time typed everywhere, every operation emits into one shared observability spine, and Evidence<T>, a value plus its four uncertainty slices, is the currency that crosses every layer boundary. The rest of the set carries the same discipline sideways: the derive macros, the governance and benchmark corpus, the regulatory crosswalk. That is what keeps units, provenance, and error bounds from being re-invented six incompatible times.

fs-qty · fs-obs · fs-evidence

Enforcement

Repository policy is code.

The workspace's invariants are checked mechanically on every build, not left to a style guide anyone can forget.

A dedicated xtask binary is the workspace's conscience. It refuses to let the constellation drift: the acyclic layer direction, the dependency allow-list, the presence of conformance contracts, and the registration of every unsafe capsule are all facts it can prove or fail on before a merge, not after an incident.

Acyclic layer direction

The L0 → L6 dependency graph is walked and asserted acyclic. A crate that reaches sideways or upward (L2 pulling on L4) is a build failure, not a code-review note.

Franken-only dependencies

Every runtime dependency is checked against the Franken constellation allow-list. A stray crates.io import never makes it past the gate.

Contract presence

Each crate that owes a conformance contract must ship its CONTRACT.md, 52 in all. A missing or stale contract fails the run.

Unsafe-capsule registration

Every unsafe block lives in a registered leaf capsule under 300 lines behind a safe façade. Unregistered unsafe is rejected at the door.

The same discipline the Gauntlet applies to numerics, xtask applies to structure: the shape of the workspace is a checkable proposition, so the hundred-plus crates stay one continuum instead of drifting into a hundred-plus projects.