srcwalk 0.2.5

Tree-sitter indexed lookups — smart code reading for AI agents
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138

from tasks.base import Task, GroundTruth


class GinRadixTreeTask(Task):
    @property
    def name(self) -> str:
        return "gin_radix_tree"

    @property
    def repo(self) -> str:
        return "gin"

    @property
    def prompt(self) -> str:
        return (
            "Find the radix tree implementation that gin uses for routing. Show the node "
            "struct definition, the nodeType constants, and explain how wildcard parameters "
            "(like :id and *filepath) are handled in the tree. What method looks up a route?"
        )

    @property
    def ground_truth(self) -> GroundTruth:
        return GroundTruth(
            required_strings=["type node struct", "catchAll", "getValue", "wildChild"],
        )


class GinClientIPTask(Task):
    @property
    def name(self) -> str:
        return "gin_client_ip"

    @property
    def repo(self) -> str:
        return "gin"

    @property
    def prompt(self) -> str:
        return (
            "In gin's Context, show the complete implementation of the ClientIP() method. "
            "What headers does it check, in what order? How does it handle trusted proxies "
            "and the X-Forwarded-For header?"
        )

    @property
    def ground_truth(self) -> GroundTruth:
        return GroundTruth(
            required_strings=[
                "func (c *Context) ClientIP",
                "RemoteIPHeaders",
                "X-Forwarded-For",
                "trustedCIDRs",
            ],
        )


class GinMiddlewareChainTask(Task):
    @property
    def name(self) -> str:
        return "gin_middleware_chain"

    @property
    def repo(self) -> str:
        return "gin"

    @property
    def prompt(self) -> str:
        return (
            "Trace how a request flows through gin's middleware chain. Start from "
            "Engine.ServeHTTP, show how it gets a Context from the pool, finds the route "
            "handlers, and executes the handler chain. What is HandlersChain and how does "
            "Context.Next() advance through it?"
        )

    @property
    def ground_truth(self) -> GroundTruth:
        return GroundTruth(
            required_strings=["ServeHTTP", "HandlersChain", "Next", "pool", "index"],
        )

    @property
    def task_type(self) -> str:
        return "navigate"


class GinContextNextTask(Task):
    @property
    def name(self) -> str:
        return "gin_context_next"

    @property
    def repo(self) -> str:
        return "gin"

    @property
    def prompt(self) -> str:
        return (
            "Find the Context.Next() method in gin. Show its complete "
            "implementation."
        )

    @property
    def ground_truth(self) -> GroundTruth:
        return GroundTruth(
            required_strings=[
                "Next", "index", "handlers",
            ],
        )


class GinServeHTTPFlowTask(Task):
    @property
    def name(self) -> str:
        return "gin_servehttp_flow"

    @property
    def repo(self) -> str:
        return "gin"

    @property
    def prompt(self) -> str:
        return (
            "Find Engine.ServeHTTP in gin and show its implementation. Then "
            "trace what functions it calls — how does it get a Context, find "
            "the matching route handlers, and start executing them?"
        )

    @property
    def ground_truth(self) -> GroundTruth:
        return GroundTruth(
            required_strings=[
                "ServeHTTP", "gin.go", "handleHTTPRequest", "pool",
            ],
        )

    @property
    def task_type(self) -> str:
        return "navigate"