Read 2026-11-03
yacy/yacy_search_server: technical due diligence, read from its repository
What Borehole read in yacy/yacy_search_server's code and history at 5fa5576: its licence, security advisories, releases, review practice, tests, dependencies and operations. Every finding cites the file and line it rests on. The full report also covers the team and asks the questions the code cannot answer.
| Dimension | Rating |
|---|---|
| Architecture & Codebase — including AI provenance | strong |
| Engineering Process & SDLC Maturity | adequate |
| Product & Engineering Maturity | adequate |
| Security & Reliability Posture | adequate |
| Observability & Operations | adequate |
| Fit with the Acquirer | not assessable |
Architecture & Codebase — including AI provenance
stronghtroot/env/bootstrap/js/jquery.js is 11,009 lines, 75× this codebase's median file
adequateThe median source file here is 146 lines. 13 files exceed 1,460 lines, the largest being 11,009. Size is not a defect on its own — some problems genuinely live in one place — but these are where merge conflicts, review fatigue and single-owner knowledge concentrate, and they are the first thing that slows an inheriting engineer down.
htroot/env/bootstrap/js/jquery.js:1 — 11,009 lines (75× median) |
source/net/yacy/search/Switchboard.java:1 — 4,538 lines (31× median) |
source/net/yacy/cora/protocol/ftp/FTPClient.java:1 — 2,919 lines (19× median) |
source/net/yacy/cora/document/id/MultiProtocolURL.java:1 — 2,769 lines (18× median) |
source/net/yacy/search/query/SearchEvent.java:1 — 2,745 lines (18× median) |
615 errors caught and discarded in product code
adequate615 places catch an error and do nothing with it, across 205 files (1.7 per thousand lines). Each is a failure the system will not report. They surface later as problems nobody can explain, and they are cheap to fix now.
htroot/env/bootstrap/js/jquery.js:891 — error caught and discarded |
htroot/env/bootstrap/js/jquery.js:1466 — error caught and discarded |
htroot/env/bootstrap/js/jquery.js:3660 — error caught and discarded |
Engineering Process & SDLC Maturity
adequateTests cover a thin slice of the codebase
adequate117 test files against 1,171 source files (10.0%). This does not measure whether the tests are good, only whether enough of them exist for the codebase to be changed safely by someone who did not write it — which is exactly the situation after an acquisition.
| 117 test files / 1,171 source files |
Product & Engineering Maturity
adequate17% of bug fixes add or change a test
adequateOf 93 fixes in the last 24 months, 16 touched a test. A fix without the test that would have caught the bug can quietly come back, and the suite never learns from what went wrong.
| 16 of 93 |
14 files still carry code deprecated more than two years ago
adequate14 files were marked deprecated over two years ago and still are, the oldest since Jun 2011. A deprecation is a promise to remove. Ask what still depends on these, and whether removing them is scheduled.
source/net/yacy/cora/protocol/http/NonClosingInputStreamEntity.java — deprecated since Jun 2011 |
source/net/yacy/search/Switchboard.java — deprecated since May 2013 |
source/net/yacy/peers/Seed.java — deprecated since Sep 2014 |
source/net/yacy/peers/SeedDB.java — deprecated since Sep 2014 |
source/net/yacy/peers/PeerActions.java — deprecated since Oct 2014 |
Security & Reliability Posture
adequateNone of the standard security guard rails are configured
adequateThere is no disclosure policy, no automated dependency updates, no named code owners and no pre-commit configuration. None of these is load-bearing on its own. Their collective absence says that security posture here is whatever the current team happens to remember to do, which is not a posture that survives the team changing.
| checked 5 kinds of guard rail across 2,301 tracked files; 0 present |
1 environment file is committed
adequate.env is tracked in git. Environment files are where credentials usually live, and committing one usually means nobody decided how secrets reach the running application. Whatever is in it is in the history for good. Check 05.1 says whether it holds anything credential-shaped.
.env — committed environment file |
The build runs third-party code it does not pin
adequate6 third-party CI actions are referenced by a tag or branch rather than a commit, so they run whatever that tag points to on the day. Tags have been moved to malicious commits in real supply-chain attacks, and a piped script is whatever the server returns that minute. Pinning to a commit is the fix, and it is small.
.github/workflows/ant-build.yaml:61 — action pinned by tag |
.github/workflows/build-docker-image.yaml:37 — action pinned by tag |
7 SQL statements built from strings
adequate7 places in product code build SQL by formatting or joining strings rather than passing parameters. In each, what the code shows going in is a table or column name, a constant, or something the line does not show, not a request's value. Ask whether any value reaches these strings, rather than a parameter.
source/net/yacy/document/content/dao/DatabaseConnection.java:75 — SQL built from a string |
source/net/yacy/document/content/dao/PhpBB3Dao.java:76 — SQL built from a string |
source/net/yacy/document/content/dao/PhpBB3Dao.java:96 — SQL built from a string |
2 deserialisers that can run code
adequate2 places read data with a deserialiser that executes what it reads (Java object streams). That is safe on data the system wrote itself and remote code execution on anything else. Ask where each one's input comes from.
source/net/yacy/kelondro/index/RowHandleSet.java:414 — code-executing deserialiser |
source/net/yacy/repository/Blacklist.java:852 — code-executing deserialiser |
1 advisory against this project in the last 24 months, 1 high or critical
adequateThe newest was published on 2026-08-31. A project that publishes advisories is telling its users about its fixes, and the count and pace say how much security work it carries. None of them affects the surveyed version.
| 2026-08-31: CVE-2026-82880 (high): YaCy Search Server through 1.941 contains an XML external entity injection vulnerability in SVG, FreeMind, and OpenSearch parsers that fail to disable external |
Observability & Operations
adequateNo telemetry or error reporting is wired in anywhere
adequateNone of 1,658 readable files references an instrumentation, metrics or error-reporting library. If this system is in production, nobody learns that it broke from the system itself — they learn it from a customer. That is a reliability finding before it is an observability one.
| searched 1,658 tracked text files for 16 known instrumentation libraries; manifests for metrics, tracing and error-reporting families; locked dependencies for the packages that emit; 0 matched |
No structured logging library is in use
adequateNothing references a structured logging library. Logs that are written to be read by a person are not searchable by a machine, which means incident response here is proportional to how well someone remembers the codebase rather than to what the tooling can find.
| searched 1,658 files for 10 structured logging libraries; 0 matched |
No error reporter is wired in
adequateNothing in the service initialises an error reporter (Sentry, Rollbar, Bugsnag, Honeybadger or an APM agent). An exception in production reaches a person only if someone is reading the logs, which usually means a customer reports it first.
| no error reporter initialised |
Fit with the Acquirer
not assessableNot rated: structurally not assessable from a repository.
Read more, or read your own
The full report on yacy/yacy_search_server: every dimension, the questions for the room, and the audit log.
Survey a repository: free on public repositories. Private code is read on your own machine by a collector whose source you can read first.