Borehole · Project · free tier
freshrss/freshrss
Free reading: not for reliance
d5ad610 · 7,460 commits · 1,287 files
Read 2026-10-04

freshrss/freshrss: technical due diligence, read from its repository

What Borehole read in freshrss/freshrss's code and history at d5ad610: 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

What the repository says

  • AGENTS.md:23: states a policy on AI-generated contributions

Architecture & Codebase — including AI provenance

strong
01.6

lib/phpmailer/phpmailer/src/PHPMailer.php is 5,587 lines, 42× this codebase's median file

adequate

The median source file here is 133 lines. 10 files exceed 1,330 lines, the largest being 5,587. 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
lib/phpmailer/phpmailer/src/PHPMailer.php:1 — 5,587 lines (42× median)
lib/simplepie/simplepie/src/SimplePie.php:1 — 3,710 lines (27× median)
lib/simplepie/simplepie/src/Item.php:1 — 2,444 lines (18× median)
lib/simplepie/simplepie/src/Misc.php:1 — 2,223 lines (16× median)
app/Models/EntryDAO.php:1 — 2,070 lines (15× median)

Engineering Process & SDLC Maturity

adequate
02.3

Tests cover a thin slice of the codebase

adequate

44 test files against 611 source files (7.2%). 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
44 test files / 611 source files

Product & Engineering Maturity

adequate
04.19

8% of bug fixes add or change a test

adequate

Of 281 fixes in the last 24 months, 23 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
23 of 281
04.38

18 files still carry code deprecated more than two years ago

adequate

18 files were marked deprecated over two years ago and still are, the oldest since Apr 2014. A deprecation is a promise to remove. Ask what still depends on these, and whether removing them is scheduled.

Evidence
app/Models/EntryDAO.php — deprecated since Apr 2014
lib/Minz/View.php — deprecated since Jan 2022
lib/Minz/ActionController.php — deprecated since May 2023
app/Models/Context.php — deprecated since Dec 2023
app/Controllers/indexController.php — deprecated since Feb 2024

Security & Reliability Posture

adequate
05.6

1 Dockerfile runs the application as root

adequate

No USER instruction switches away from root, so the process runs with full privileges inside the container. It is a one-line fix and an ordinary expectation, which is why its absence is worth asking about: it usually says more about whether anyone has reviewed the deployment than about this container specifically.

Evidence
Docker/Dockerfile — runs as root
05.22

9 deserialisers that can run code

adequate

9 places read data with a deserialiser that executes what it reads (PHP `unserialize`). 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
app/Controllers/authController.php:184 — code-executing deserialiser
app/Controllers/authController.php:211 — code-executing deserialiser
lib/Minz/Url.php:142 — code-executing deserialiser
05.9

1 vendored component with no licence

adequate

Third-party code is committed into this repository without any statement of the terms it arrived under. Unknown terms are harder to deal with than inconvenient ones: an awkward licence can be complied with, an absent one cannot. Each of these needs its origin established before the code changes hands.

Evidence
p/scripts/vendor/bcrypt.js — 1 tracked files, no licence file
05.65

22 advisories against this project in the last 24 months, 8 high or critical

adequate

The newest was published on 2026-09-26. 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-09-26: GHSA-3fw6-j8m4-82vj (low), fixed in 1.30.0: Stored XSS via javascript: URI in feed enclosure download links (disabled CSP only)
2026-09-26: GHSA-fv9v-wcrw-mhg6 (high), fixed in 1.30.0: Post-Auth SSRF when adding new RSS Feed
2026-03-08: GHSA-pcq9-mq6m-mvmp (critical), fixed in 1.27.2-dev (476e57b): Authentication bypass due to truncated bcrypt hash [edge branch]
2026-03-08: GHSA-w743-fg6g-mhwh (high), fixed in 1.28.0: IDOR allows for viewing feeds of any user and leaking tokens when anonymous viewing of default user is enabled
2025-12-26: GHSA-j9wc-gwc6-p786 (low), fixed in 1.28.0: Weak cryptographic randomness in remember-me token and nonce generation

Observability & Operations

adequate
06.1

No telemetry or error reporting is wired in anywhere

adequate

None of 836 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 836 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 836 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
06.18

1 of 3 deployed images carry no version, or `latest`

adequate

1 images in the deployment configuration are named without a version or as `latest`. A redeploy can change the software without a commit, a rollback has nothing to roll back to, and nobody can say from the repository what is running.

Evidence
Docker/freshrss/docker-compose.yml:7 — image without a version

Fit with the Acquirer

not assessable

Not rated: structurally not assessable from a repository.

Read more, or read your own

The full report on freshrss/freshrss: 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.