# FML Garage — equipment and repair visualization library

Brand: **FML Garage / fmlgarage.com**. The local website starts at **http://127.0.0.1:8765/**. The website is live at **https://fmlgarage.com/**, deployed through cPanel File Manager into its domain folder. HTTPS, catalog search, and both model viewers were verified on 2026-10-04.

The homepage provides an equipment directory, searchable assembly library, and links to machine and reusable engine viewers. New equipment categories and library entries belong in `data/catalog.json`; viewer asset paths, titles and machine/engine relationships belong in `data/viewer-models.json`. Empty categories are labeled as forthcoming, rather than displaying invented repair guides.

## Ariens ST824 addition

The new reference is **Ariens 924050 ST824, serial 027001–036500**, with the factory-listed **Tecumseh HM80-155128F**. Ariens OEM manual024449E identifies the engine; PM-24-83 establishes the later serial036501-and-up revision with a different HMSK80 engine. These references are kept separate. The machine and exact-spec engine are independent projects in `machines/ariens-st824/` and `engines/tecumseh-hm80/`.

Open `viewer/?model=ariens-st824` for the snowblower and `viewer/?model=tecumseh-hm80` for its detailed engine. The engine remains one exterior assembly during the machine explosion; its internal/service parts are explored in the linked subview. The exact factory engine mapping is documented, but physical mounting dimensions and most geometry remain estimates. Existing Craftsman and HS40 models and legacy viewer links remain available.

