dirpack 0.2.0

Budgeted directory indexes for AI coding agents with tree-sitter signatures
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

# dirpack.toml - Project configuration

[output]
format = "pipe"           # "pipe" | "full" | "json"
default_budget_tokens = 4000
default_budget_bytes = 16000

[scanning]
use_gitignore = true      # Respect .gitignore
include_hidden = false    # Include .dotfiles/dirs
max_depth = 20            # Max recursion depth
follow_symlinks = false
no_git_safety = true      # Apply safety exclusions in --no-git mode

# File categories - used for prioritization and signature extraction
[categories.code]
extensions = ["rs", "go", "py", "ts", "tsx", "js", "jsx", "c", "cpp", "h", "hpp", "java", "rb", "ex", "exs"]
priority = 100

[categories.docs]
extensions = ["md", "mdx", "txt", "rst", "adoc"]
priority = 90

[categories.config]
extensions = ["toml", "yaml", "yml", "json", "ini", "cfg"]
priority = 80

[categories.build]
extensions = ["lock", "sum"]
priority = 20

[categories.data]
extensions = ["csv", "sql"]
priority = 30

# Priority rules - higher = more important, included first in budget
[[priority_rules]]
pattern = "README*"
priority = 200

[[priority_rules]]
pattern = "AGENTS.md"
priority = 200

[[priority_rules]]
pattern = "CLAUDE.md"
priority = 200

[[priority_rules]]
pattern = "Cargo.toml"
priority = 150

[[priority_rules]]
pattern = "package.json"
priority = 150

[[priority_rules]]
pattern = "go.mod"
priority = 150

[[priority_rules]]
pattern = "src/main.*"
priority = 140

[[priority_rules]]
pattern = "src/lib.*"
priority = 140

[[priority_rules]]
pattern = "**/mod.rs"
priority = 130

[[priority_rules]]
pattern = "**/*_test.*"
priority = 50

[[priority_rules]]
pattern = "**/test_*"
priority = 50

[[priority_rules]]
pattern = "**/*.lock"
priority = 10

# Priority weight adjustments - tune scoring for specific file types
# These modify the base priority score based on file characteristics
[priority]
# default_priority = 50       # Base score for files not matching any rule
# entrypoint_boost = 40       # Bonus for main.rs, lib.rs, index.ts, etc.
# root_code_boost = 20        # Bonus for code files at repository root
# focus_dir_boost = 15        # Bonus for files in src/, lib/, cmd/, pkg/
# test_penalty = -40          # Penalty for test files and directories
# fixture_penalty = -25       # Penalty for fixture/mock files and directories
# depth_penalty_step = -5     # Penalty per depth level beyond 2
# max_depth_penalty = -30     # Maximum total depth penalty

# Exclude patterns (gitignore syntax)
[exclude]
patterns = [
    "target/",
    "node_modules/",
    "dist/",
    "build/",
    ".git/",
    "__pycache__/",
    "*.pyc",
    ".DS_Store",
    "*.min.js",
    "*.min.css",
    "vendor/",
    ".venv/",
    "venv/",
]

# Tree-sitter signature extraction
[signatures]
enabled = true
languages = ["rust", "go", "python", "typescript", "javascript", "c", "cpp"]
include_functions = true
include_structs = true
include_traits = true
include_interfaces = true
include_classes = true
include_types = true
include_constants = true
max_signature_length = 200