Borehole · Project · free tier
yacy/yacy_search_server
Free reading: not for reliance
5fa5576 · 14,940 commits · 2,301 files
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.

DimensionRating
Architecture & Codebase — including AI provenancestrong
Engineering Process & SDLC Maturityadequate
Product & Engineering Maturityadequate
Security & Reliability Postureadequate
Observability & Operationsadequate
Fit with the Acquirernot assessable

Architecture & Codebase — including AI provenance

strong
01.6

htroot/env/bootstrap/js/jquery.js is 11,009 lines, 75× this codebase's median file

adequate

The 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.

Evidence
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)
01.15

615 errors caught and discarded in product code

adequate

615 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.

Evidence
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

adequate
02.3

Tests cover a thin slice of the codebase

adequate

117 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.

Evidence
117 test files / 1,171 source files

Product & Engineering Maturity

adequate
04.19

17% of bug fixes add or change a test

adequate

Of 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.

Evidence
16 of 93
04.38

14 files still carry code deprecated more than two years ago

adequate

14 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.

Evidence
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

adequate
05.2

None of the standard security guard rails are configured

adequate

There 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.

Evidence
checked 5 kinds of guard rail across 2,301 tracked files; 0 present
05.25

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.

Evidence
.env — committed environment file
05.27

The build runs third-party code it does not pin

adequate

6 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.

Evidence
.github/workflows/ant-build.yaml:61 — action pinned by tag
.github/workflows/build-docker-image.yaml:37 — action pinned by tag
05.20

7 SQL statements built from strings

adequate

7 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.

05.22

2 deserialisers that can run code

adequate

2 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.

Evidence
source/net/yacy/kelondro/index/RowHandleSet.java:414 — code-executing deserialiser
source/net/yacy/repository/Blacklist.java:852 — code-executing deserialiser
05.65

1 advisory against this project in the last 24 months, 1 high or critical

adequate

The 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.

Evidence
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

adequate
06.1

No telemetry or error reporting is wired in anywhere

adequate

None 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.

Evidence
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
06.2

No structured logging library is in use

adequate

Nothing 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.

Evidence
searched 1,658 files for 10 structured logging libraries; 0 matched
06.9

No error reporter is wired in

adequate

Nothing 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.

Evidence
no error reporter initialised

Fit with the Acquirer

not assessable

Not 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.