Commit graph

2357 commits

Author SHA1 Message Date
BruceChen
1c2e6fba2b pathing: tighten diagonal step-descend and Descend-carry runway
* JumpFeasibility.EvaluateStepDescend now requires BOTH cardinal
  shoulder columns to be passable. Axis-separated collision
  resolution at the corner zeros one velocity component when a
  shoulder is walled, sliding the bot straight down past the intended
  diagonal landing into a multi-block fall-through (observed on the
  251 -> 244 route around (249,136,207)).
* ParkourFeasibility now distinguishes Parkour-carry from
  Descend-carry for flat (yDelta == 0) jumps. A Descend often
  overshoots the takeoff block, killing the sprint runway the
  SprintJumpTemplate needs to reach 5 c2c. Treat Descend-carry like a
  cold start: 3.5 m threshold and 2 aligned back-runway blocks. This
  prevents the planner from picking impossible 5 c2c flat jumps right
  after a Descend (e.g. (248,122,197) -> (248,122,192)).

Verified live on 1.21.11 across all 6 directions between
(251.5,141,210.5), (252.5,138,220.5) and (244.5,122,188.5):
0 replans, 0 segment failures, no mid-path stalls.

Made-with: Cursor
2026-04-25 18:43:18 +00:00
BruceChen
8ec1ccd45d pathing: 0-replan on long Descend->Traverse + cold-start 5 c2c
Two complementary fixes for live-server "stuck on a step then replan"
on the 252.5,138,220.5 -> 244.5,122,188.5 route.

Search layer (ParkourFeasibility.HasRunUp): a long flat sprint parkour
(5 c2c, horiz~5) cannot launch from a cold start. Vanilla physics show
that gap=4 dy=0 reaches 5.1075m only with 12 momentum ticks of straight
sprint windup; a 0t standing jump tops out at gap=3 (=4 c2c). When the
previous move type is not Parkour/Descend (i.e. no carried airborne
momentum) we now require two aligned back-runway blocks instead of one
so the executor actually has room to spin sprint up.

Execution layer (GroundedSegmentController.ShouldComplete): the
LandingRecovery early-out used to live below the MinExitSpeed gate. A
Descend that landed inside the destination block but naturally settled
to zero speed (e.g. when the next segment is a fresh Traverse rather
than a chained Parkour) would fail the 0.03 MinExitSpeed check and idle
inside the target block until the per-segment timeout fired, triggering
an unnecessary replan. Move the LandingRecovery footprint check above
the speed gate so a fully-decelerated handoff is accepted.

Verified live on 1.21.11-Vanilla:
- 252.5,138,220.5 -> 244.5,122,188.5: 24 segments, 0 replans (was: 1)
- 244.5,122,188.5 -> 252.5,138,220.5: 48 segments, 0 replans
- 251.5,141,210.5 -> 252.5,138,220.5: 34 segments, 0 replans
- 252.5,138,220.5 -> 251.5,141,210.5: 24 segments, 0 replans

Test suite: 297 passed / 22 known pre-existing failures, no new
regressions vs 5de169db.

Made-with: Cursor
2026-04-25 18:08:08 +00:00
BruceChen
5de169db64 pathing: stabilize 0-replan round-trip on ledge/descend runs
Fix a cluster of execution-layer issues that caused replans and void
falls when traversing narrow ledges and multi-block descents between
(251.5,141,210.5) and (252.5,138,220.5):

- WalkTemplate / GroundedSegmentController: suppress the pre-rotation
  bias toward the next segment's exit heading on stable-footing Turn
  exits where the next segment is not a jump.  The next template
  snaps yaw on its first tick anyway, and pre-rotating mid-stride on
  a 1-block walkway pushes sprint drift perpendicular to the path and
  walks the bot off the edge.  Turn exits into a jump still get the
  bias so the takeoff direction stays aligned.

- GroundedSegmentController.ShouldComplete: relax the headingReady
  gate for Turn exits with stable footing so the segment can complete
  once yaw is aligned with either the current or the next segment
  heading (within 25/15 deg).  Without this the removed bias would
  leave the bot stuck at the end of a walkway waiting for a rotation
  that never happens.

- DescendTemplate: restrict the airborne exit-heading bias so it only
  kicks in when the footprint is inside the landing block, or on
  single-step drops where the fall is too short for lateral drift to
  miss the landing column.  On 2+ block drops the bot now keeps yaw
  pointed at the landing center for the whole fall.

- DescendTemplate: add a multi-block overshoot guard on PrepareJump
  exits.  Once airborne and past the landing end-plane on a 2+ Y
  drop, release forward/sprint and press back briefly so air drag
  pulls the bot back into the 1x1 landing column instead of sailing
  one block past it into the neighbouring void.

Live round-trip between the two goal coordinates now completes with
zero replans in three consecutive runs in each direction.  Full unit
test suite is unchanged from the pre-existing baseline (22 failing
tests, all orthogonal to this change).

