Skip to content

ROADMAP.md

Latest commit

 

History

History
448 lines (331 loc) · 49 KB

ROADMAP.md

File metadata and controls

448 lines (331 loc) · 49 KB
Raw

Kerf — Roadmap

Last verified: 2026-06-04

North Star

The most comprehensive CAD on Earth — a single tool in which a person can design anything. Mechanical engineering, electronics, PCB, architecture, civil engineering, drafting, jewelry, automotive — and every other CAD sector, including the small and niche ones. We are doing everything. Nothing here is "cut." Lower priority means later, not dropped.

This is a priority-ordered roadmap, not a date-ordered or effort-ordered one. The tiers (P0 → P3) express sequence and leverage: which items earn the most credibility per unit of work.

Kerf is 100% MIT — free, open-source software with no paid tier, no billing, and no hosted product. (The former dual-license split is retired; see the 2026-07-17 final-form ADR in decisions.md.)

Why chat-driven CAD works

Kerf is chat-driven CAD. Every capability is designed around one constraint:

Can the LLM produce and re-edit this deliverable through a text-native tool, and verify the result?

Professional CAD is overcomplicated mostly because of command-discovery affordances (ribbons, palettes, wizards) that an LLM does not need. Kerf ships professional capability while deliberately not shipping professional UI complexity. This makes the roadmap shorter than it looks: many "pro features" are UX wrappers around a parametric core we expose as a text schema + LLM tool + verifier.

Hard guardrail: simplification is about authoring mechanics only. It is never an excuse to drop a domain or to skimp on correctness, output formats, or standards compliance. Those are more important under an LLM, not less.

Platform foundation

The sector work only matters if you own your work, are not locked in, and can run Kerf wherever you want. Four commitments, all decided:

  1. Every cloud project is a real git repository — git clone-able with stock git, no special client. Large or binary files are auto-detected and stored with a small in-git pointer. Version control is two complementary layers: fine-grained automatic file history and deliberate, shareable commits with GitHub sync.

  2. One client, cloud by default, easy optional self-host — pip install kerf for the hosted cloud; pip install 'kerf[server]' + bring-your-own-Postgres + kerf serve for self-host. Same client, same data model, both paths first-class.

  3. Portability is the anti-lock-in guarantee — kerf sync mirrors to a local folder with two-way sync; kerf export / kerf import produce and ingest a plain file tree. Moving a project between cloud and self-host is painless.

  4. A fully-local / offline desktop app is committed but demand-gated — portability + two-way sync + easy self-host is the complete launch answer to "I want to own my data." The standalone offline desktop build is sequenced behind real demand.

Active program — G1…G4 (opened 2026-08-05)

Four goals, sequenced by start order, not completion order. G1 must land its foundation before anything else forks; after that all four run concurrently against disjoint file sets. Task detail is tracked in GitHub issues.

A single theme connects G2, G3 and G4: Kerf reads far more formats than it writes. KiCad round-trip preserves only refs/nets/footprint names; FreeCAD import is deep but one-way; the STEP writer is AP214 while the reader handles AP242. Every goal below is, in part, closing a writer gap.

G1 — TypeScript revamp (T-500 … T-524)

Baseline measured 2026-08-05: 1,194 files / 366,673 lines of .js/.jsx in src/; zero .ts/.tsx; no root tsconfig; 466 colocated test files; 99 src/lib files already carrying JSDoc @param annotations. packages/kerf-sdk-ts/tsconfig.json already runs strict: true and is the pattern to copy.

Decided — scope: the frontend, plus a typed TS/WASM kernel path. The 2,596-file Python backend is not ported: it owns pythonocc/OCCT, numpy and scipy, and remains authoritative for geometry.

Decided — strategy: gradual. Root tsconfig with allowJs: true, checkJs: false, strict: false; rename leaf-first; tighten to strict per-directory afterwards. The build stays green at every commit, which is what makes N agents on disjoint directories safe.

This is not a framework change. "Frontend stays React" (see Decentralized node model below) still holds — G1 adds types to the existing React app and does not reopen the rejected rewrite.

The TS/WASM kernel is not from zero. src/lib/occtWorker.js (7,957 lines) already runs OCCT in the browser via opencascade.js, alongside public/planegcs.wasm and public/occt-import-js.wasm. G1's kernel half is about giving that path one typed interface with two backends — browser WASM and Python server — not building a second kernel.

G2 — Unified ECAD IR, KiCad-interoperable (T-525 … T-539)

The problem is not tscircuit-the-syntax; it is that tscircuit's Circuit JSON is simultaneously the authoring format and the interchange IR, and that the KiCad adapter on top of it is thin.

The measurable defect is the adapter (verified 2026-08-05): kicad_io.py contained zero occurrences of zone, pour, thermal or keepout. Yet Circuit JSON models copper pours perfectly well — pcb_copper_pour in polygon/rect/BRep variants, plus pcb_ground_plane and pcb_ground_plane_region, all verified directly in circuit-json's type surface. So the pour was dropped at the adapter, not at the IR.

Correction (2026-08-06). An earlier revision of this paragraph also claimed Kerf "already consumes them in at least eight modules." That was wrong — it came from a grep that matched files on either of two terms and was reported as though all matched the specific types. Measured properly:

  • pcb_ground_plane is consumed in the Python tree nowhere (0 occurrences).
  • pcb_copper_pour / copper_pour_fill are recognised in exactly two files — fab/gerber.py and fab/odbpp/writer.py.
  • via_stitching.py reads a different, board-level convention: board['copper_pour'] keyed by pour_id.
  • tools/pour.py and src/lib/copperPour.js each carry their own shape again.

So Kerf has at least three incompatible in-repo pour conventions, not one coherent model. That does not change T-525's finding — nothing here needs a new IR — but it reframes the work: alongside the adapter gap there is genuine internal fragmentation, tracked as T-536. Reconciling it is a precondition for the writer (T-527) emitting what the fab pipeline actually reads.

Measured 2026-08-05 (T-525) — the IR is probably unnecessary. Across 12 KiCad constructs: 10 adapter-only, 6 small-extension, 0 genuine IR limits. kicad_io.py's hand-rolled ~90-line lexer already tokenises zone/group/locked/dimension nodes correctly; the semantic reader simply never reads them. G2 therefore shrinks: T-526/T-527 become a better reader/writer plus typed fields for Kerf's existing informal board extensions, T-528 (conformance vectors) survives, and T-529…T-535 mostly disappear. Caveat recorded honestly in docs/ecad-gap-analysis.md: no repo fixture contains a zone, group, locked object, dimension, hierarchical sheet or stackup, and there is no .kicad_sch fixture at all, so most rows rest on synthetic corroboration and should be re-run against a real pcbnew export.

