mirror of
https://github.com/usips/trufflepig.git
synced 2026-10-28 14:08:00 -04:00
Joshua MoonandCodex
708b527e7b
Index PHP and PHTML declarations and references with conservative fully qualified candidate lookup. Derive add-on dependencies from XenForo manifests and class-extension metadata while leaving runtime XFCP chains unresolved. Add cache invalidation, language filters, agent steering, documentation, and a read-only XenForo acceptance runner with isolated test daemons. Validation: cargo test --locked (409 passed); Python plugin suite (58 passed); release XenForo acceptance (8 CLI calls, 7550 PHP files, 7482 complete, 13 cross-add-on candidate edges); scoped rustfmt and diff-check. Co-authored-by: Codex <[email protected]>
3.0 KiB
3.0 KiB
Trufflepig
Trufflepig is a local search engine for coding agents working in large
repositories. Instead of grep output that floods the context window, an agent
gets one ranked, token-budgeted page of hits with stable handles, then reads
exactly the source it needs, verified against the bytes on disk. Pre-alpha,
Linux only.
What an agent gets
- Bounded answers. Every response fits a token budget, 600
o200k_basetokens by default, ranked file-first with one representative hit per file. Truncation and partial coverage are reported, never silent. (CLI) - Handles instead of re-searching. Each hit carries an immutable handle.
showreturns its source with the revision and averified:footer;morepages;ctxandrefsfollow relationships;mapoutlines a module. Handles survive restarts and never drift to a newer query. (retrieval contract) - Structure, not just text. Symbols, definitions, references, and resolved-versus-candidate relationships for Rust, TypeScript/JavaScript, C#, PHP, Luau, and DreamMaker. Everything else stays text-searchable. (language contract)
- History without a checkout.
hist,since,diff, andblameover local Git objects with exact before/after reads. Needs Git 2.55 or newer. (history contract) - Multi-repo workspaces, opt-in semantic retrieval and reranking with a 500 ms deadline and lexical fallback, and a per-session audit of every call. (workspace, semantic, diagnostics)
What is measured
The design makes no latency, memory, or retrieval-quality guarantee (design). Current evidence is a development split, not a held-out result:
- Oracle-assisted navigation replay, 12 tasks: mean file recall at 10 is 0.25 with the old lexical lane, 0.46 with file-first lexical ranking, and 0.63 with CUDA retrieval plus rerank; misses fall from 8 to 6 to 4. (result.json)
- A paired agent trial exists, but most assisted agents misused the wrapper, so it establishes no token-saving or task-success claim. (agent_result.json)
- Indexing has a real cost: about 100 s cold for an 11,620-file repository in a debug build, with an index 17 to 21 times the source bytes. (performance smoke)
The external Codebase-Memory study (roughly tenfold lower token use, 2.1-fold fewer calls) motivates this work; it is not a Trufflepig result.
Get started
cargo install --path . --locked
trufflepig --root . --no-daemon index
trufflepig --root . search 'sym:TokenBucket'
Get started · Design and contracts · Agent setup for Codex, Claude Code, Kimi Code, Muse Code, and omp.
Licensed under GPLv3 only.