Made-with: Cursor
2026-04-22 16:43:43 +00:00
BruceChen
d002930a6a pathing: unify jump moves into MoveJump + IMoveExpander
Replace seven hand-written IMove classes (MoveTraverse, MoveDiagonal,
MoveAscend, MoveDiagonalAscend, MoveDiagonalDescend, MoveParkour,
MoveSidewallParkour) with a single MoveJump driven by a JumpDescriptor
(XOffset, ZOffset, YDelta, JumpFlavor). JumpFeasibility is the single
source of truth for the physics/cost rules of every jump-family move.

A* no longer iterates a flat IMove[]. The Calculate loop now drives
an IMoveExpander[] that writes into a stackalloc Span<MoveNeighbor>,
eliminating per-iteration heap traffic. JumpExpander enumerates every
jump-family descriptor dynamically; LegacyMoveExpander wraps the
remaining dynamic-landing moves (MoveDescend, MoveSprintDescend,
MoveClimb, MoveFall) so callers that still pass a custom IMove[]
keep working.

Add two O(1) short-circuits at the top of JumpExpander.Expand:
- Hoist the per-node parkour preconditions (AllowParkour + CanSprint,
  standing block climbability, feet-liquid, head clearance at y+2)
  so ~170 SprintJump + Sidewall descriptors never call JumpFeasibility
  when the node cannot take off at all.
- Precompute an 8-way "first step has no floor" table indexed by
  (sign(dx), sign(dz)) so SprintJump descriptors in a direction that
  has a walkable floor underneath are dropped without Evaluate.
- Add a conservative "any cardinal wall at y or y+1" probe that skips
  all 112 Sidewall descriptors when no wall exists adjacent to the
  takeoff.

Move tests switch to the new MoveJump.* factory methods. Behavior is
verified by the existing test suite: the 21 pre-existing baseline
failures are preserved exactly, 0 regressions introduced.

Made-with: Cursor
2026-04-19 17:03:26 +00:00
BruceChen
da52aa5c3c pathing: sidewall runup precondition via EntryPreparation
Introduce an EntryPreparationState carried on PathNode + A* context so
sidewall parkour can explicitly request one or more runway traverses
before takeoff instead of silently dropping the move. ParkourFeasibility
gains TryGetRequiredStaticEntryRunupSteps + HasPreparedRunup helpers so
long descends (major=5, dy=-1) only remain feasible when the preceding
node proved the runup.

Widen HasDominantAxisRunUp to accept cold-start sprint-jumps within
~3.1-3.5 blocks horizontally so lone overhang / staircase takeoffs stay
feasible without a 2-block runway (matches Baritone's MomentumBehavior
.ALLOWED contract).

Add a runtime SidewallParkourController that implements the corner
commitment + wall-hug chain during execution.

Extend pathing test fixtures with InitialMomentumTicks, add sidewall
accepted/rejected scenarios, and refresh timing + contract baselines to
reflect the new planner shapes. Document the design in
docs/superpowers/specs and plans.

Made-with: Cursor
2026-04-19 17:03:03 +00:00
BruceChen
95b20d9d1c pathing: async replan + template success/failure alignment
Move PathSegmentManager's Replan to Task.Run so the main tick only reads
results and swaps executors, and introduce a _nextExecutor pre-planning
slot so upcoming segments can prepare while the current one finishes.

Relax per-tick yaw/pitch rate limiting: allow instantaneous snapping
before jump ticks (Baritone does this and servers do not kick for it).

Align jump-template success/failure contracts with Baritone:
- Success key shifts from "speed squared" to "feet-on-target block".
- Failure window widened to the ~200 tick range.
- AscendTemplate gets a headBonkClear + edge/side proximity
  precondition so launches only happen from a safe takeoff.

Expose an initialMomentumTicks option on TemplateSimulationRunner so
follow-up sidewall scenarios can warm up physics before a template
starts.

Made-with: Cursor
2026-04-19 17:02:41 +00:00
BruceChen
e23037a897 feat: add sidewall parkour planner support 2026-04-18 16:26:15 +00:00
BruceChen
724880f928 fix: propagate parkour profiles through astar 2026-04-18 16:14:04 +00:00
BruceChen
b4b0c6e8ed refactor: thread parkour profile into runtime segments 2026-04-18 16:04:45 +00:00
BruceChen
f64c6be0a9 test: harden sidewall fixture coverage 2026-04-18 15:45:00 +00:00
BruceChen
43db3950e3 test: complete sidewall fixture matrix 2026-04-18 15:29:42 +00:00
BruceChen
056d7afef1 test: add sidewall scenario builder fixtures 2026-04-18 15:18:55 +00:00
BruceChen
6cc4c6a6a9 test: harden integration harness cleanup and spill handling 2026-04-18 10:07:06 +00:00
BruceChen
4aa763745c test-harness: add parkour worker pool 2026-04-18 06:15:10 +00:00
BruceChen
d919bff91f pathing: tighten linear parkour execution 2026-04-18 06:14:45 +00:00
BruceChen
891763602a pathing: align linear completion with live execution 2026-04-17 20:09:56 +00:00
BruceChen
ddb0ca97f1 test-harness: isolate parkour cases per session 2026-04-17 19:52:41 +00:00
BruceChen
418f17b4a1 pathing: add side-wall theory, full-coverage parkour test suite, and live test fixes
Theory simulator:
- Add 2D side-wall jump physics with yaw sweep for worst-case margin
- Generate sidewall theory cases (flat/ascend/descend, wall_offset 0/1)
- Add momentum-capabilities.json with band compression and max_reach
- Extend models, capabilities, canonical, and renderers for sidewall

