Replacement Knob V1

implemented unverified

Measurement-driven replacement knob for a SQUARE shaft (valve stems, appliance timers): a revolved grip with a blind square socket, fit and torque wall measured. Not an OEM part — verify fit, see docs/CLAIMS.md. A D-shaft variant needs a partial-cut primitive and is a later wave.

Built from a real example — orbit to inspect.

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_replacement_knob
archetype: replacement_knob_v1@1

params:
  grip_d: 35mm
  shaft_sq: 6mm

Parameters

parameter	type	default	range	role
`grip_d`	`length`	`35mm`	`18mm … 80mm`	functional	exposed
`grip_h`	`length`	`18mm`	`10mm … 40mm`	functional
`shaft_sq`measured shaft square across flats	`length`	`6mm`	`3mm … 12mm`	functional	exposed
`socket_depth`	`length`	`10mm`	`5mm … 30mm`	functional
`fit_clearance`across-flats clearance added to the socket	`length`	`0.25mm`	`0.1mm … 0.4mm`	functional
`top_chamfer`	`length`	`2mm`	`0.5mm … 5mm`	aesthetic

Regions

body_grip mounting surface

Contract

Guarantees

must-have features and invariants — verified on every build

knob_grip_body
square_shaft_socket
socket_depth < grip_h - 2

Will refuse

explicit prohibitions — the engine refuses to build these

none declared

Not claimed

what passing validation does not mean

safety certified
medical
food safe
electrical certified
pressure rated
Provided “as is” under Apache-2.0 — no warranty of fitness for a particular purpose.

Built from operations

knob_body

Subscribed validators (3)

form.shaft_fit_ok form.knob_torque_wall_ok topology.single_connected_solid

Source: packs/official/artifact-forge-showcase/src/artifact_forge_showcase/data/archetypes/repair/replacement_knob_v1.yaml · forge @ 370e624 · pack: artifact-forge-showcase