Licensing constraint (decided 2026-08-05): the analysis recommended kiutils as the parser backbone. It is GPLv3, and Kerf is 100% MIT. Decision: stay MIT-clean. No GPL dependency enters the interop path.

Parser strategy (decided 2026-08-06): the constraint turned out to be far cheaper than feared — MIT-licensed KiCad parsers were already installed as transitive tscircuit dependencies (kicadts, effectively an MIT kiutils; and kicad-to-circuit-json, which converts straight to Circuit JSON). Both carry MIT License, Copyright (c) 2025 tscircuit Inc.; their package.json license field is merely absent, which is why a metadata scan missed them. They are TypeScript, however, and Kerf's ~20 electronics consumers are Python, with no Node at runtime (pip install kerf would regress otherwise). So: the parser stays in Python, sexpdata (BSD-2) replaces the hand-rolled lexer, kicadts serves as a reference blueprint rather than a dependency, and kicad-to-circuit-json becomes a CI conformance oracle — an independent implementation to diff against, which is the answer to our fixtures being hand-authored. Full rationale is recorded in decisions.md.

That distinction set G2's first job: measure the true gap before designing around it. An earlier draft of this section blamed Circuit JSON's expressiveness for the pour gap; that was wrong, and the same caution applies to the other suspected gaps (custom pad primitives, teardrops, rule areas, net-class DRC semantics, hierarchical sheet instances, stackup, 3D model links). T-525 quantifies which of those are genuinely IR limits and which are merely adapter limits — the answer changes how much new IR is warranted versus how much is a better reader/writer over what already exists.

Shape: a Kerf ECAD IR modeled on KiCad's data model (the richest open one, and the interop target), carrying a passthrough bag — every s-expression node the IR does not model is preserved verbatim and re-emitted in place. That is what makes round-trip lossless without modeling all of KiCad up front. tscircuit JSX and atopile both become front-ends that lower into the IR; Circuit JSON becomes an export adapter, not the core. No existing .circuit.tsx file breaks.

G3 — FreeCAD round-trip (T-540 … T-549)

Import is already deep (tier 3: PartDesign bodies, sketches, assemblies, Spreadsheet → .equations, TechDraw → .drawing, materials, Draft). Two gaps: imported feature trees are read-only BRep snapshots, not recomputable (import_freecad.md: "the imported feature-tree metadata is read-only — geometry is the lifted BRep, not a recompute"), and there is no FCStd writer anywhere in the repo.

G4 — Engine: WebGPU + interop writers (T-550 … T-559)

WebGPU is currently one page. src/components/render/PathTracerCanvas.jsx is the only navigator.gpu call site, and it uses createRenderPipeline — never createComputePipeline. Every CAD viewport (~12 separate new THREE.WebGLRenderer call sites) is WebGL2. No GPU library is imported anywhere in the Python packages.

Highest-leverage items, in order:

# Item Why it ranks
1 AP242 writer + semantic PMI The aerospace/space deliverable format; the reader already exists to round-trip against.
2 SDF marching cubes → WebGPU compute, + MC33 sdf/marching_cubes.py:197 is a triple-nested Python loop over the voxel grid — the F-rep/TPMS/jewelry-hollowing hot path. polygonize_sdf_chernyaev is a stub, so ambiguous cases are wrong on thin features (enamel margins, filigree, lattice struts). Fixes a correctness bug and the worst perf path together.
3 Rhino .3dm import Rhino/Matrix/RhinoGold is the jewelry industry; the 57,872-LOC jewelry module can't accept customer files. openNURBS is permissively licensed and the NURBS/SubD kernel can already represent its contents.
4 Zebra/isophote as viewport shaders Class-A analysis lives in geom/surface_analysis.py — a server round-trip. Surfacers expect to drag a control point and watch stripes move.
5 WebGPURenderer + one shared device ~12 WebGL contexts against a browser cap of roughly 8–16 is a real ceiling.
6 GPU-driven culling + ID-buffer picking Retires the 200 ms debounced server LOD round-trip (Renderer.jsx, kerf-tess/adaptive_lod.py) and the CPU raycast.

Deferred, deliberately: JT XT-B-rep (jt_reader.py:922 — tessellation only) and CATIA native. Both are large, and automotive does not convert on geometry exchange alone.

What shipped

2026-06-03 / 2026-06-04 — Wave 8–12 comprehensive saturation push

Compare-manifest saturation at time of writing: 1235 yes / 29 partial / 1 no (98.5%).

Kernel depth

  • Stam exact-limit position + tangents at extraordinary Catmull-Clark vertices via eigenstructure decomposition (packages/kerf-cad-core/src/kerf_cad_core/subd/stam_limit_tangents.py).
  • Fractional crease decay, DeRose-Kass-Truong 1998 §4: s_new = max(0, s_old − 1) per subdivision level, smooth-weight = 1 − clamp(s_L, 0, 1) (packages/kerf-cad-core/src/kerf_cad_core/subd/crease_fractional_decay.py).
  • MatchSrf G3 boundary continuity: curvature-rate continuity match across joined NURBS surfaces (packages/kerf-cad-core/src/kerf_cad_core/geom/match_srf_g3.py).
  • Full NURBS analytic surface derivatives (Piegl & Tiller Algorithm A3.6 + rational quotient rule A4.4), Gaussian K and mean H curvature, hardened SSI differential-geometry marcher (packages/kerf-cad-core/src/kerf_cad_core/geom/surface_analytic_derivatives.py).
  • B-rep → 2D Hidden-Line Removal projection for technical drawings (packages/kerf-cad-core/src/kerf_cad_core/drawings/brep_hlr.py).
  • G1 continuity at extraordinary-vertex SubD → NURBS patch conversion (Loop 1987 §4) (packages/kerf-cad-core/src/kerf_cad_core/subd/g1_extraordinary_patches.py).
  • OCCT Phase 4 NURBS surfacing — COMPLETE: MatchSrf G3 (geom/match_srf_g3.py), trim-by-curve + loop heal + validation (geom/trim_curve.py, geom/trim_loop_heal.py, geom/trim_validation.py), surface-direct booleans + robustness layer (geom/nurbs_boolean.py, geom/surface_boolean_robust.py), analytic curve + surface derivatives (geom/nurbs_derivative.py, geom/surface_analytic_derivatives.py), Stam limit-tangents + G1 at EVs (subd/limit_tangent.py, subd/g1_extraordinary_patches.py), Tiller-Hanson far-offset (geom/offset_far_correction.py), iso-curve extraction (geom/iso_curve_extract.py).