Full-coverage parkour test suite (tools/test-parkour.py):
- Derive test matrix from momentum-capabilities.json
- Build linear/neo/ceiling courses via RCON with 7-block clear margin
- Use /goto for pathfinding, parse A* and PathMgr log output
- Stop-at-first-failure per (family, subfamily, dy, ceil, wo) group
- Hierarchical --filter (e.g. linear/flat, ceiling/headhitter/ceil2.5)
- Exclude sidewall from default matrix (identical max_reach to linear)

Pathing execution fixes:
- Align parkour contracts and timing budgets with live test results
- Fix jump-entry yaw snapping for grounded handoffs
- Template helper and sprint jump template refinements

Made-with: Cursor
2026-04-15 17:52:47 +00:00
BruceChen
cf8bf349db pathing: align parkour contracts with live budgets 2026-04-15 17:36:20 +00:00
BruceChen
ce555da95e pathing: align prepare-jump convergence tests 2026-04-15 16:49:50 +00:00
BruceChen
aad6ad83d3 pathing: snap yaw only for grounded jump-entry walk states 2026-04-15 16:43:39 +00:00
BruceChen
8408a41398 pathing: snap yaw for jump-ready grounded handoffs 2026-04-15 16:37:12 +00:00
BruceChen
2be9b287a3 pathing: snap yaw for sprint jump approach 2026-04-15 16:29:11 +00:00
BruceChen
e271854bdb docs: add jump-entry direct yaw design 2026-04-15 15:49:11 +00:00
BruceChen
2d8c8b2888 refactor: replace CursorBot references with MCCBot in pathing scripts and documentation 2026-04-14 17:15:33 +00:00
BruceChen
2f65594077 docs: document theory-aligned pathing workflow 2026-04-14 11:15:32 +00:00
BruceChen
f065d62926 test: add theory-aligned neo and ceiling suite 2026-04-14 11:14:03 +00:00
BruceChen
51a96da662 test: tune theory headhitter case selection 2026-04-14 11:13:55 +00:00
BruceChen
84a452d5c9 test: make linear pathing suite manifest-driven 2026-04-14 11:12:16 +00:00
BruceChen
e4fc557aac test: tune canonical live case selection 2026-04-14 11:11:49 +00:00
BruceChen
7d3ce42040 feat: add theory-to-live pathing report 2026-04-14 11:08:01 +00:00
BruceChen
ef3cd64475 feat: generate theory-aligned pathing artifacts 2026-04-14 11:06:19 +00:00
BruceChen
7fbb32d8b9 feat: extract reusable pathing theory generator 2026-04-14 11:02:26 +00:00
BruceChen
07c948a8b8 docs: document pathing contract metrics workflow 2026-04-14 10:55:34 +00:00
BruceChen
be6be4da36 test: surface path timing contracts in live harness 2026-04-14 10:51:13 +00:00
BruceChen
4b193e639c test: add pathing contract report parser 2026-04-14 10:33:32 +00:00
BruceChen
b42a24e77a test: add long route timing contracts 2026-04-13 17:20:46 +00:00
BruceChen
eb9d6ce356 test: add jump combo planner and timing contracts 2026-04-13 17:08:32 +00:00
BruceChen
ba1dc32ccb test: lock short route planner and timing contracts 2026-04-13 16:52:34 +00:00
BruceChen
b9bff02107 Add path execution telemetry and scenario runner 2026-04-13 16:36:11 +00:00
BruceChen
9fe376a3bb Add pathing contract loader validation scaffold 2026-04-13 16:24:23 +00:00
BruceChen
aefc7235ee test: add zero-replan live pathing harness 2026-04-13 15:36:39 +00:00
BruceChen
b0fab26c66 test: add pathing transition regression coverage 2026-04-13 15:36:09 +00:00
BruceChen
360883acf3 feat: add transition-aware path execution core 2026-04-13 15:35:43 +00:00
BruceChen
7ad0a57a3e docs: add theory-aligned pathing regression design 2026-04-13 15:02:12 +00:00
BruceChen
d2b279974c refactor: update decompilation process and documentation to use version naming convention with '-Vanilla' for consistency 2026-04-12 21:01:24 +00:00
BruceChen
31c968ffa6 chore: remove redundant comment from MCC debug script for clarity 2026-04-12 20:49:50 +00:00
BruceChen
2b8a8113f5 refactor: update MCC commands and documentation to use version 1.21.11-Vanilla for consistency across workflows 2026-04-12 20:48:30 +00:00
BruceChen
f0b79d5f9c feat: enhance MCC runtime management with dynamic launcher detection and improved error handling 2026-04-12 20:35:02 +00:00
BruceChen
0514fcb327 feat: implement parkour admissibility hardening with new feasibility checks 2026-04-12 18:43:33 +00:00