#142 crouch: duckState is a THREE-state posture -- the strip is an animation

Operator confirmed on screen: bduck.pcc is a real duck ANIMATION, and stepping
duckState 0->1->2 plays it.  So the attribute is not a flag:

    0 = standing        1 = moving between        2 = crouched

Everything else was already right -- asset, element (OneOfSeveralPixInt
@004c5204), factory registration, L4GAUGE.CFG:5001, and the attribute binding
(new [gauge] receipt confirms 'bduck.pcc' frames=3x1 attr=BOUND).  We were
writing a two-value flag into a three-frame strip, so frame 2 was unreachable
and the cockpit saw a snap: "it lights up and sticks, no animation".

The handler is back to the binary's exact write (duckState = 1, @0049fa00).
That value now MEANS the middle frame, so the press gives immediate visual
feedback and the earlier toggle divergence is retired.

Needed a separate duckRequest cell, which I tried twice to avoid:
  * duckState cannot be both the request and the display.  Settling it to the
    real posture destroys the request, so on the frame the squat clip parked
    the consumer read "crouched + pending" and issued the opposite direction --
    69 transitions from 2 presses, benched, twice.
  * reading the CACHED legAnimationState instead of the alarm made it worse:
    the cache refreshes only at the top of AdvanceLegAnimation, so right after
    SetLegAnimation it still reads the old state.  Read the alarm.
duckRequest is port-only, appended, never read by offset.

Also fixes a silent failure in the gauge factory: the missing-image path used
DebugStream -- the no-op ReconStream (project gotcha) -- so a strip that failed
to load reported NOTHING.  Now DEBUG_STREAM, plus an ungated one-line receipt
per element naming the image, frame grid, port and whether the attribute BOUND
or came back NULL.  That receipt is what proved the element was healthy and
sent me looking at the value instead of the plumbing.

Benched (crouch142.sh, madcat): 2 presses -> exactly 2 transitions,
SQUAT -> parked (settles to 2) then RISE (settles to 0).  Refusal while moving
still holds (posture=0, authentic per Lynx).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NCJQkvq6G2JNrpVbA75tVZ

game/reconstructed/mech.cpp

@@ -510,18 +510,25 @@ void
 	{
 		return;
 	}
-	// #142: duckState is the DESIRED POSTURE, and it is what the cockpit's
-	// crouch-symbol animation reads (L4GAUGE.CFG:5001 binds attribute 0x37 to a
-	// 3-frame bduck.pcc strip).  The binary writes a bare 1 here and clears the
-	// cell only in Mech::Reset -- with no per-frame reader anywhere in the
-	// export, so nothing there ever brings it back to 0 for a rise.  A pod
-	// pilot's second press has to un-crouch, and the symbol has to follow, so
-	// the port TOGGLES.  Documented divergence, deliberately minimal: one cell,
-	// same meaning, and the consumer (mech4.cpp) now acts on desired-vs-actual
-	// rather than consuming the cell out from under the gauge.
-	duckState = (duckState != 0) ? 0 : 1;
-	DEBUG_STREAM << "[duck] DuckRequest: duckState -> " << duckState
-		<< (duckState ? "  (crouch)" : "  (rise)") << std::endl << std::flush;
+	// #142: duckState is the POSTURE the cockpit's crouch-symbol animation
+	// reads -- L4GAUGE.CFG:5001 binds attribute 0x37 to a THREE-frame
+	// bduck.pcc strip, confirmed on screen as a duck animation:
+	//     0 = standing   1 = moving between   2 = crouched
+	//
+	// A bare 1 here is therefore exactly right, and is what the binary writes:
+	// it means "in transition", which is both the request AND the middle frame.
+	// The consumer (mech4.cpp) reads the parked leg alarm to decide DIRECTION
+	// -- parked means the pending move is a rise, not parked means a squat --
+	// and settles duckState to 0 or 2 when the clip finishes.  No separate
+	// request cell, no toggle, no divergence from @0049fa00.
+	//
+	// (An earlier revision toggled 0<->1 here.  That produced a two-pose snap,
+	// which is what the cockpit reported as "it lights up and sticks, no
+	// animation": frame 2 was never reachable.)
+	duckState   = 1;			// show the MIDDLE frame at once (the binary's write)
+	duckRequest = 1;			// and remember that a move is pending (#142)
+	DEBUG_STREAM << "[duck] DuckRequest: duckState -> 1 (in transition)"
+		<< std::endl << std::flush;
 }
 
 //
@@ -1578,6 +1585,7 @@ Mech::Mech(
 	radarLinearPosition = &localOrigin.linearPosition;	// map reads the mech's live world position...
 	radarAngularPosition= &localOrigin.angularPosition;	// ...and orientation (pointers into the base origin)
 	duckState           = 0;							// not crouching
+	duckRequest         = 0;							// no pending duck request (#142)
 	// (AUDIO_FIDELITY F7) missile alarm: the binary reset writes 0 / FLT_MAX
 	// (part_012.c:9446-9447; FLT_MAX = "no missile" far default)
 	incomingLock            = 0;