SubD / mesh

  • Multires displacement maps on Catmull-Clark limit surface (Krishnamurthy-Levoy 1996) (packages/kerf-cad-core/src/kerf_cad_core/geom/multires_displacement.py).
  • SDF CSG smooth-blend (smooth-min) + marching-cubes polygonisation (Lorensen-Cline 1987) (packages/kerf-cad-core/src/kerf_cad_core/geom/sdf_csg.py, packages/kerf-cad-core/src/kerf_cad_core/sdf/marching_cubes.py).
  • Sculpt brush engine: grab / smooth / inflate / crease / pinch / Smooth-Taubin; Wendland C2 falloff (packages/kerf-cad-core/src/kerf_cad_core/mesh_sculpt_brushes.py).
  • .3dm write side + Hausdorff round-trip oracle (packages/kerf-cad-core/src/kerf_cad_core/geom/io/rhino3dm.py).
  • LSCM UV unwrap wired as LLM tool; UV-chart hardening (seam cut + shelf bin-pack + distortion stats) (packages/kerf-cad-core/src/kerf_cad_core/geom/uv_unwrap_hardening.py).
  • Viewport LOD bridge: mesh_url byte-count estimator, camera-debounce LOD planner wired to Renderer.

Optics / rendering

  • Jensen 1996 spectral photon-map + caustic solver (packages/kerf-cad-core/src/kerf_cad_core/optics/photon_map.py).
  • WebGPU spectral path-tracer (browser, BK7/SF11/water glass scene) (src/components/render/PathTracerCanvas.jsx).
  • Theatrical lighting plot + IES LM-63 photometric reader (packages/kerf-cad-core/src/kerf_cad_core/render/theatrical_lighting.py).
  • Daylight / lux simulation (CIE sky models) + archviz pipeline (packages/kerf-cad-core/src/kerf_cad_core/render/luminance_lux_sim.py).
  • Phoenix-FD-equivalent visual fluid simulation.
  • Zemax metalens design (Khorasaninejad 2016) + STOP multiphysics (packages/kerf-cad-core/src/kerf_cad_core/optics/metalens.py, packages/kerf-cad-core/src/kerf_cad_core/optics/stop_analysis.py).

Simulation

  • RANS k-ε (Launder-Spalding 1974) + k-ω SST (Menter 1994) turbulence models + wall functions (packages/kerf-cfd/src/kerf_cfd/rans_keps.py, packages/kerf-cfd/src/kerf_cfd/rans/k_omega_sst.py).
  • snappyHexMesh-style mesher + ASCE 7-22 wind engineering + Bearman vortex shedding (packages/kerf-cfd/src/kerf_cfd/meshing/snappy_hex.py, packages/kerf-cfd/src/kerf_cfd/wind_engineering/wind_tunnel.py).
  • CFD combustion EBU + Lagrangian particles + ALE dynamic mesh / FSI (packages/kerf-cfd/src/kerf_cfd/combustion/reacting_flow.py, packages/kerf-cfd/src/kerf_cfd/fsi/dynamic_mesh.py).
  • Compressible Roe flux + conjugate heat transfer + VOF multiphase + Holtrop-Mennen marine resistance (packages/kerf-cfd/src/kerf_cfd/compressible/compressible_flow.py, packages/kerf-marine/src/kerf_marine/holtrop_mennen.py).
  • Adams Craig-Bampton flex-body MBD + Pacejka tire (Adams/Car) + Litvin gear/belt (Adams/Machinery) (packages/kerf-cad-core/src/kerf_cad_core/mbd/solver.py).
  • FE-solid tet/hex elements with H8 B-bar + Total-Lagrangian nonlinear static (packages/kerf-fem/src/kerf_fem/solid_hex.py).
  • Classical controls: TF/Routh-Hurwitz/Bode/Nyquist, PID tuning (Ziegler-Nichols + IMC + Lambda), state-space + LQR + Ackermann (packages/kerf-cad-core/src/kerf_cad_core/controls/transfer_function.py).
  • AC load-flow Newton-Raphson power systems (packages/kerf-electronics/src/kerf_electronics/power/ac_load_flow.py).

Manufacturing / mold

  • Cimatron mold base library + EDM electrode + wire EDM G-code generation (packages/kerf-mold/src/kerf_mold/).
  • Parting line detection + cavity-core split (packages/kerf-mold/src/kerf_mold/parting_line.py, packages/kerf-mold/src/kerf_mold/cavity_core_split.py).
  • Moldflow injection-fill simulation: 1.5D Hele-Shaw + Cross-WLF rheology (packages/kerf-mold/src/kerf_mold/injection_fill.py).
  • FiberSim AFP/ATL fibre-placement paths + laser projection + flat-pattern DXF export (packages/kerf-cad-core/src/kerf_cad_core/composites/afp_atl_path.py).

Architecture / BIM / Civil

  • 8760-hr ASHRAE energy simulation + Title 24 (16 CA climate zones) + LEED v4 EAp2 (packages/kerf-cad-core/src/kerf_cad_core/buildingenergy/hourly_8760.py).
  • HVAC plant simulation: chiller / boiler / VAV + AHRI-certified equipment catalogue (kerf-hvac/).
  • Civil 3D dynamic TIN (Bowyer-Watson Delaunay) + Manning gravity pipes + Hazen-Williams pressure pipes (Hardy-Cross) (packages/kerf-cad-core/src/kerf_cad_core/civil/tin_surface.py, packages/kerf-cad-core/src/kerf_cad_core/civil/gravity_pipe_network.py).
  • Civil parcel subdivision + plan-and-profile sheet generator (packages/kerf-cad-core/src/kerf_cad_core/civil/parcels.py, packages/kerf-cad-core/src/kerf_cad_core/civil/plan_profile_sheet.py).
  • kerf-civil LandXML 1.2 import/export + Todini-Pilati GGA pressurised pipe network (HW/DW headloss) + Manning circular/trapezoidal sewer capacity + rational-method peak runoff + HDS-5 inlet-control culvert capacity (packages/kerf-civil/src/kerf_civil/landxml.py, packages/kerf-civil/src/kerf_civil/tools_hydraulics.py).
  • Multi-discipline plant federation (packages/kerf-cad-core/src/kerf_cad_core/piping/multi_discipline_federation.py).
  • AVEVA piping ASME B16 component catalogue (packages/kerf-cad-core/src/kerf_cad_core/piping/component_catalogue.py).