The interface uses an original industrial design, informed by the repair-library navigation and equipment browsing on [iFixit](https://www.ifixit.com/). Existing machine and engine geometry, source provenance, and export contracts remain intact.

## Craftsman 4/21 prototype

Target: **C950-52474-5**, 4 HP, 21-inch two-stage snowblower. The requested series had no specified suffix. Revision -5 was chosen after locating a complete OEM illustrated manual and photographs showing an exact -5 model plate. The initially considered -7 manual proved to be an incomplete five-page excerpt. See `research/notes/revision-audit.md` for evidence and unresolved revision differences.

## Try the prototype

The reusable engine subview is available at **http://127.0.0.1:8765/viewer/?view=engine**. Select ENGINE in the snowblower and choose its detailed view, or use the engine navigation link. Return navigation opens the snowblower. The standalone asset is in `engines/tecumseh-hs40/`; `engines/registry.json` separates shared engine identity from machine-specific mounting and external connections.

The engine reference is **HS40-55546J**, mapped by Tecumseh's OEM cross-reference to the photographed Sears **143.754122**. The alternate manual number **143.744102** maps to **HS40-55546H**. HS40/HSK40 denotes the reusable project family, not interchangeable parts or identical specifications. HSK40 comparison documentation remains separate. The snowblower's existing exterior proxy remains in its own GLB; the detailed subview loads the standalone engine GLB.

Run `./launch_viewer.ps1` in PowerShell, then open **http://127.0.0.1:8765/viewer/**. The server binds only to localhost. All viewer dependencies are bundled locally; no API key, network service, or build step is required.

Drag to orbit, scroll to zoom, and click a component or parts-list row. Use the slider for four stages: major assemblies, covers, service parts, and minor hardware. Filter/isolate a subsystem, isolate or focus a part, search names or original OEM numbers, and see through covers. Restore with Show all in the inspector or by choosing Entire machine and clearing Isolate subsystem.

In **Blender**, open `blender/machine.blend`. Timeline frame1 is assembled, frame120 fully exploded. Frames1–30 separate assemblies;31–60 open covers;61–90 separate service parts;91–120 separate modeled washers/shear bolts. Each component is named, selectable, and carries custom metadata.

## Included

49 meaningful selectable objects across seven assemblies: chassis; engine exterior; handle/controls; drive system; auger system; chute system; wheels. Common service parts include mirrored augers, shaft, gearbox housing, impeller/shaft, auger bearings, washers, shear bolts, scraper, runners, belts, pulleys, friction wheel/disc, axle/gear, wheels, chute, and crank. The engine is one exterior proxy, not internal engine CAD.

48 objects have original OEM part-number mappings; the engine has no asserted replacement number because the source variants differ. Some rows represent members of complete assemblies. The parts inventory is not a purchasing bill of materials.

## Deliverables

- `blender/machine.blend` — editable scene, logical collections, metadata, staged timeline.
- `exports/machine.glb` — assembled web model with separate named nodes and extras.
- `exports/machine.gltf` and `machine.bin` — equivalent separate glTF export.
- `exports/parts.json` — component identity, confidence, source pages, assembled/exploded transforms, local stage offsets.
- `exports/assemblies.json` — assembly stage offsets for the viewer.
- `data/assemblies.json` — documented hierarchy and membership.
- `research/source_register.json` — source URLs and local reference locations.
- `validation/issues.md` — uncertainties, exclusions, research gaps.
- `validation/renders/` — front, rear, left, right, top, three-quarter, and exploded three-quarter.
- `viewer/` — local interactive prototype, Three.js 0.180.0 and MIT license included.

## Evidence and confidence

Primary structural source: Sears Canada owner manual, **part no.5559**, explicit -5 family, hosted by ManualMachine. Printed pp13/14 drive diagram/table, pp15/16 auger housing diagram/table, pp17/18 handle and gearbox diagram/table. Reference scan indices are printed page +2. Relevant pages are stored for internal research, not embedded in the final viewer.

Secondary recognition source: Wild Rose Auction lot122, photographs with a readable -5 plate and engine stamp143.754122. Used for silhouette, relative proportions, silver/black housing and chute, orange-red engine, black handles/tire, and simple recognition text. Wear and rust are not reproduced.

Overall representation confidence, OEM identity confidence, and geometry confidence are separated in JSON. Most identities are 0.95 because they are directly transcribed; shapes remain approximately 0.70–0.75. **Only the 21-inch working width is a documented model dimension.** Other dimensions are estimates. L.H./R.H. means from the operator position.

The drive table names 143.744102 for the 4 HP engine while the engine section and exact specimen photo name143.754122. This prototype matches the photographed exterior without claiming universal engine fitment. -6/-7 parts differences and current part supersessions remain unverified.

## Current completeness

First service-assembly visualization MVP. It demonstrates part identification and logical staged separation. It does not claim full component coverage, precise fit, verified belt routing, or an installation procedure. Omitted: engine internals, gearbox gears/worm, chain/pinion connection, many springs, brake, cable fittings, chute worm/retainer detail, most nuts/bolts/washers. `validation/issues.md` contains the actionable gaps.

GLB/glTF show the assembled state. Companion JSON powers explosion in this viewer; a generic GLB viewer will not show those controls. Assembly transforms are hierarchy-local in Blender coordinates (X right, Y rear, Z up); the viewer converts deltas to glTF coordinates (X right, Y up, Z front). All rotations remain fixed during explosion.

## Rebuild and validate

1. Run `blender/scripts/prepare_project.py` with Python to regenerate the source-backed catalog.
2. Run the locally installed Blender with `--background --python blender/scripts/build_machine.py`. Add `-- --no-renders` to skip previews during a geometry iteration.
3. Run Blender with `--background --python blender/scripts/validate_export.py` to reimport the GLB and check identifiers and metadata.
4. Run `validation/validate_data.py` with Python for GLB structure/triangle count and catalog consistency.

Scripts are parameterized procedural primitives, readable mesh construction, source-backed records, and reusable export logic. They resolve all output paths relative to this project. No task requests an API or remote agent.

## Local brand design — 2026-10-07
The supplied FML Garage emblem is stored unchanged at assets/brand/fml-garage-logo.png. The shared branding.css layer applies graphite, steel and electric-blue styling to the homepage and viewer without changing their navigation or assembly behavior. Header/footer placeholders have been replaced with the actual logo. This revision is LOCAL ONLY: the user explicitly instructed not to upload. Model enhancement work remains held for review.
Typography: Russo One is the approximate block-letter match for display headings; IBM Plex Mono supplies the technical/blueprint supporting voice. Fonts are bundled under assets/fonts with their SIL Open Font License files; no external font service is required. This remains a local-only design revision.

## Craftsman Blender presentation template
The root Craftsman scene now uses the FML Garage graphite studio, steel-coloured title and electric-blue technical labels. Russo One and IBM Plex Mono are packed into machine.blend. Original machine paint, part meshes, OEM metadata and explosion transforms remain unchanged. Presentation annotations live in the PRESENTATION collection and are excluded from the GLB.
Reapply after a geometry rebuild with Blender --background --threads 4 --python blender/scripts/apply_brand_presentation.py. The script backs up the saved scene, applies the reusable studio treatment and refreshes all nine Craftsman previews. -- --no-renders skips preview generation. This presentation pass affects only Craftsman; other machines and engines remain held. No upload was performed.

## Craftsman exterior pass — 2026-10-07 (local)

Exact C950-52474-5 auction photos informed the rounded orange engine enclosure, black tank/red filler cap, visible cooling fins, recoil grip, muffler grille and plug wiring. Tires now have staggered blocks and pressed silver hubs; the console has a sloped labeled fascia, with improved grips and rolled edges. All 69 selectable service IDs, OEM metadata and staged assembly relationships remain intact. Geometry is estimated, confidence 0.75. Reproduce with `blender/scripts/refine_craftsman_exterior.py`, then `apply_brand_presentation.py` for branded previews. The detailed reusable engine remains a separate project. This pass has not been uploaded.

## Ariens / HM80 v1 visual framework test — 2026-10-07 (local)

Applied the approved FML Garage presentation and natural service finishes to Ariens 924050 ST824 (serial 027001–036500), its HM80-155128F engine, carburetor, auger assembly and gearbox. Machine exterior additions stay within existing owning parts; 72 machine and 81 engine service IDs remain. Body/chute stay Ariens orange, engine paint black with red cap; no Craftsman green finish was transferred. Cached earlier serial000117 photos are related appearance evidence, while selected revision OEM sources retain structural authority. Dimensions and finish categories remain estimated. Branded assembled/exploded previews and local viewer subviews are available; this test has not been uploaded.

## John Deere 826 local prototype — October 2026

New local reference: original **1979 John Deere 826, P826H095001–120000**, using OEM PC1250 diagrams and the TM1234 H80 family mapping. The exact-model auction appearance reference reports serial098474, without an independently read plate. Later 826D/TRS variants remain separate. Open `viewer/?model=john-deere-826`; its reusable engine is `viewer/?model=tecumseh-h80`, with direct carburetor and auger-gearbox subviews.

The user selected the **Tecumseh H80**. Its exact Tecumseh specification suffix is unknown; Deere H80 catalog numbers are family references with specification-dependent machine applicability. They are not copied from the Ariens HM80-155128F. The machine has 66 service objects and the H80 has 77, with selective coverage and estimated dimensions. Source conflicts, modern supersessions and geometry limitations are recorded inside each project's research and validation folders. New assets are in `machines/john-deere-826/` and `engines/tecumseh-h80/`. This addition is local only; it has not been uploaded.
