🔥 feat: add MatchedRoute for middleware look-ahead - #4601

#!/bin/bash
set -euo pipefail

# Inspect method mutation and existing cache invalidation.
rg -n -A45 -B4 'func \(c \*DefaultCtx\) Method\(' ctx.go
rg -n -C4 'matchedRoute\s*=|firstMatchIndex\s*=' ctx.go

# Find existing MatchedRoute coverage to extend.
rg -n -C5 'MatchedRoute\(' ctx_test.go

#!/bin/bash
set -euo pipefail

# Locate relevant files without relying on exact repository root layout.
printf 'Git root: '; git rev-parse --show-toplevel 2>/dev/null || pwd
printf 'ctx.go candidates: '; fd -a '^ctx\.go$' . 2>/dev/null || find . -name ctx.go -type f

printf '\nSearch DefaultCtx.Method and MatchedRoute symbols:\n'
rg -n -C5 'func \(c \*DefaultCtx\) Method\(' . || true
rg -n -C4 'func \(c \*DefaultCtx\) MatchedRoute' . || true
rg -n -C3 'matchedRoute\s*=|firstMatchIndex\s*=' . || true
rg -n -C5 'MatchedRoute\(' . || true

#!/bin/bash
set -euo pipefail

printf 'Relevant ctx.go sections:\n'
sed -n '394,445p' ctx.go
sed -n '260,330p' ctx.go

printf '\nReq.go Method implementation:\n'
sed -n '910,955p' req.go

printf '\nContext reset methods around Reset:\n'
sed -n '760,815p' ctx.go

printf '\nInspect request method override and MethodInt behavior:\n'
rg -n -C4 'func \(c \*DefaultCtx\) MethodInt\(\)|func UpdateRequestMethod|Request.*Method|MethodInt|HeaderRequestMethod|c\.methodInt|c\.Req.*Header|SetMethod\(' req.go ctx.go router.go

#!/bin/bash
set -euo pipefail

printf 'Route matching helpers and firstMatchIndex write:\n'
sed -n '720,770p' router.go
rg -n -C6 'firstMatchIndex = ' router.go

printf '\nRead-only behavioral model for cached MatchedRoute after method override:\n'
python3 - <<'PY'
import copy

class Tree:
    def __init__(self, routes_by_path):
        self.routes_by_path = routes_by_path

class App:
    def __init__(self):
        self.treeIndex = {
            0: Tree({"same": "GET_route"}),
            1: Tree({"same": "POST_route"}),
        }

class Ctx:
    def __init__(self):
        self.app = App()
        self.treePathHash = 0
        self.methodInt = 0
        self.firstMatchIndex = 0
        self.matchedRoute = "GET_route"

def matcheRoute(ctx):
    if ctx.matchedRoute is not None:
        return ctx.matchedRoute
    if ctx.methodInt == -1 or ctx.app is None:
        return None
    return ctx.app.treeIndex[ctx.methodInt].routes_by_path["same"]

def method_override(ctx, method_int):
    ctx.methodInt = method_int
    ctx.firstMatchIndex = -1

ctx = Ctx()
before = matcheRoute(ctx)
first_after_method = ctx.firstMatchIndex
method_override(ctx, 1)
second = matcheRoute(ctx)
lookup_after_method = ctx.firstMatchIndex

print({"before": before, "firstMatchIndex_after_method": first_after_method, "after_method": second, "firstMatchIndex_after_second_call": lookup_after_method})
PY