PLM / packaging

  • ArtiosCAD pre-press tooling + PDF/X-1a output (packages/kerf-cad-core/src/kerf_cad_core/packaging/pre_press.py).
  • Material yield + cost estimation (packages/kerf-cad-core/src/kerf_cad_core/packaging/material_yield.py).
  • Cimatron quote-to-delivery workflow (ANSI/ISA-95 status state-machine) (packages/kerf-plm/src/kerf_plm/quote_to_delivery.py).
  • PLM Configurator + SysML Trace UI panels (src/components/plm/ConfiguratorPanel.jsx, src/components/plm/SysMLTracePanel.jsx).

AFR / Reverse engineering

  • AAG topology DAG feature-recognition (Han-Pratt-Regli 2000) (packages/kerf-cad-core/src/kerf_cad_core/afr/dag.py).
  • Persistent face naming (Kripac 1997) for parametric replay (packages/kerf-cad-core/src/kerf_cad_core/geom/history/).
  • Freeform NURBS fit pipeline + Hausdorff round-trip oracle (packages/kerf-cad-core/src/kerf_cad_core/scan/nurbs_fit_tools.py).

Aerospace

  • CR3BP libration orbits: halo / Lyapunov / Lissajous via Richardson 1980 + Howell 1984 (packages/kerf-cad-core/src/kerf_cad_core/aerospace/libration_orbits.py).
  • Batch least-squares + EKF orbit determination (packages/kerf-cad-core/src/kerf_cad_core/aerospace/orbit_determination.py).
  • GMAT 3D trajectory viewer (Three.js) (src/components/aerospace/GmatTrajectoryViewer.jsx).
  • OpenRocket RASP .eng motor DB wired as LLM tool (packages/kerf-cad-core/src/kerf_cad_core/aerospace/motor_database.py).

Electronics

  • BSIM4 + PVT corner Monte Carlo + multi-dialect netlist codegen (SPICE foundry parity) (packages/kerf-electronics/src/kerf_electronics/spice/bsim4_model.py).
  • Altium MB3D multi-board workspace + inter-board net mapping (packages/kerf-electronics/src/kerf_electronics/multi_board/workspace.py).
  • LTspice-equivalent schematic capture GUI + wire router (src/components/electronics/SchematicEditor.jsx).
  • Interactive PCB editor with push-shove routing + diff-pair tuning (src/routes/PCBEditor.jsx, packages/kerf-electronics/src/kerf_electronics/routing/push_shove.py).
  • AC load-flow Newton-Raphson (packages/kerf-electronics/src/kerf_electronics/power/ac_load_flow.py).
  • openEMS FDTD geometry export bridge for PCB RF routes (packages/kerf-electronics/src/kerf_electronics/routes_rf.py).

Verticals

  • Dental (3Shape-parity depth): crown/bridge, implant planning (Straumann/Nobel/Astra), surgical guide, RPD/denture (Kennedy class), intraoral STL + ICP+Kabsch bite alignment, lab workflow (KaVo articulator JSON), Hu-moment template-matching for AI assist (packages/kerf-dental/src/kerf_dental/).
  • Apparel / e-textiles: CLO3D avatar body form + smart garment e-textiles + pattern grading (packages/kerf-textiles/src/kerf_textiles/, kerf-apparel/).
  • Woodworking: Mozaik cabinet room layout + cut-list / joinery / grain depth (packages/kerf-woodworking/src/kerf_woodworking/cabinet_cut_list.py).
  • Visual scripting: Vectorworks Marionette + MatrixGold scripting engine + Braceworks rigging-load (src/components/nodescript/NodeGraphCanvas.jsx, packages/kerf-cad-core/src/kerf_cad_core/visualscript/marionette.py).
  • ZBrush-equivalent: dynamesh + polypaint + HD displacement + character rigging (packages/kerf-cad-core/src/kerf_cad_core/mesh_sculpt_brushes.py, packages/kerf-cad-core/src/kerf_cad_core/geom/multires_displacement.py).
  • Animation: keyframe FCurves + armature poser + CCD/FABRIK IK solvers (packages/kerf-cad-core/src/kerf_cad_core/animation/keyframe.py, packages/kerf-cad-core/src/kerf_cad_core/animation/ik_solver.py).

Frontend panels

  • src/components/arch/StructuralPanel.jsx — 24 arch_* LLM tools in 5 tabs (src/components/arch/StructuralPanel.jsx).
  • src/components/optics/OpticsDesignPanel.jsx — 42 optics LLM tools in 5 tabs (src/components/optics/OpticsDesignPanel.jsx).
  • Civil 3D viewport components: src/components/civil/TINView.jsx, src/components/civil/PipeNetworkView.jsx, src/components/civil/GradingPlanView.jsx, src/components/civil/LandscapeView.jsx (src/components/civil/).
  • HVAC design panels: HVACLoadPanel, DuctDesignPanel, EquipmentSelectPanel (src/components/hvac/).
  • Visual node-graph scripting (Dynamo/Grasshopper equivalent) (src/components/nodescript/NodeGraphCanvas.jsx).
  • WebGPU spectral path-tracer page (src/components/render/PathTracerCanvas.jsx).

Materials

  • Ashby material selection: catalog + performance indices + Pareto front + multi-objective scoring (packages/kerf-cad-core/src/kerf_cad_core/materials/ashby_selection.py).

Motion / dynamic simulation

  • Multi-body dynamics: Featherstone recursive Newton-Euler inverse dynamics, integrator (RK4/semi-implicit Euler), forward + inverse kinematics, joints, contact + friction (packages/kerf-motion/).
  • Craig-Bampton flexible-body MBD: modal-synthesis reduction for FEA mode shapes; Pacejka Magic Formula tire model (Adams/Car parity); Litvin gear/belt machinery dynamics (Adams/Machinery parity) (packages/kerf-mates/src/kerf_mates/mbd/).
  • CCD + FABRIK inverse-kinematics solvers + pole-target support (packages/kerf-cad-core/src/kerf_cad_core/animation/ik_solver.py).
  • Mechanism synthesis: four-bar Burmester graphical synthesis, cam-follower profile generator, gear-train ratio synthesis (packages/kerf-mates/src/kerf_mates/synthesis/).
  • Animation system: keyframe FCurves with bezier/cubic-Hermite/cyclic interpolation, armature poser with cascading parent matrices (packages/kerf-cad-core/src/kerf_cad_core/animation/).

2026-05-26 / 2026-05-31 — Wave 7A–7D

