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

from tasks.base import Task, GroundTruth, Mutation


class GinEditMiddlewareChainTask(Task):
    """Increment change in Next(): skips every other handler in the chain."""

    @property
    def name(self) -> str:
        return "gin_edit_middleware_skip"

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

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

    @property
    def mutations(self) -> list[Mutation]:
        return [
            Mutation(
                file_path="context.go",
                original="c.index++",
                mutated="c.index += 2",
            )
        ]

    @property
    def test_command(self) -> list[str]:
        return ["go", "test", "-run", "TestMiddlewareGeneralCase", "-v"]

    @property
    def prompt(self) -> str:
        return (
            "In Gin's context.go, the middleware chain is broken — every other "
            "handler in the chain is being silently skipped. A route with "
            "middlewares A, C and handler D should execute as A→C→D→B (where B "
            "is A's post-Next code), but instead only alternating handlers run. "
            "Find the bug in the Next() method that causes handlers to be skipped "
            "and fix it."
        )

    @property
    def ground_truth(self) -> GroundTruth:
        return GroundTruth()


class GinEditAbortCheckTask(Task):
    """Comparison change in IsAborted(): >= becomes >, breaks abort detection."""

    @property
    def name(self) -> str:
        return "gin_edit_abort_check"

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

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

    @property
    def mutations(self) -> list[Mutation]:
        return [
            Mutation(
                file_path="context.go",
                original="c.index >= abortIndex",
                mutated="c.index > abortIndex",
            )
        ]

    @property
    def test_command(self) -> list[str]:
        return ["go", "test", "-run", "^TestContextIsAborted$", "-v"]

    @property
    def prompt(self) -> str:
        return (
            "In Gin's context.go, the IsAborted() method is broken — after "
            "calling Abort(), IsAborted() still returns false. This means "
            "middleware that checks IsAborted() after calling Abort() will "
            "incorrectly continue processing the request. The issue is a "
            "boundary comparison error in IsAborted(). Find and fix it."
        )

    @property
    def ground_truth(self) -> GroundTruth:
        return GroundTruth()


class GinEditContextResetTask(Task):
    """Initial value change in reset(): index starts at 0 instead of -1."""

    @property
    def name(self) -> str:
        return "gin_edit_context_reset"

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

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

    @property
    def mutations(self) -> list[Mutation]:
        return [
            Mutation(
                file_path="context.go",
                original="c.index = -1",
                mutated="c.index = 0",
            )
        ]

    @property
    def test_command(self) -> list[str]:
        return ["go", "test", "-run", "^TestContextReset$", "-v"]

    @property
    def prompt(self) -> str:
        return (
            "In Gin's context.go, the Context pool is producing incorrect "
            "behaviour after the first request. When a Context is returned to "
            "the sync.Pool and reused, the handler chain index is not properly "
            "reset — the first handler is being skipped on reused contexts. "
            "The issue is in the reset() method where the index is initialized "
            "to the wrong starting value. Find and fix it."
        )

    @property
    def ground_truth(self) -> GroundTruth:
        return GroundTruth()