ZFORGE · SEAM INSPECTOR · MMXXVI
GEOMETRY · INTELLIGENCE · FRAMEWORK

SEAM
INSPECTOR

See the spectral atlas of your mesh.

Every junction, every chart, color-coded by the math the dispatcher actually runs.

MIT LICENSE BLENDER 4.0+ PURE NUMPY

FREE · NAME YOUR PRICE

§ 01 / 02

What ships

Seam Inspector — Gumroad Product Listing

Product Name

Seam Inspector — See Your Mesh's Spectral Atlas (Free Blender Addon)

Price

$0+ (Name Your Price / Free)

Thumbnail

Use nostromo-deep/spectral/spectral-atlas.svg on #070809 background with "SEAM INSPECTOR" in deep violet (#5A3A8B).

Short Description

Free Blender addon that color-codes every junction on your mesh by topological complexity. Powered by the same dispatcher that runs HolyGrail Auto-Retopo internally. The math substrate behind the entire ZForge suite, exposed as a one-button diagnostic.

Full Description

What it does

Select your mesh. Hit one button. See:

  • Every junction in your mesh, colored by valence (the number of charts meeting at that vertex)
  • Which junctions the dispatcher will route to the classical Hermite blend (valence ≤ 3 — well-determined, no problem)
  • Which junctions require the implicit fusion cell (valence ≥ 4 — the math gets harder, the dispatcher handles it)
  • Per-junction tangent residuals, with verdicts pass / soft_fail / hard_fail

This is the diagnostic surface for the Phase 20A geometry compiler. Free forever. Drives premium adoption: HolyGrail Auto-Retopo and Topo Doctor both consume the same dispatcher internally — Seam Inspector is the math-credibility hook.

The math (one paragraph)

The Morse identity #max − #saddle + #min = χ(M) holds unconditionally on any Morse eigenfunction of the mesh Laplacian. This means your mesh's spectral atlas — the graph of Neumann domains the dispatcher reads — has a junction count that is topologically protected: it cannot change under small noise. This is a proven theorem (PROVEN_THEOREM in the gated claim_ledger.yaml), backed by Banchoff (1970) and Poincaré-Hopf. Seam Inspector is the operational form of this fact.

How to use it

  1. Install the addon (Edit > Preferences > Add-ons > Install from File)
  2. Select any mesh
  3. Open the N-Panel > ZForge > Geometry Compiler — Phase 20A
  4. Click "Dispatch Atlas" — see every junction listed with its valence + chosen path
  5. Click "Execute" on a junction — get the verdict + tangent residual

For artists who want to see the math: try the helmet_patch fixture from the demo file. Its degree-3 junctions on a spherical dome produce real tangent residuals (~1.015 hard_fail, ~0.528 soft_fail) — the dispatcher correctly catches them.

The math substrate

Seam Inspector is the public face of the Phase 20A geometry compiler, a 12-claim evidence-base research-to-production arc (S1 → S6 + Phase 20A.1–20A.5, 2026-05-22 → 2026-05-24). The full inventory:

  • 5 PROVEN_THEOREM claims: spectral non-equivalence (Prop 2.1), Morse-Smale extraction (Banchoff/EHZ), Neumann-domain construction, isometry invariance, the caveat-free Morse identity (the headline)
  • 7 PROVEN_DEMONSTRATED claims: eigenfunction selection, §8 falsification gate (LAYER outcome on the §7.3 corpus), position/boundary stability, N-way fusion-cell prototype, integral G² solvability (9–15% E_G² reduction), fusion-cell associativity, operator commutativity

The dispatcher itself: dispatch_atlas → execute_seam_decision with a 4-path fallback cascade (enlarge → relax_to_g1 → singularity → ask_artist) per the §3.1 verdict_logic.

What's under the hood

Built on zforge-core (free, MIT, pip install zforge-core). Same math engine as TopoGuard, ConformalUV, QuadFlow, HolyGrail.

  • Pure NumPy — no compiled extensions, no CUDA
  • 28/28 tests passing on Phase 20A dispatcher + executors
  • 118/118 tests passing on the research substrate (spectral_lotus/)
  • 0 errors / 0 warnings from anchor_check.py (every cited claim resolves at the recorded tier)

Requirements

  • Blender 4.0+
  • Python 3.10+ (ships with Blender)
  • NumPy (ships with Blender)
  • No additional dependencies

Cross-DCC plans

DCC Status
Blender This is the Blender release
Maya 2024+ Port planned (P1 priority; tracking in CROSS_DCC_MIGRATION_ROADMAP.md)
Unreal Engine 5 Subprocess bridge planned (P3 priority)

Why it's free

The math substrate is the entire ZForge product line's foundation. Giving the diagnostic away builds the math-credibility funnel: artists who see the spectral atlas working become candidates for the premium products that act on it.

  • HolyGrail Auto-Retopo ($79 / $149) — consumes the same dispatcher for full automated retopology
  • Topo Doctor ($29) — uses the fallback cascade (enlarge → relax_to_g1 → singularity → ask_artist) as its repair toolkit
  • ZForge Suite ($99 bundle) — the whole catalog

Changelog

v0.1.0 — Initial release (2026-05-24)

  • Phase 20A dispatcher + 4 executors + fallback cascade
  • Per-junction valence + verdict display
  • Live diagnostic at hit-button cadence
  • 28/28 production tests + 118/118 substrate tests pass
  • Anchor check: 0 errors / 0 warnings

Tags

blender, addon, topology, mesh-analysis, retopology, free, geometry, math, spectral, junction-analysis

File

seam-inspector-v0.1.0.zip (Blender addon zip — depends on zforge-core, vendored via wheelhouse)

Suggested cross-sell

  • HolyGrail Auto-Retopo ($79 / $149) — automation built on the same dispatcher
  • ZForge Suite ($99) — all 10+ tools

Provenance

  • Substrate: Zforge/research/spectral_lotus_fusion/ (12 PROVEN claims, gated by claim_ledger.yaml)
  • Production: Zforge/packages/zforge-core/src/zforge_core/topology/{fusion_seam,seam_*}.py
  • Anchoring discipline: Zforge/research/spectral_lotus_fusion/PHASE_20_ANCHORING_HANDOFF.md
  • Frozen contracts: Zforge/research/spectral_lotus_fusion/CONTRACTS.md §§2.1, 2.2
  • Phase 20A ship docs: PHASE_20A_DISPATCHER_SHIPPED.md, PHASE_20A_EXECUTORS_SHIPPED.md
§ 02 / 02

Get it

Primary
Gumroad
Available now on Gumroad. Lifetime updates.
Free + Open
zforge-core
Same math substrate. MIT-licensed Python package.
▸ Live · pip install pypi →
DCC marketplace
Unreal · ArtStation
Planned MotionMacro pack + reference frames.
Coming soon Watch this space