Key additions from the wave-7 push:

  • Wrapper-module consolidation — collapsed 8 thin *_tools.py wrapper files into their core modules using gated-import pattern; ~1,750 LOC saved.
  • FMI 2.0 model export (.fmu) — CoSimulation + ModelExchange capability, modelDescription.xml, C source wrapper (packages/kerf-1dsim/src/kerf_1dsim/fmi_export.py).
  • Tilted-surface PV irradiance — Liu-Jordan, Hay-Davies, Perez 1990 5-coefficient models; optimal annual tilt; latitude-aware TMY3 monthly factors (packages/kerf-energy/src/kerf_energy/pv_irradiance.py).
  • ASME B31 pressure-loss + Crane TP-410 K-factors — Darcy-Weisbach + Colebrook-White; Hooper Two-K method; 15-entry K-factor table (packages/kerf-piping/src/kerf_piping/asme_pressure.py).
  • Piping wall thickness (ASME B31.1-2022) — §104.1.2 Eq. 7 sizing, B36.10M schedule recommendation, Table A-1 allowable stress lookup, thermal stress (packages/kerf-piping/src/kerf_piping/wall_thickness.py).
  • Motion inverse dynamics — Featherstone 2008 §5.3 recursive Newton-Euler; gravity compensation; trajectory vectorisation (packages/kerf-motion/src/kerf_motion/inverse_dynamics.py).
  • NURBS Fresnel parameterisation — curvature grows linearly with arc-length (clothoid/Euler spiral law); monotone Fresnel-C drive (packages/kerf-cad-core/src/kerf_cad_core/geom/fresnel_parameterize.py).
  • NURBS surface cross-section — planar intersection polyline via signed-distance grid walk + bisection refinement (packages/kerf-cad-core/src/kerf_cad_core/geom/surface_cross_section.py).
  • Gauss-Bonnet integrity + chord-deviation — gauss_bonnet_residual + chord_deviation_per_face; subd_verify_gauss_bonnet LLM tool (packages/kerf-cad-core/src/kerf_cad_core/geom/surface_analysis.py, packages/kerf-cad-core/src/kerf_cad_core/geom/subd_gauss_bonnet_check.py).
  • SubD limit integrals — exact global area + mean-curvature + Gaussian-curvature integrals over CC limit surface; Gauss-Bonnet 4π oracle for χ=2 sphere (packages/kerf-cad-core/src/kerf_cad_core/geom/subd_limit_integrals.py).
  • Irrigation sprinkler layout — Hunter/Rain Bird/Toro catalogue; square/triangular/oblong spacing; GPM zone demand (packages/kerf-landscape/src/kerf_landscape/irrigation_design.py).
  • HVAC AHRI equipment catalogue — 30 AHRI-certified models across 6 categories with part-load curves (packages/kerf-hvac/src/kerf_hvac/ahri_catalogue.py).
  • Civil infrastructure UI — TINView, PipeNetworkView, GradingPlanView, LandscapeView viewport components.
  • HVAC design UI — three panels wired to HVAC backends for .hvac.load, .hvac.duct, .hvac.equip file kinds.
  • PV latitude-aware TMY — TMY3-derived monthly irradiance fractions, hemisphere flip, 29 hermetic tests (packages/kerf-cad-core/src/kerf_cad_core/solarpv/tmy.py).
  • Multiple electronics tools — optocoupler CTR/isolation, Zener TC drift, Zener clamp design, op-amp offset drift, inductor core saturation, MOSFET SOA check, LDO dropout checker, buck converter ripple, EMI filter design, PCB trace/via current (IPC-2221B/2152), wire ampacity derating, fuse I²t verification, NEC voltage-drop and circuit-protection checks (packages/kerf-electronics/src/kerf_electronics/).
  • Multiple mold tools — runner diameter, warpage index, cooling pressure drop, MFR injection-speed check, sprue bushing match, turbulent Re check, core-pin cooling, ejector pin buckling, tunnel gate design, surface finish (SPI A1–D3), color concentrate ratio (packages/kerf-mold/src/kerf_mold/).
  • GD&T depth — GK-P12/P13/P14 SubD Stam limit tangents, G1 extraordinary patches, fractional crease decay; composite tolerance frames (ASME Y14.5-2018 §10.5); datum precedence warnings; circular/total/axial runout checks; composite positional tolerance; dimension chain (WC + RSS); datum shift bonus tolerance (packages/kerf-cad-core/src/kerf_cad_core/gdt/, packages/kerf-gdnt/src/kerf_gdnt/).
  • Architecture structural tools — base plate (AISC DG-1), beam deflection (Roark 9e), column load (AISC §E3 + ACI 318-19 §22.4), footing bearing (Meyerhof 1963), slab deflection (Kirchhoff), diaphragm shear (SDPWS-2021), anchor bolt pullout (ACI 318-19 §17.6), bolt shear (AISC §J3), stair stringer (IBC 2021 §1011), slab-on-grade (Westergaard 1948/PCA EB119), opening-in-wall (IBC §2308.4), lintel design (AISC/ACI/TMS), bearing wall axial (ACI §11.5.3/TMS §8.3), pier axial (TMS §8.3/ACI §22.4.2.2), retaining wall stability (Rankine), shear wall OOP (ACI §11.7), punching shear (ACI §22.6), lateral bracing (AISC §F2) (packages/kerf-cad-core/src/kerf_cad_core/arch/).
  • ArchiCAD-class stair code check — IBC 2024 §1011, ADA §504.2, ICC A117.1 §504, Ontario OBC §9.8 per-clause enforcement; Blondel 2R+T formula; vertical-rise-between-landings check; arch_check_stair_codes LLM tool + StairCodeSpec/StairCodeReport dataclasses; StairView code-check card with jurisdiction dropdown, per-category badges, violations table, and code-summary sticker export (packages/kerf-cad-core/src/kerf_cad_core/arch/stair_code_check.py, src/components/StairView.jsx).
  • BIM additions — COBie 2.4 deliverable, BCF issue manager + markup/redline, drawing list / multi-sheet manager, BIMcloud-lite element locks, HVAC plant simulation depth (packages/kerf-bim/).
  • cad_component real geometry substitution — JSCAD model_3d + STEP model_3d_paths render real geometry in CircuitEditor 3D tab; per-SHA cache.
  • CAM turning depth — optimal DOC per pass + roughing-pass count for lathe turning; Sandvik CoroPlus material max DOC ranges (packages/kerf-cam/src/kerf_cam/turning_depth_calc.py).

2026-05-20 / 2026-05-25 — Phase 6 domain-depth (Waves 1–7)

Prior to the current saturation push, the following major capabilities landed:

