Branch Clamp Upper V1

implemented unverified

Biomorphic pack Bio-1 (docs/BIOMORPHIC.md): upper half of the split branch clamp, modeled MATING-FACE-DOWN (mating plane at v=0, so the assembly poses it with rotate [0,0,0] and the male dovetail rail points up). Same constant-YZ-section discipline as the lower half: open saddle with its center compression_gap/2 beyond the mating plane, one recessed TPU pad land at the apex (three-point contact with the lower pair), four counterbored M4 bolt holes through the wings, a straight axial cable channel above the saddle (open both ends — a lamp cable runs along the branch axis), and a REAL dovetail rail (trapezoid in the section, top wider than root) that accessories slide onto. Two blind rail_fix heatset pockets enter from the rail top and must never reach the channel — form.clamp_channel_clear measures exactly that. NOTE: this archetype deliberately does NOT subscribe form.cuts_respect_keepouts — the rail_fix bolt-column keepouts intentionally veto FUTURE cuts under the rail, while the builder's own channel predates them and is verified by its dedicated checks (a builder never declares a keepout over an intended cut, so subscribing would fail the builder's own geometry).

Declaration example

A minimal product declaration for this archetype — exposed parameters at their defaults. Validate and build it with forge validate / forge build.

schema: product/v1
id: my_branch_clamp_upper
archetype: branch_clamp_upper_v1@1

params:
  nominal_branch_d: 60mm
  clamp_w: 40mm
  rail_w: 20mm
  channel_d: 10mm

modifiers:
  - id: apply_biomorphic_exoskeleton
    target: outer_shell

Parameters

parameter	type	default	range	role
`nominal_branch_d`nominal branch/pipe diameter at the clamping point	`length`	`60mm`	`30mm … 100mm`	functional	exposed
`clamp_w`clamp body width along the branch axis	`length`	`40mm`	`32mm … 120mm`	structural	exposed
`compression_gap`designed daylight between the bolted mating faces	`length`	`3mm`	`1.5mm … 6mm`	functional
`screw`clamp bolts (counterbored clearance holes in this half)	`choice`	`M4`	`M4`	assembly
`flange_t`bolt wing thickness at the mating plane	`length`	`10mm`	`8mm … 14mm`	structural
`wall`minimum wall between the saddle and the outer shell	`length`	`4mm`	`3mm … 8mm`	structural
`bolt_web`web between the saddle edge and the bolt axis — form.saddle_geometry_ok fails a bolt placed over the open mouth	`length`	`8mm`	`0mm … 20mm`	structural
`edge_m`	`length`	`10mm`	`6mm … 16mm`	structural
`corner_r`	`length`	`2.5mm`	`1mm … 5mm`	aesthetic
`land_angle`kept in sync with the lower half's land positions (the upper half carries ONE land at the apex)	`number`	`50`	`30 … 65`	functional
`land_w`	`length`	`14mm`	`8mm … 20mm`	functional
`pad_recess`	`length`	`1.2mm`	`0.6mm … 2mm`	functional
`top_t`body above the saddle apex — carries the cable channel	`length`	`20mm`	`10mm … 30mm`	structural
`rail_w`dovetail top width (the accessory side)	`length`	`20mm`	`12mm … 30mm`	functional	exposed
`rail_h`	`length`	`6mm`	`4mm … 10mm`	functional
`rail_angle`dovetail flank angle in degrees — 0 builds a plain ridge and form.dovetail_rail_profile honestly fails it	`number`	`10`	`0 … 20`	functional
`channel_d`axial cable channel diameter	`length`	`10mm`	`6mm … 14mm`	functional	exposed
`rail_screw`accessory fixing inserts in the rail top	`choice`	`M3`	`M3 \| M4`	assembly
`rail_fix_depth`	`length`	`6mm`	`5mm … 8mm`	assembly
`min_web`	`length`	`4mm`	`3mm … 8mm`	manufacturing