Superseded (historical record). The cloud/billing/pricing/OAuth items below reflect the architecture at that date. They were retired by the 2026-07-17 "Decentralized node model" ADR further down this file: billing and the cloud tier are gone, Kerf is 100% MIT with no accounts, and sign-in via Google OAuth was removed. The "auth-optional local mode" below went too: POST /auth/bootstrap-local handed a full session to anything that could reach the port, and a node now has one password set on first load. This block is kept as history, not as a description of the current build.

Core platform

  • Auth + projects + files + chat (CRUD) — Postgres, JWT, Google OAuth.
  • Plugin monorepo (packages/kerf-*) — kerf-core app factory + entry-point loader; 25+ plugin packages; 1000+ tests.
  • Single-binary build + brew/curl install — embedded Vite SPA (~32 MB).
  • Auth-optional local mode (POST /auth/bootstrap-local).
  • Cloud: workshop sharing, billing, LLM pricing, free/paid/BYO buckets + wallet — USD-display, credits at cost.
  • Cloud: git (commits/branches/merge/GitHub sync) + git Storer.
  • Large-file git handling — pointer kind, Phase 1.
  • Diff-based + compressed revisions — 82× shrink.
  • Workspaces (orgs), activity timeline, avatars/CDN, collapsible chat.
  • E2E Playwright + per-plugin pytest suites.
  • Billing-ledger schema on fresh databases.

Scripting / SDK

  • .script.py via kerf-sdk — /v1/rpc JSON-RPC over the LLM tool registry; API tokens; PyPI publish.
  • SDKs: Python, TypeScript, Rust, Go, Lua — same /v1/rpc wire format.

Parametric core

  • Equations / global parameters — .equations, mathjs.
  • Configurations / variants — per-file param overrides, BOM rollup.
  • Materials database — .material kind, 200+ seeded materials.
  • Two coexisting kernels — .jscad (mesh) + .feature (OCCT BRep), shared .sketch / .assembly / .drawing.
  • Pure-Python B-rep + NURBS kernel — validated Body topology, tolerant booleans, G1/G2/G3 fillets, closest-point, hardened SSI, parametric history DAG with persistent face naming.

Geometry kernel

The pure-Python kernel (packages/kerf-cad-core/src/kerf_cad_core/geom/) matches Rhino/Blender-class construction depth with an analytic foundation. Key modules:

Module Capability
packages/kerf-cad-core/src/kerf_cad_core/geom/brep.py Radial-edge B-rep topology; nine Euler operators; Euler-Poincaré invariant
packages/kerf-cad-core/src/kerf_cad_core/geom/boolean.py Tolerant pure-Python solid booleans (cut/fuse/common) + general NURBS×NURBS path
packages/kerf-cad-core/src/kerf_cad_core/geom/fillet_solid.py / packages/kerf-cad-core/src/kerf_cad_core/geom/chamfer.py G1/G2 surface blend; edge fillet; variable chamfer; G3 blend chains
packages/kerf-cad-core/src/kerf_cad_core/geom/surface_analytic_derivatives.py Piegl-Tiller A3.6/A4.4 analytic derivatives; curvature; SSI marcher
subd/ CC subdivision; Stam limit tangents; G1 extraordinary patches; fractional creases; Loop/Doo-Sabin/Modified-Butterfly variants; SubD→NURBS (Loop-Schaefer 2008); sculpt brushes; multires displacement; feature-curve extraction; geodesic heat method; mirror symmetry; deformation cage (Ju 2005)
packages/kerf-cad-core/src/kerf_cad_core/geom/sdf_csg.py / packages/kerf-cad-core/src/kerf_cad_core/sdf/marching_cubes.py SDF CSG smooth-blend + Lorensen-Cline 1987 polygonisation
packages/kerf-cad-core/src/kerf_cad_core/geom/loft_guide_rails.py Guide-rail loft (Rhino-parity); closed_v=True periodic skinning (P&T §9.4.5)
packages/kerf-cad-core/src/kerf_cad_core/sheetmetal_features.py Flat-pattern (K-factor, DIN 6935); hem/jog/multi-flange (Suchy §6)
packages/kerf-cad-core/src/kerf_cad_core/geom/uv_unwrap_hardening.py LSCM UV; seam-cut chart pack; shelf bin-packing; distortion stats
packages/kerf-cad-core/src/kerf_cad_core/geom/match_srf_g3.py MatchSrf G3 boundary continuity
packages/kerf-cad-core/src/kerf_cad_core/geom/subd_limit_integrals.py Exact CC limit area + curvature integrals; Gauss-Bonnet verifier
packages/kerf-cad-core/src/kerf_cad_core/geom/curve_fit_g2.py Degree-5 G2 end-condition B-spline curve fit (P&T §9.4)
packages/kerf-cad-core/src/kerf_cad_core/scan/nurbs_fit_tools.py Freeform NURBS fit from point cloud + Hausdorff oracle
packages/kerf-cad-core/src/kerf_cad_core/drawings/brep_hlr.py B-rep → 2D Hidden-Line Removal for technical drawings

Full list of 139+ GK modules in packages/kerf-cad-core/src/kerf_cad_core/geom/.

Mechanical / CAD

  • Assembly: motion interference sweep over multi-body timeline; LOD planner + lazy-load.
  • GD&T suite: runout (circular/total/axial), datum shift, composite tolerance frames, dimension chain stack-up, datum reference frame validator, feature-of-size DOF, datum precedence consistency.
  • CAM: turning depth calculator, milling toolpath, G-code post-processor, lathe cycle simulation.
  • Sheet metal: flat-pattern, hem/jog/multi-flange, DXF export.
  • Wiring harness: 3D auto-routing (voxel A*), formboard flatten, NEC ampacity + voltage-drop checks.
  • FEM: linear static + modal + buckling + harmonic + PSD + acoustics + EM + fatigue (S-N / Coffin-Manson, rainflow, Goodman/Gerber/SWT mean-stress) + explicit dynamics (central-difference leapfrog, CFL time-step) + 3-D nonlinear static (H8 B-bar, Total-Lagrangian, J2 plasticity, Riks arc-length) + thermal (steady 1-D slab + fin efficiency + transient) + solid tet/hex elements (Tet4/Tet10, H8 B-bar, Wave 11B4) + coupled-field probabilistic (LHS + Karhunen-Loève). Honest outstanding: J2/Drucker-Prager/Hill plasticity in full 3-D solid, thermal-structural coupling, composite layered shells (Tsai-Wu), contact mechanics (Hertz/penalty method), fracture mechanics (J-integral/XFEM).

Simulation / manufacturing

  • CFD: RANS k-ε + k-ω SST + wall functions; 3-D tet mesher; OpenFOAM export bridge; combustion EBU; Lagrangian particles; ALE/FSI; snappyHexMesh-style mesher; ASCE 7-22 wind engineering; Bearman vortex shedding; compressible Roe flux; conjugate HT; VOF multiphase; Holtrop-Mennen marine resistance.
  • Mold: Hele-Shaw fill simulation + Cross-WLF rheology; runner optimisation; warpage index; cooling (pressure drop, turbulent Re, core-pin design); ejector-pin buckling; tunnel gate; sprue bushing match; surface finish (SPI A1–D3); parting-line detection + cavity-core split; Cimatron quote-to-delivery.
  • Manufacturing: tolerance stack-up; CMM path planning; process-capability (Cpk/Ppk); DFM checklist.

Electronics

  • PCB editor with push-shove routing + diff-pair tuning.
  • BSIM4 + PVT corner MC + multi-dialect netlist codegen (SPICE foundry parity).
  • Altium MB3D multi-board workspace + inter-board net mapping.
  • LTspice-equivalent schematic capture GUI.
  • openEMS FDTD XML bridge for RF routes (single straight-trace).
  • Component analysis: MOSFET SOA, LDO dropout, buck ripple, EMI filter, zener clamp/TC, optocoupler CTR, op-amp offset drift, inductor saturation, PCB trace/via current, fuse I²t, NEC wire ampacity + voltage drop + circuit protection.
  • ECAD import: KiCad, Altium, Allegro, PADS, gEDA, Eagle.

Architecture / BIM

  • Full structural tool suite: 18 arch_* tools (beam, slab, wind, footing, connections, walls) per AISC 360-22, ACI 318-19, ASCE 7-22, TMS 402-22, IBC 2021.
  • kerf-structural package: AISI S100-16 cold-formed steel (effective-width, flexure, compression, web-crippling) + TMS 402-16 masonry ASD (flexure/shear/axial) (packages/kerf-structural/src/kerf_structural/cold_formed_steel.py, packages/kerf-structural/src/kerf_structural/masonry.py).
  • 8760-hr ASHRAE energy sim + Title 24 (16 CA zones) + LEED v4 EAp2.
  • HVAC: AHRI catalogue, plant simulation (chiller/boiler/VAV), duct sizing, equipment selection.
  • BIM: COBie 2.4, BCF issue manager, drawing-list manager, BIMcloud-lite element locks, IFC import, AVEVA piping ASME B16 catalogue, multi-discipline plant federation.
  • Civil: dynamic TIN (Bowyer-Watson Delaunay), Manning gravity pipes, Hazen-Williams pressure pipes (Hardy-Cross), parcel subdivision, plan-and-profile sheets.

Aerospace / composites

  • CR3BP libration orbits (halo / Lyapunov / Lissajous); batch LS + EKF orbit determination; GMAT 3D trajectory viewer.
  • OpenRocket RASP .eng motor DB.
  • FiberSim AFP/ATL fibre-placement paths + laser projection + flat-pattern DXF.
  • Structural analysis hooks (FEM tet/hex solid).

Library / parts / BOM

  • Parts library + BOM + distributor pricing — Octopart + DigiKey + Mouser price look-up, BOM rollup.
  • substitute_component LLM tool — library-mapped real geometry in 3D tab.
  • Ashby material selection: catalog + performance indices + Pareto front.

Frontend / UX

  • src/components/arch/StructuralPanel.jsx, src/components/optics/OpticsDesignPanel.jsx, HVACLoadPanel, DuctDesignPanel, EquipmentSelectPanel.
  • Civil 3D viewports: TINView, PipeNetworkView, GradingPlanView, LandscapeView.
  • Visual node-graph scripting (Dynamo/Grasshopper equivalent): src/components/nodescript/NodeGraphCanvas.jsx.
  • PLM Configurator + SysML Trace UI panels.
  • WebGPU spectral path-tracer page.
  • GMAT 3D trajectory viewer (Three.js).
  • PCB interactive editor + schematic capture.
  • Class-A continuity viewport toggle (zebra stripes + G2/G3 per-edge audit panel).

In flight / soon

  • G1…G4 active program (T-500 … T-559) — TypeScript revamp, unified ECAD IR, FreeCAD round-trip, WebGPU + interop writers. See Active program above; opened 2026-08-05.
  • P0-8 testing / seeding / deploy-hardening — broad test suites + realistic seed data + one-command local/dev loops.
  • P1-8 Git-as-substrate with automatic large-file handling — every project a stock-git clone-able repo; near-instant forks via shared content-addressed storage.
  • P1-9 Unified pip install kerf client — cloud-default, easy optional self-host.
  • T-101 CFD depth — LES/DES/DNS, parallel MPI execution, ParaView/VTK post-processing bridge, marine hydrodynamics at depth.
  • Koyeb migration (T-400..T-410) — Fly.io GPU fleet killed; Koyeb code complete; T-405 DNS/secrets/deploy cutover needs user action.
  • Large-assembly DMU — LOD heuristics use synthetic estimates; wiring to real tessellated part geometry would sharpen tier boundaries.

Genuinely outstanding

Items verified against public/compare-manifest.json as partial or no with no shipped backend:

Partial (29 items)

  • solidworks — Moldflow injection fill simulation (1235-record manifest shows partial; Hele-Shaw 1.5D shipped, full 3D not)
  • solidworks — Material selection Ashby / multi-objective (catalog + indices shipped; UI multi-criteria not fully wired)
  • aveva-e3d — Piping component catalogue (ASME B16 catalogue partial; full E3D spec depth pending)
  • aveva-e3d — Multi-discipline plant design structural/HVAC/civil (federation shipped; deep E3D-style concurrent authoring pending)
  • aveva-e3d — Global multi-user concurrent design
  • cimatron — Quote-to-delivery workflow (ISA-95 state machine shipped; full ERP bridge pending)
  • fibersim — Laminate weight / cost estimation
  • maxsurf — Structural scantlings (Lloyd's / DNV / BV / ABS rules)
  • mozaik — Woodworking cut-list / joinery / grain (cabinet layout shipped; full cut-list optimiser pending)
  • cadence-spectre / hspice — SPICE commercial foundry PDK sign-off accuracy
  • adams — FEA load export bridge
  • openfoam — CFD LES/DES/DNS, parallel MPI, ParaView/VTK post-processing, marine hydrodynamics
  • zemax — Tolerancing (NEST / Monte Carlo)

No (1 item)

  • matrixgold — Jewelry supplier catalog integration

Code health

Incremental refactors recorded here for traceability.

Date Change LOC saved
2026-06-01 Consolidated packages/kerf-cad-core/src/kerf_cad_core/geom/sweep1.py (previously three separate files: geom/sweep1.py + geom/sweep2.py + geom/sweep_n.py, now deleted) into a single file with unified sweep_along_rails dispatcher; backward-compat wrappers kept; deleted 2 source files + 1 test file. ~300 LOC
2026-06-01 Collapsed 8 thin *_tools.py wrapper files (assembly_interference_tools, face_planarity_tools, brep_connect_inspector_tools, offset_far_tools, network_surface_tools, topology_euler_check_tools, vertex_degree_check_tools, bolt_shear_aisc_tools) into their core modules using gated-import pattern. ~1,750 LOC

Deliberately not building

This list is only AI-redundant authoring/UX interaction paradigms — not skipped domains or correctness features.

Not building Why
Ribbon / toolbar maximalism The LLM is the command palette — discovery is a chat sentence, not a menu hunt.
Macro recorders / scripting-GUI builders The LLM is the macro author; it writes .script.py directly.
Gumball / direct-modeling maximalism Keep a basic gumball; the LLM edits the feature tree.
In-app wizards / tutorials / onboarding tours The chat is the wizard — context-specific guidance on demand.

How to contribute

Pick an open issue, or open one proposing a new long-tail sector line. This roadmap states why and in what order; the issue tracker carries the how.

Decentralized node model

Decided 2026-07-17, final form same day (full rationale + rejected alternatives in decisions.md — see both the morning ADR and the superseding "Final form" ADR). Kerf decentralizes: one node type, no billing anywhere, users bring their own boxes, Workshop federates over the DMTAP-PUB protocol.

Every kerf install — a homelab "big PC," a self-hosted server, kerf.sh itself — is a full node: client (embedded frontend), project storage, git/LFS hosting, Workshop serving, worker orchestration. There is no "cloud edition" vs "local edition," no proprietary sliver, no dual license. Kerf is 100% MIT. kerf-billing and kerf-pricing are deleted, LICENSE-CLOUD is removed — there is nothing left to buy inside kerf. Users self-provision their own hardware/VPS ("bring your own box"); Vulos (the umbrella org, github.com/vul-os) offers tooling that facilitates provisioning that user-owned infra but never intermediates it. The only things anyone pays for, anywhere in this stack, are the VulOS-standard reachability broker Ephor (rented uptime) and backup buckets (durable storage) — both sold at the VulOS layer, not by kerf, per the standard VulOS product shape every ecosystem project uses. kerf.sh itself is one gateway among equals, not a privileged authority.

Zero-socket invariant. With no endpoint configured and no feed followed, kerf never opens a socket. A fresh local install is inert on the network by default — no phone-home, no default-on federation, no listener until the owner configures one.

Local-first telemetry, not metering-to-invoice. With no metered service, service-boundary enforcement is moot. What survives on purpose: a node meters its own bytes / GPU-seconds / bandwidth for its own owner's dashboard — useful when a team shares one box and wants usage visibility. Computed and stored on the node, never phoned home, never identity-linked to any central biller.

Workshop federation on DMTAP-PUB, via kerf-pub. Protocol: github.com/vul-os/dmtap (§22 public-objects extension + §23 CAD/artifact profile) — one object model, transport-agnostic. New MIT package packages/kerf-pub/ implements it behind four verbs: publish (manifest → sign → append to feed), fetch (resolve a content address to bytes), resolve (follow a feed/identity to current announcements), submit (hand a listing to a rebuildable, non-authoritative index). Plain HTTPS is a complete implementation of all four verbs — no adapter required to ship. IPFS is a possible later fetch-adapter; Nostr is a possible later announce-mirror; neither is, or ever becomes, kerf's native multi-protocol ground truth. Identity is user keypairs. A part/artifact is a plaintext content-addressed Merkle-DAG manifest (global dedup; kerf's sha256 LFS objects coexist via the multihash agility prefix). A "workshop" is a set of followed feeds; kerf.sh's workshop feed ships as the removable default. Assemblies reference sub-parts by content address — BOM resolution is a tree walk, dedup composes. Public parts are plaintext-addressed; private projects stay encrypted (dedup scoped to key holder). Everything is offline-verifiable — signed, content-addressed objects survive with zero live infrastructure (sneakernet / apocalypse / Mars-latency safe; store-and-forward, no interactive round trips required).

Availability UI. The client surfaces one of four honest states per part/artifact: on-node (bytes present, no network needed), available (N holders, last-verified ) (known reachable from the feed graph, not fetched yet), stale (past the verification threshold, unconfirmed), or unreachable (tried and failed) — each non-on-node state carries a Pin action. Pinning both makes the object durable for the pinning owner and starts serving it to others — durability and commons-serving are the same act.

Frontend stays React. The existing large React CAD frontend is kept; a Svelte rewrite was considered same day and rejected as churn without user value.

Phase What Status
P0 kerf-pub package (publish/fetch/resolve/submit over plain HTTPS) + total billing removal (kerf-billing/kerf-pricing/LICENSE-CLOUD deleted) + VulOS-standard docs/landing updates. ✅ shipped 2026-07-18
P1 Workshop UI rewire onto kerf-pub feeds + on-node/available/stale/unreachable availability badges + Pin action + user keypair onboarding; local git API + remotes UI (no OAuth); hosted-git/OAuth/email stripped from kerf-cloud. ✅ shipped 2026-07-18
P1b Pin hydration (gateway swarm fetch, verify-and-rotate, partial-state reporting + retry) + IPFS chunk fetch-adapter (CIDv1-raw over the same multihash, untrusted-gateway self-verification) + assembly publish (AssemblyStructure blobs, pin/track children, BOM walk with cycle rejection) + dead hosted-git/workshop/billing DDL removal + retired email call sites (accounts auto-verify; password reset via kerf admin reset-password one-time link). ✅ shipped 2026-07-18
P2 Mesh transport (dmtap native) + MLS private team folders — dependency-blocked on the Envoir dmtap node existing, not demand-deferred: the object layer is done; these are transports/crypto that slot underneath it when the reference node ships. ⛔ blocked (upstream dependency)

Reversibility: the durable commitment is the data model — keys, signatures, content addresses, git/LFS coexistence via the multihash prefix. Transports (HTTPS now, mesh/IPFS-adapter later) and packaging (single-binary now, Tauri later) stay swappable underneath it without another rewrite.