公开记录中等
软件健康报告模式 0.27.0 · 指标 1.13.0 · 2026-07-24 11:55 UTC
flowd / phirewall
Phirewall is a PHP based application firewall that provides a PSR-15 middleware.
flowd/phirewall 的健康指数为 100 分中的 63 分，处于「中等」区间。 其得分最高的类别是Vitality（87/100），最低的是Community & Adoption（36/100）。 最近一次更新在今天。 近期的大部分工作由 1 位贡献者完成。
63
总分 / 100软件健康指数
指标归入加权类别，统一采用 1–100 量表。总体分先取类别加权平均；当公开证据触发高风险司法辖区政策时，评级会按政策调整，并设置 49（有风险）的上限。AI 就绪度不计入总体分。
63
优秀85-100堪称典范；基本满足所有检验标准
良好70-84健康；仅有轻微不足
中等50-69可接受，但存在明显不足；建议进行审查
存在风险30-49存在重大薄弱环节；采用时应保持审慎
危急1-29问题严重（项目被弃置、仅有单一维护者、缺乏基本工程规范）
评分画像
每条轴代表一个类别。形状比平均值更重要——健康的对象会填满整个图形，而“一峰一谷”式画像意味着某一维度的优势正掩盖另一维度的风险。
所有权
软件包生态系统
| 注册表 | 软件包 | 版本 | 月下载量 | 版本数 | 最近发布 |
|---|---|---|---|---|---|
| Packagist | flowd/phirewall | 0.8.0 | 3,581 | 9 | 14 天前 |
按类别列示的指标
活力
项目是否仍有生命——是否仍在编写代码，是否仍在发布版本？
87
开发活跃度
78良好
评分方式
| 36/36 | 推送新近度 — 最近一次推送于 0 天前 |
| 13.8/36 | 提交节奏 — 52 周中有 20 周有提交 |
| 18/18 | 提交量 — 最近一年 147 次提交 |
| 10/10 | OpenSSF Scorecard：Maintained — 30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10 |
所用输入
| commits_last_year | 147 |
| human_commit_share | 1 |
| days_since_last_push | 0 |
| active_weeks_last_year | 20 |
发布纪律
100优秀
评分方式
| 27/27 | 有发布版本 — 已发布 9 个发布版本 |
| 36/36 | 发布时效 — 最近一次发布版本于 14 天前 |
| 27/27 | 发布节奏 — 约每 26.1 天发布一次 |
| 0/10 | OpenSSF Scorecard：Signed-Releases — 无数据 |
所用输入
| releases_count | 9 |
| latest_release_tag | 0.8.0 |
| releases_from_tags | 否 |
| days_since_latest_release | 14 |
| mean_days_between_releases | 26.1 |
已排除计分（无数据或不适用）：OpenSSF Scorecard：Signed-Releases。 其余权重已重新归一化。
社区与采用
项目是否拥有用户、下载量与关注度，并具备欢迎贡献者参与的配置？
36
流行度与采用
20危急
评分方式
| 19.5/60 | 星标 — 17 个星标 |
| 0/25 | 复刻 — 1 个复刻 |
| 0/15 | 关注者 — 0 位关注者 |
所用输入
| forks | 1 |
| stars | 17 |
| watchers | 0 |
| growth_state | unverified |
| growth_factor_pct | 100 |
| growth_unverified_reason | no_history |
社区健康
44存在风险
评分方式
| 22.5/22.5 | README |
| 16.9/22.5 | 许可证 — 存在许可证文件，但不是可识别的许可证 |
| 0/18 | CONTRIBUTING 指南 |
| 0/13.5 | 行为准则 |
| 0/7.2 | 议题模板 |
| 0/6.3 | PR 模板 |
所用输入
| has_readme | 是 |
| has_license | 是 |
| has_contributing | 否 |
| has_issue_template | 否 |
| has_code_of_conduct | 否 |
| has_pull_request_template | 否 |
生态采用（下载量）
52中等
评分方式
| 47.4/80 | 月度下载量 — packagist 合计每月 3,581 次下载 |
| 4.7/20 | 注册表被依赖数 — 4 个软件包依赖它 |
所用输入
| packages | flowd/phirewall |
| dependents | 4 |
| ecosystems | packagist |
| total_downloads | 7,404 |
| monthly_downloads | 3,581 |
可持续性与治理
项目能否在其成员之外延续——巴士系数、响应能力、由谁支持，以及软件包的维护状况？
53
维护者韧性（巴士系数）
15危急
评分方式
| 9/54 | 巴士系数 — 1 位贡献者贡献了半数提交 |
| 0.2/22.5 | 提交分布 — 头号贡献者编写了 99% 的提交 |
| 2.7/13.5 | 贡献者广度 — 2 位贡献者 |
| 3/10 | OpenSSF Scorecard：Contributors — project has 1 contributing companies or organizations -- score normalized to 3 |
所用输入
| bus_factor | 1 |
| contributors_sampled | 2 |
| top_contributor_share | 0.993 |
议题与 PR 响应能力
67中等
评分方式
| 0/46.8 | 议题解决 — 没有议题或无数据 |
| 35.9/38.3 | PR 接受 — 已裁定的 PR 中 108/115 已合并 |
| 0/15 | OpenSSF Scorecard：Code-Review — Found 0/30 approved changesets -- score normalized to 0 |
所用输入
| merged_prs | 108 |
| open_issues | 0 |
| closed_issues | 0 |
| issue_closed_ratio | — |
| closed_unmerged_prs | 7 |
已排除计分（无数据或不适用）：议题解决。 其余权重已重新归一化。
所有权与托管责任
48存在风险
评分方式
| 30/30 | 所有权背书 — 组织持有 |
| 0/20 | 已验证域名 |
| 3.4/25 | 所有者影响力 — flowd 有 2 位关注者 |
| 14.3/25 | 既往记录 — 6 个公开仓库，账户约 4 年 |
所用输入
| followers | 2 |
| owner_type | Organization |
| is_verified | — |
| owner_login | flowd |
| public_repos | 6 |
| account_age_days | 1,484 |
软件包维护
100优秀
评分方式
| 25/25 | 已发布且可解析 — packagist 上有 1 个软件包 |
| 35/35 | 发布时效 — 最近一次发布于 14 天前 |
| 20/20 | 版本历史 — 9 个已发布版本 |
| 20/20 | 未被弃用 — 活跃，未被弃用或撤回 |
所用输入
| packages | flowd/phirewall |
| ecosystems | packagist |
| any_deprecated | 否 |
| min_days_since_publish | 14 |
工程质量
基础的工程与文档实践是否到位？
80
工程实践
84良好
评分方式
| 24/24 | CI 工作流 — 3 个工作流 |
| 24/24 | 存在测试 |
| 16/16 | Linter 配置 — .php-cs-fixer.php |
| 0/9.6 | Pre-commit 钩子 |
| 0/6.4 | .editorconfig |
| 20/20 | OpenSSF Scorecard：CI-Tests — 30 out of 30 merged PRs checked by a CI test -- score normalized to 10 |
所用输入
| has_ci | 是 |
| has_tests | 是 |
| has_editorconfig | 否 |
| has_linter_config | 是 |
| has_precommit_config | 否 |
文档
75良好
评分方式
| 30/30 | README |
| 25/25 | 文档目录 |
| 0/15 | 文档 / 主页站点 |
| 10/10 | 仓库描述 |
| 0/10 | 主题标签 |
| 10/10 | Wiki |
所用输入
| topics | — |
| has_wiki | 是 |
| homepage | — |
| has_readme | 是 |
| has_docs_dir | 是 |
| has_description | 是 |
安全
可见的安全与供应链实践是否稳固，且不存在未解决的高风险司法辖区暴露？
54
安全态势
54中等
评分方式
| 7.5/7.5 | Binary-Artifacts — no binaries found in the repo |
| 2.2/7.5 | Branch-Protection — branch protection is not maximal on development and all release branches |
| 2.5/2.5 | CI-Tests — 30 out of 30 merged PRs checked by a CI test -- score normalized to 10 |
| 0/2.5 | CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected |
| 0/7.5 | Code-Review — Found 0/30 approved changesets -- score normalized to 0 |
| 0.8/2.5 | Contributors — project has 1 contributing companies or organizations -- score normalized to 3 |
| 0/10 | Dangerous-Workflow — 无数据 |
| 0/7.5 | Dependency-Update-Tool — no update tool detected |
| 0/5 | Fuzzing — project is not fuzzed |
| 2.2/2.5 | 许可证 — license file detected |
| 7.5/7.5 | Maintained — 30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10 |
| 0/5 | Packaging — 无数据 |
| 0/5 | Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0 |
| 5/5 | SAST — SAST tool is run on all commits |
| 5/5 | Security-Policy — security policy file detected |
| 0/7.5 | Signed-Releases — 无数据 |
| 0/7.5 | Token-Permissions — 无数据 |
| 7.5/7.5 | Vulnerabilities — 0 existing vulnerabilities detected |
所用输入
| source | openssf_scorecard |
| checks_evaluated | 14 |
| scorecard_version | v5.5.0 |
| checks_inconclusive | 4 |
| scorecard_aggregate | 5.4 |
已排除计分（无数据或不适用）：dangerous_workflow, packaging, signed_releases, token_permissions。 其余权重已重新归一化。
AI 就绪度
该仓库在多大程度上具备与 AI 编码代理协同开发与维护的条件？这是一枚独立的实验性徽章——权重为 0.0，因此单独呈现，不影响总体健康评分。
44
AI 代理上下文与指引
40存在风险
评分方式
| 0/45 | 代理指令 — 没有 CLAUDE.md / AGENTS.md / 编辑器规则 |
| 0/15 | 机器可读文档（llms.txt） |
| 40/40 | 可读的提交历史 — 100 次人类提交中有 96 次说明了意图（结构化标题或解释性正文） |
所用输入
| has_llms_txt | 否 |
| legible_history_share | 0.96 |
| agent_instruction_files | — |
| agent_instruction_max_bytes | — |
验证循环（构建 / 测试 / 类型检查）
45存在风险
评分方式
| 0/18 | 一条命令的引导启动 |
| 22/22 | 自动化测试 |
| 11/11 | Lint / 格式化配置 — .php-cs-fixer.php |
| 0/11 | 静态类型检查 |
| 10/10 | 可复现环境 — Dockerfile |
| 2/10 | 已体现的代理实践 — 最近 100 次提交中有 1 次由代理编写或署名代理 |
| 0/8 | 自动化维护 — 未观察到自动依赖更新 |
| 0/10 | OpenSSF Scorecard：Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0 |
所用输入
| has_nix | 否 |
| has_tests | 是 |
| lockfiles | — |
| has_dockerfile | 是 |
| typed_language | 否 |
| bootstrap_files | — |
| has_devcontainer | 否 |
| has_linter_config | 是 |
| typecheck_configs | — |
| agent_commit_share | 0.01 |
| toolchain_manifests | — |
| dependency_bot_commit_share | 0 |
面向模型的代码可读性
55中等
评分方式
| 0/45 | 可类型检查的代码 — PHP，未配置类型检查 |
| 55/55 | 可控的文件大小 — 采样的 213 个源文件中有 0 个超过 60KB |
所用输入
| primary_language | PHP |
| largest_source_bytes | 54,692 |
| source_files_sampled | 213 |
| oversized_source_files | 0 |
机器可读接口
40存在风险
评分方式
| 0/40 | API 模式（OpenAPI/GraphQL/proto） |
| 0/20 | MCP 服务器 |
| 40/40 | 可运行示例 — examples |
所用输入
| example_dirs | examples |
| has_mcp_signal | 否 |
| api_schema_files | — |
关键数据
17GitHub 星标
2贡献者
147最近 12 个月提交数
0距最近推送天数
9发布版本数
1巴士系数（bus factor）
0开放议题
Packagist软件包生态系统数
数据采集警告
- Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
- No resolved dependencies carried a version and a supported ecosystem
更多细节
OpenSSF Scorecard 5.4 / 10
5.4综合
来自开源项目 OpenSSF Scorecard 的独立、工具无关的安全评估。每项检查奖励的是安全实践本身，而非特定供应商的工具。Scorecard 无法判定的检查项标记为 不适用，并从安全评分中剔除（绝不按零分计）。
| 10 | Binary-Artifacts | no binaries found in the repo |
| 3 | Branch-Protection | branch protection is not maximal on development and all release branches |
| 10 | CI-Tests | 30 out of 30 merged PRs checked by a CI test -- score normalized to 10 |
| 0 | CII-Best-Practices | no effort to earn an OpenSSF best practices badge detected |
| 0 | Code-Review | Found 0/30 approved changesets -- score normalized to 0 |
| 3 | Contributors | project has 1 contributing companies or organizations -- score normalized to 3 |
| 不适用 | Dangerous-Workflow | no workflows found |
| 0 | Dependency-Update-Tool | no update tool detected |
| 0 | Fuzzing | project is not fuzzed |
| 9 | License | license file detected |
| 10 | Maintained | 30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10 |
| 不适用 | Packaging | packaging workflow not detected |
| 0 | Pinned-Dependencies | dependency not pinned by hash detected -- score normalized to 0 |
| 10 | SAST | SAST tool is run on all commits |
| 10 | Security-Policy | security policy file detected |
| 不适用 | Signed-Releases | no releases found |
| 不适用 | Token-Permissions | No tokens found |
| 10 | Vulnerabilities | 0 existing vulnerabilities detected |
直接依赖 6
| 注册表 | 软件包 | 版本约束 | 清单文件 |
|---|---|---|---|
| Packagist | psr/http-message | ^1.1 || ^2.0 | composer.json |
| Packagist | psr/http-server-middleware | ^1.0 | composer.json |
| Packagist | psr/http-server-handler | ^1.0 | composer.json |
| Packagist | psr/http-factory | ^1.1 | composer.json |
| Packagist | psr/simple-cache | ^3.0 | composer.json |
| Packagist | psr/event-dispatcher | ^1.0 | composer.json |
全部依赖 14
来自 GitHub 依赖图的完整解析依赖集合：6 个直接依赖与 8 个间接（传递）软件包。仓库提交锁文件时，传递闭包才是完整的。
| 注册表 | 软件包 | 版本 | 关系 |
|---|---|---|---|
| Packagist | psr/event-dispatcher | — | 直接 |
| Packagist | psr/http-factory | — | 直接 |
| Packagist | psr/http-message | — | 直接 |
| Packagist | psr/http-server-handler | — | 直接 |
| Packagist | psr/http-server-middleware | — | 直接 |
| Packagist | psr/simple-cache | — | 直接 |
| Packagist | friendsofphp/php-cs-fixer | — | 间接 |
| Packagist | infection/infection | — | 间接 |
| Packagist | mikey179/vfsstream | — | 间接 |
| Packagist | nyholm/psr7 | — | 间接 |
| Packagist | php | — | 间接 |
| Packagist | phpstan/phpstan | — | 间接 |
| Packagist | phpunit/phpunit | — | 间接 |
| Packagist | rector/rector | — | 间接 |
依赖安全公告 未评估
本报告未能完成公告比对：No resolved dependencies carried a version and a supported ecosystem
原始 JSON 报告 机器可读
{
"data": {
"repo": {
"topics": [],
"is_fork": false,
"size_kb": 1074,
"has_wiki": true,
"homepage": null,
"languages": {
"PHP": 1090603,
"Shell": 3600
},
"pushed_at": "2026-07-24T11:52:29Z",
"created_at": "2025-11-10T10:54:52Z",
"owner_type": "Organization",
"updated_at": "2026-07-11T09:43:27Z",
"description": "Phirewall is a PHP based application firewall that provides a PSR-15 middleware.",
"is_archived": false,
"is_disabled": false,
"license_spdx": null,
"default_branch": "main",
"license_spdx_raw": "NOASSERTION",
"primary_language": "PHP",
"significant_languages": [
"PHP"
]
},
"owner": {
"blog": "https://flowd.de",
"name": "Flowd GmbH",
"type": "Organization",
"login": "flowd",
"company": null,
"location": "Germany",
"followers": 2,
"avatar_url": "https://avatars.githubusercontent.com/u/108519466?v=4",
"created_at": "2022-07-01T08:54:03Z",
"is_verified": null,
"public_repos": 6,
"account_age_days": 1484
},
"license": {
"state": "custom",
"spdx_id": null,
"raw_spdx": "NOASSERTION",
"file_present": true,
"scorecard_found": true,
"profile_has_license": true
},
"activity": {
"releases": [
{
"tag": "0.8.0",
"kind": "minor",
"published_at": "2026-07-09T20:11:46Z"
},
{
"tag": "0.7.0",
"kind": "minor",
"published_at": "2026-07-02T15:27:32Z"
},
{
"tag": "0.6.0",
"kind": "minor",
"published_at": "2026-06-17T21:34:15Z"
},
{
"tag": "0.5.0",
"kind": "minor",
"published_at": "2026-06-08T22:28:22Z"
},
{
"tag": "0.4.0",
"kind": "minor",
"published_at": "2026-05-19T12:59:39Z"
},
{
"tag": "0.3.0",
"kind": "minor",
"published_at": "2026-04-08T13:16:03Z"
},
{
"tag": "0.2.0",
"kind": "minor",
"published_at": "2026-02-05T00:06:40Z"
},
{
"tag": "0.1.1",
"kind": "patch",
"published_at": "2025-12-15T19:25:19Z"
},
{
"tag": "0.1.0",
"kind": "minor",
"published_at": "2025-12-12T17:03:01Z"
}
],
"recent_commits": [
{
"oid": "76efa746582671f42e50496ae6f4acc0acada09b",
"body": "* Simplify example rule keys and clarify marker-based demos\n\nDrop the raw REMOTE_ADDR key closures so counter rules default to the\nresolved client IP; in example 08 this also honours the configured proxy\nresolver instead of bypassing it. Switch the example 06 persistent-scanner\nfail2ban to the signa\n[…]\nilter, hits reported via\nRequestContext::recordFailure) and add trust-boundary notes to the\nmarker-based demos in examples 08 and 11.\n\n* Point example 11 marker note to the concrete recordFailure demo",
"is_bot": false,
"headline": "Simplify example rule keys and clarify marker-based demos (#115)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-07-11T09:43:22Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "77837ca1e2bc4e87ee020c20f8f9b14a49afd9c3",
"body": null,
"is_bot": false,
"headline": "Finalize the 0.8.0 changelog entry (#114)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-07-09T20:08:33Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "583700f8996bc913bd70277fed3b90d5d768787b",
"body": "* Use product-neutral scanner probe paths in tests\n\n* Use a boundary check for .git probe paths to avoid matching .github",
"is_bot": false,
"headline": "Use product-neutral scanner probe paths in tests (#113)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-07-09T19:57:32Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "366a3ae916cdb9e6c70a2c7319b25da45f92806d",
"body": null,
"is_bot": false,
"headline": "Block every fail2ban filter match, add optional allow2ban filters (#112)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-07-08T20:22:07Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f1bcb3b6c46a0364a3e4f3a34652f2429da4179f",
"body": null,
"is_bot": false,
"headline": "Open 0.8.0 development: alias dev-main to 0.8.x-dev (#111)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-07-02T15:53:12Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9bb9429a9b66fb80d0982a0831fa4ea06456667b",
"body": null,
"is_bot": false,
"headline": "Finalize the 0.7.0 changelog entry (#110)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-07-02T15:21:39Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "997cc9ae13de93d7fb17bf9ff14b3dfe05140960",
"body": null,
"is_bot": false,
"headline": "Scope clear() iterator to keys only, skip value metadata (#109)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-07-02T14:53:44Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "808cd64eef5bfb17e27a34addae50f1afc7930c5",
"body": "* Namespace ApcuCache keys and scope clear() to the namespace\n\n* Guard increment() period, drop the expiry sidecar on expired set()",
"is_bot": false,
"headline": "Namespace ApcuCache keys and scope clear() to the namespace (#107)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-07-02T12:58:52Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "981954daa5ea030b1c04af925e52e2e8a7049056",
"body": "* Stop the trusted-proxy chain walk at unparsable hops\n\n* Keep extraction-failing Forwarded for= hops in the chain so they stay terminal",
"is_bot": false,
"headline": "Stop the trusted-proxy chain walk at unparsable hops (#108)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-07-02T12:20:10Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b8b26845898230700e0c6d9dba1b35217ef56bd9",
"body": null,
"is_bot": false,
"headline": "Deprecate KeyExtractors::ip() and drop its usages (#106)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-18T22:00:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8a61fe32f205fb128290c01e11eb2fd58f8978a6",
"body": "PortableConfig::keyIp() now materializes as a keyless rule, so it late-binds to\nthe evaluating Config's IP resolver (else REMOTE_ADDR) like keyless counter rules,\nfilterIp(), and IP-aware matchers - instead of always keying on raw REMOTE_ADDR.\nWire format and phirewall.config.v1 are unchanged, so se\n[…]\n the resolved client IP is now the default for\nevery rule, so configure proxy trust once with setIpResolver($tpr->resolve(...)).\nKeyExtractors::ip() stays as the explicit raw REMOTE_ADDR escape hatch.",
"is_bot": false,
"headline": "Resolve the client IP by default for portable keyIp() (#104)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-18T21:32:56Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "66d0778e6ce29f0f3028662c78b50d75f3147588",
"body": null,
"is_bot": false,
"headline": "Open 0.7.0 development: alias dev-main to 0.7.x-dev (#102)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-17T21:54:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b504a8d0b2c1f27e94dfcf988b833ee5653e6c4f",
"body": null,
"is_bot": false,
"headline": "Finalize the 0.6.0 changelog entry (#101)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-17T21:27:07Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "89edea26824a465c314c14f1ea49e3e997ac2914",
"body": null,
"is_bot": false,
"headline": "Suggest the bad-IP and bot preset packages (#100)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-17T21:25:39Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c505b4b8c676609214c261821475eac099986f91",
"body": null,
"is_bot": false,
"headline": "Late-bind the client-IP resolver into IP-aware matchers (#99)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-16T21:09:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3040aa7973e80483fdd4fff32505652f5d7d2107",
"body": null,
"is_bot": false,
"headline": "Cover the OWASP diagnostics header emission in BlocklistEvaluator (#98)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-16T13:04:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ab119eec3385ca39af4eca879f11aa1a1754292e",
"body": null,
"is_bot": false,
"headline": "Remove the safelists->trustedBots() convenience method (#97)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-16T10:18:57Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e406e9bb686eaaaee4a1b76776755569afcd5876",
"body": null,
"is_bot": false,
"headline": "Extract the OWASP CRS engine into flowd/phirewall-preset-owasp-crs (#95)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-15T21:07:16Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "760ca0e75693a0f3719234fc7219ee7712495c24",
"body": null,
"is_bot": false,
"headline": "Unify config composition behind Config::with(ConfigLayer) (#96)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-15T20:21:38Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ea2e89de6cf8264b5283f9e5d2fae2956318faeb",
"body": "…ache backend (#90)\n\nBanManager pre-encoded the registry to a JSON string, but RedisCache returns a\ndecoded array for a stored JSON document, so loadRegistry's is_string() check read\nthe registry back empty on Redis - listBans() showed nothing and clearBans() did\nnothing. Store the array directly and accept either an array or a legacy JSON string\non read.",
"is_bot": false,
"headline": "Store the ban registry as a native array so it round-trips on every c…",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-10T14:54:20Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7602a20e6efd1e2b912afcad1a085e3422ac913a",
"body": "Spell out on Config::setFailOpen(), the failOpen property and the README that failing\nopen skips all rules for the duration of a firewall-internal error (a FirewallError\nevent is dispatched), and on KeyExtractors::header() and the README that a header-keyed\nrule is skipped when the header is absent. Documentation only.",
"is_bot": false,
"headline": "Document the fail-open and header-key skip behaviours (#91)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-10T14:48:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "87ba738b149c57ea38b019d2379d369862093cda",
"body": "…ne errors (#88)",
"is_bot": false,
"headline": "Fix @rx evaluator to inspect oversized values and fail closed on engi…",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-10T06:08:13Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d12133e374b90a3e66c4a4120e0a3a38a3f3242d",
"body": "…(#89)\n\n* Flatten nested ARGS parameters when collecting OWASP variable values\n\nArgsCollector descended only one array level, so a nested parameter like a[b][c]=x\nhad its leaf value dropped and was never matched by ARGS-targeting rules. Recurse to\nevery scalar leaf and collect keys at each level. Th\n[…]\n $namePrefix and note that PHP assigns numeric\nindices to list-style parameters (foo[]=a -> foo[0]), so the rebuilt name reflects how\nPHP parsed the request rather than a recoverable literal original.",
"is_bot": false,
"headline": "Flatten nested ARGS parameters when collecting OWASP variable values …",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-10T06:05:26Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "e6bf70d0a8cb11f13a5c8207555563a86871aaca",
"body": "The file pattern format escapes only the delimiter and backslash, so a value or\ntarget containing a raw newline was serialised verbatim and re-parsed as a second,\ninjected entry on read. No pattern kind carries a raw newline, so reject it at the\nvalue-object boundary, which covers every backend.",
"is_bot": false,
"headline": "Reject line breaks in PatternEntry value and target (#94)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-09T21:52:12Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c068b881ce4a15a38ac73b75ba50d7a3e76c1d54",
"body": "ApacheHtaccessAdapter::mutate() always rewrote the whole file under the exclusive\nlock, so an already-blocked client hitting the firewall drove an O(file) read-modify-\nrewrite on every request. Return early when the mutator leaves the entry set unchanged.\nAlso note on SyncNonBlockingRunner that it runs the task inline.",
"is_bot": false,
"headline": "Skip the htaccess rewrite when the blocked-IP set is unchanged (#93)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-09T21:52:03Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f9d3cb884b3a8d506472d3541247f1d56666b5e7",
"body": "FileIpBlocklistStore wrote any trimmed non-comment value verbatim, so a value\ncarrying a newline was split into a second entry on read (e.g. an injected\n0.0.0.0/0). Validate each entry as a plain IP or CIDR before persisting and skip\nanything else, matching the matcher's read-side parse.",
"is_bot": false,
"headline": "Validate file blocklist entries as IP or CIDR on write (#92)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-09T21:51:53Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "dbfb282d6684578f39980844cb3d3bf0002cde21",
"body": "The example kept a long-lived Firewall and rebuilt it only on a version\nchange, which applies only to long-running worker runtimes. Under PHP-FPM\nevery request is a fresh process, so example 29 now loads the signed ruleset\nand builds the Config per request (Request A sees v1, an operator publishes\nv\n[…]\n), with a comment noting the worker-runtime\nrebuild-on-change optimization. Also moves the fail2ban demo off the forgeable\nX-Login-Failed marker onto a path-probe rule, and drops the file's em dashes.",
"is_bot": false,
"headline": "Load the portable-config database example per request (#86)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-09T15:23:53Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "66e21ba32290808a0bf1d68e1a7aa7575187755e",
"body": "Both hardcoded an application's own routes (/api, /login), which vary per app,\nso they do not belong in a shipped, universal preset catalogue. Presets now\nship only universal-signal bundles: scannerBlocking() and\nsensitivePathBlocking(). Route-specific protection (API rate limiting, login\nbrute-forc\n[…]\n\nupdates names()/get() and the class docblock, rewrites PresetsTest and\nexamples/31-presets.php, and trims the CHANGELOG entry. filterNone() and the\nthrottle scope filter remain as general primitives.",
"is_bot": false,
"headline": "Drop the route-scoped apiRateLimiting and loginProtection presets (#85)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-09T15:04:59Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "c226ef27f4d1b39b4bc1e47a999b68c21d38906b",
"body": null,
"is_bot": false,
"headline": "Open 0.6.0 development: alias dev-main to 0.6.x-dev (#87)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-09T09:52:28Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "44c495b9a90ef0ed0af74f42b75180dd019317c5",
"body": null,
"is_bot": false,
"headline": "Finalize the 0.5.0 CHANGELOG (#84)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-08T22:27:32Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ecbf44a02f9f9652b25b9012f4bcda0e21a3e08b",
"body": "…(#83)\n\nThe normalizer is applied by all four counter evaluators (throttle, fail2ban,\nallow2ban, track); the docblock omitted allow2ban.",
"is_bot": false,
"headline": "Document allow2ban in the setDiscriminatorNormalizer applies-to list …",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-08T21:23:39Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "48d2327499f3b0379bee4661a9a29246afaf0363",
"body": "Alias the dev-main branch to 0.5.x-dev so consumers requiring the latest\nreleased minor (^0.5.0) resolve against the development branch.",
"is_bot": false,
"headline": "Add dev-main branch-alias (#80)",
"author_name": "Jan Stockfisch",
"author_login": "KamiYang",
"committed_at": "2026-06-08T15:02:33Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "dfe8f925a29d1a13ee5947294e7e2871c52443c6",
"body": "* Default rule key to the configured client IP when omitted\n\nThe $key argument on throttles->add()/sliding()/multi(), fail2ban->add(),\nallow2ban->add(), and tracks->add() is now optional. A keyless rule stores a\nnull key extractor; the new Config::resolveKey() resolves it per request\nagainst the Con\n[…]\ng::resolveKey() so the\npre-handler evaluators and the recorded-signal path treat \"\" the same way (no\nkey, rule skipped). Fix the TrackRule constructor phpdoc to document the now\nnullable keyExtractor.",
"is_bot": false,
"headline": "Default rule key to the configured client IP when omitted (#82)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-08T15:01:33Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "273893b10a514fea975f1bc195c6acdb3335060a",
"body": "The pre-sections convenience methods on Config (safelist(), blocklist(),\nthrottle(), fail2ban(), track(), owaspBlocklist(), the add*/get* helpers,\nand the response-factory setters/getters) are removed. Callers use the\nsection API (safelists->add(), fail2ban->add(), ...) and the public\nblocklistedResponseFactory / throttledResponseFactory properties; the\ntest suite is migrated accordingly.",
"is_bot": false,
"headline": "Remove the deprecated DeprecatedConfigMethods trait from Config (#81)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-08T13:25:20Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "327ec5b04268763733cd1f96f0f1d6764f8d5153",
"body": "Replaces the interrelated magic numbers in CacheKeyGenerator's name-truncation\nlogic with named constants (MAX_NAME_LENGTH, HASH_SUFFIX_LENGTH) so the budget\nthat keeps generated keys under the backend length limit is self-documenting.",
"is_bot": false,
"headline": "Name CacheKeyGenerator's key-truncation budget constants (#79)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-03T21:55:55Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e8d25ea40043c2b9c6ba259c46325692c156dac6",
"body": "InMemoryCache and ApcuCache share their trivial getMultiple/setMultiple/\ndeleteMultiple via a single BulkCacheOperationsTrait (PdoCache and RedisCache\nkeep their batched overrides). setMultiple()/deleteMultiple() now return false\nwhen any underlying per-key operation fails instead of always returning true.\nInMemoryCache routes its clock fallback through a now() helper, and RedisCache's\nvalue-encoding contract is documented.",
"is_bot": false,
"headline": "Share PSR-16 bulk cache operations with per-key failure reporting (#78)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-03T21:43:16Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "593e1053dd3acb00a51c931b4731d91e982c1fde",
"body": "…alk (#77)\n\nTrustedProxyResolver previously read only the last X-Forwarded-For / Forwarded\nheader instance, assuming a prepended duplicate line lands in an earlier\ninstance and is ignored. RFC 7230 lets intermediaries fold multiple field-lines\ninto one comma-separated value (nginx's default), so that assumption broke on\nfolded stacks. The resolver now flattens all instances into one chain and relies\nsolely on the right-to-left trusted-hop walk, so folded and unfolded forms\nresolve identically.",
"is_bot": false,
"headline": "Flatten all XFF / Forwarded header instances before the trusted-hop w…",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-03T21:00:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "bf1d6677dda56f38025581e93c466503a5ba9650",
"body": "Http\\Firewall::isBanned() and BanManager::isBanned() previously defaulted\n$banType to opposite values (Fail2Ban vs Allow2Ban), so calling the wrong one\nsilently queried the wrong ban namespace and returned a false negative. The\ndefault is removed on both; callers must pass the BanType explicitly. Also\ndocuments Firewall as the supported runtime-management entry point.",
"is_bot": false,
"headline": "Require an explicit BanType on isBanned() (#75)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-03T20:34:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "383a859794070b4c837683437f399883217ef15e",
"body": "* Use null (not []) for SuspiciousHeaders default header set\n\nSuspiciousHeadersMatcher and BlocklistSection::suspiciousHeaders() previously\nsignalled 'use the curated defaults' with an empty array, the opposite of the\nsibling KnownScannerMatcher/knownScanners() which use ?array = null. Both now\nstan\n[…]\n of throwing, matching the matcher and compiler semantics, and the\ntransport validator accepts it so the intent round-trips through fromArray().\n\n* Remove duplicated SuspiciousHeaders CHANGELOG bullet",
"is_bot": false,
"headline": "Use null (not []) for SuspiciousHeaders default header set (#74)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-03T20:28:58Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "64cb8178c04a2e7091cb9416d7dcdeafb7b6d721",
"body": "PresetUpdateChecker and NullPresetUpdateChecker had no library consumer (nothing\naccepted or called them), so they are removed along with their test. Integrators\ndetect ruleset updates by comparing Presets::VERSION against their own release\nfeed with version_compare(); the Presets docblock, README, and example 31 show\nthat instead. Also drops the stale in-repo docs/advanced/portable-config.md (the\ndocs site is canonical) and refreshes the DeprecatedConfigMethods version marker.",
"is_bot": false,
"headline": "Remove the unused PresetUpdateChecker seam (#76)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-03T08:26:15Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "44468519ef43df76b32c1f69e90a531934f04ebb",
"body": "…rs (#72)\n\nBoth evaluators resolve every rule's ban key in one upfront getMultiple()\ninstead of a has() per rule, so the common no-ban path costs one cache\nround-trip regardless of rule count. Fail2BanEvaluator returns on the first\ndecision. Allow2BanEvaluator captures the first block in an Allow2Ba\n[…]\n the batched snapshot so a later rule that normalizes to\nthe same key observes the ban and skips re-banning it. Allow2Ban also defers the\nRetry-After TTL lookup to the at-most-once block construction.",
"is_bot": false,
"headline": "Batch ban-key existence checks in the fail2ban and allow2ban evaluato…",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-02T21:22:50Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "b1acae219175232c256eb5b12590ae405ac09735",
"body": "Adds the fully_qualified_strict_types rule and applies it across src and tests:\nalready-imported class references in docblocks ({@see ...}) and inline\n(instanceof) drop their redundant leading namespace, and an Outcome enum\nreference's casing is normalized to match the import.",
"is_bot": false,
"headline": "Enable PHP CS Fixer fully_qualified_strict_types (#73)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-02T20:47:39Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "46a1923231c2026b13378ca7bf82486db7df180e",
"body": "splitTopLevel() and parseActions() now share one quote- and escape-aware\nscanSpans() scanner instead of each duplicating the quote-state loop. An\nunterminated quote in the actions part is flagged `open` so parseActions keeps\nthe remainder intact (commas included) rather than splitting it.",
"is_bot": false,
"headline": "Extract a shared quote-aware scanner in SecRuleParser (#71)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-02T20:18:42Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b973b7b7585924477811c45db0d2f4e4ec230921",
"body": "…mit (#70)\n\nCoreRuleSet collects each request variable once per request via a shared\nRequestVariableValues memo instead of re-deriving it for every rule. The number\nof values evaluated per variable is bounded by a configurable cap (the new\n$maxValuesPerVariable argument on CoreRuleSet and SecRuleLoa\n[…]\nun-inspectable oversized request is\ntreated as a match) rather than letting a payload padded past the cap slip\nthrough unevaluated. Removes the now-unused VariableCollectorFactory::createCollectors().",
"is_bot": false,
"headline": "Cap OWASP CRS per-variable values with a fail-closed, configurable li…",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-02T19:51:57Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "dbf56fbd264836918154e9395a02ccde7236b625",
"body": "FilePatternBackend::consume() reuses its parsed snapshot while the file is\nunchanged, rebuilding only when the file's mtime advances or the earliest\npending entry expiry passes (folded into the snapshot version so a long-lived\nSnapshotBlocklistMatcher recompiles and drops expired patterns). The matcher\nresolves header-targeted patterns via the PSR-7 case-insensitive accessor\ninstead of building a lowercased header map per request. Removes the unused\nPatternFrontendInterface marker.",
"is_bot": false,
"headline": "Cache the parsed pattern snapshot on the blocklist read hot path (#69)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-02T14:41:13Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "61874a75adadd8f9e7af306490fb3a01c092b41b",
"body": "Reject empty, reserved, control/whitespace, and non-string keys via a\nshared KeyValidationTrait, throwing InvalidCacheKeyException. Fail fast in\nConfig::setKeyPrefix() when a prefix carries the same invalid characters, so\na bad prefix is rejected at config time instead of on the first cache\noperation. Switch the internal key separator from ':' to '.' so generated\nkeys are compliant, which resets ephemeral throttle/ban counters once on\nupgrade.",
"is_bot": false,
"headline": "Validate cache keys per PSR-16 in all store backends (#65)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-01T21:48:27Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "88d3b6869890e961ac6f7ad05134013c5d6f8bf9",
"body": null,
"is_bot": false,
"headline": "Add Presets and materialize PortableConfig via Config::combine() (#64)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-01T17:49:28Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ad9e9831ec5a30c59a1b3c53e82c986bd891bd68",
"body": "Add Config::compose() and the fluent Config::mergedWith() to merge a\nbase Config with overlay Configs without mutating any input. Later\nlayers win: rules merge by name within each section (replace in place,\nappend new), pattern backends merge by name, and scalar/object options\nfollow last-explicit-value-wins. Infrastructure (cache, dispatcher,\nclock) is inherited from the base.",
"is_bot": false,
"headline": "Compose and layer multiple Configs into one effective Config (#63)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-01T12:25:15Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "591a9024d223baab5db472f80df484b3204a7cb3",
"body": "Expand the portable schema to cover allow2ban rules, pattern backends, and\nthe ip / known-scanner / suspicious-header matchers, plus path/method/header\nfilter variants, a sliding throttle flag, hashed-header keys, and the\nfailOpen / owaspDiagnosticsHeader options. toConfig() now registers rules\nthrough the section API instead of the deprecated forwarding methods. All\nadditions are backward compatible.",
"is_bot": false,
"headline": "Promote PortableConfig to a first-class transport (#62)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-01T11:13:15Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "54e038678ac343d839cf009258937fbf10fc1840",
"body": "toSignedJson() and loadSigned() wrap toArray() / fromArray() with a\nJWS-compact-style HMAC-SHA256 envelope and a hash_equals() constant-time\nverification. Useful when the serialized config is read from storage the\ncaller does not fully control. fromArray() is unchanged; its docblock\nnow points at the signed helpers for that case.",
"is_bot": false,
"headline": "Add signed transport for PortableConfig (#61)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-06-01T08:12:29Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "65ba0e9b43d45f4f0b07b48a792e0408e13adfe0",
"body": "A safelist that matches on a static header value is a bypass token —\nanyone sending the header value skips every other rule, and the value\nsits in the rules file in plaintext. PortableConfig::safelist() and\nfromArray() now reject header_equals filters for safelists; blocklist /\nfail2ban / track usage is unchanged. The compiled header_equals\ncomparison uses hash_equals() for constant-time semantics.",
"is_bot": false,
"headline": "Restrict header_equals in safelists and switch to hash_equals (#60)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-05-31T19:13:11Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1215acb8a2a477da6a9a570449ef97a2a3be1c3c",
"body": "IpMatcher and TrustedProxyResolver compared IPs by textual form, so the\nsame host observed as `::ffff:1.2.3.4` (dual-stack peer) vs `1.2.3.4`\n(rule), or `2001:0db8::1` vs `2001:db8::1`, fell through to no-match\neven though they're identical. Both call sites now normalise via\ninet_pton and look up in a binary set; the IPv4 ↔ IPv4-mapped-IPv6\ncross-form is handled explicitly. CIDR semantics unchanged.",
"is_bot": false,
"headline": "Canonicalise IPv6 in IpMatcher and TrustedProxyResolver (#59)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-05-31T19:06:56Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b2bd5afb0d6920e7162891216ff8287fc6cdb539",
"body": "PSR-7's getHeaderLine() concatenates duplicate header instances with\n\", \". When a request carried more than one X-Forwarded-For line, the\njoined string mixed values across instances and the right-to-left walk\nno longer mapped onto the proxy's appended chain. The resolver now\niterates getHeader() and uses the last non-empty instance, so the\nclosest-to-us proxy's addition is the one inspected.",
"is_bot": false,
"headline": "Read only the last X-Forwarded-For / Forwarded header instance (#58)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-05-31T18:12:54Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e0f524dc2e28ea2d349e959090ad7e437f465f59",
"body": "The previous filter — `fn($req) => $req->getHeaderLine('X-Login-Failed')\n=== '1'` — evaluates against the request, so a real brute-forcer never\ntrips it. Example 02 only appeared to work because the test harness\npre-injected the marker into simulated requests. README and example 02\nnow show the supported pattern: the handler retrieves the\nRequestContext attribute and calls recordFailure(), and Middleware\napplies the signal after the response is built.",
"is_bot": false,
"headline": "Switch fail2ban Quick-Start and example 02 to RequestContext (#57)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-05-31T18:08:49Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "eff8a55bdf87e2333901e63ee56a993333be1014",
"body": "… (#56)\n\nBoth classes default to KeyExtractors::ip() (REMOTE_ADDR) when no\nresolver is supplied. Behind a CDN or load balancer that returns the\nproxy's address. The constructor docblocks now point integrators at\nKeyExtractors::clientIp(new TrustedProxyResolver([...])) for that case.",
"is_bot": false,
"headline": "Document the REMOTE_ADDR default on file-blocklist and infra listener…",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-05-31T18:01:15Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5b75ddf2d66dbaabd350ce9e7cbc7d8c7a380992",
"body": "blockMany() / unblockMany() now go through a mutate() helper that\nacquires an exclusive flock on `${htaccessPath}.lock` before the\nread-modify-rename cycle. The lock file is never renamed (the htaccess\nitself is), so the lock remains a stable target across concurrent\nwriters and prevents update loss when two processes call blockIp at\nthe same moment.",
"is_bot": false,
"headline": "Serialise ApacheHtaccessAdapter writers via a sidecar flock (#54)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-05-30T20:46:25Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9b12e641a355f15761c3eff8b16f60de44469366",
"body": "… and 0700 dirs (#55)",
"is_bot": false,
"headline": "Serialize file-store writers via a sidecar lock; atomic-rename writes…",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-05-30T20:37:04Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "50b7948eb820b0538c85c7c185fe559e412369b4",
"body": "When a context folder is configured, @pmFromFile operands are now\nrejected if absolute, and the resolved (realpath) location must remain\nunder the context folder. This catches symlink-based escapes in addition\nto the existing literal-`..` check. The contextFolder=null path is\nunchanged for in-process callers and SecRuleLoader::fromString().",
"is_bot": false,
"headline": "Confine @pmFromFile resolution to its context folder (#53)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-05-30T20:12:57Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "db0a92818ae72ab988c0ac8c49d1c19f661b2441",
"body": "The two-element default (`['X-Forwarded-For', 'Forwarded']`) inferred\nwhich header to consume from declaration order. Defaulting to a single\nheader (`X-Forwarded-For`) makes the choice explicit at the call site;\nintegrators using RFC 7239 `Forwarded` pass that name themselves.",
"is_bot": false,
"headline": "Default TrustedProxyResolver to a single allowed header (#51)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-05-29T20:47:59Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a6556b17db7e86b697484264b60b9cd50d99c24e",
"body": "When a per-key rule is keyed on Authorization / X-Api-Key / similar, the\nraw value flows into the cache backend and the ban registry. The new\nhashedHeader() extractor returns a sha256 fingerprint of the header\nvalue instead, so the storage layer never sees the original secret.\nThe header() docblock points readers at the new helper.",
"is_bot": false,
"headline": "Add KeyExtractors::hashedHeader for sensitive headers (#52)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-05-29T20:36:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "52944814e2fc78e46e740147fd6811c887b604b4",
"body": "Entries like [2001:db8::1]:443 — the RFC 7239 form for IPv6 in\nForwarded for=, and one some proxies emit in X-Forwarded-For — were\ndropped: bracket-stripping left 2001:db8::1]:443, which then failed\nFILTER_VALIDATE_IP and caused a silent fallback to REMOTE_ADDR.\n\nnormalizeIp() now extracts the address from [...](:port)? before\nvalidation, and the Forwarded for= regex no longer over-captures the\ntrailing ].",
"is_bot": false,
"headline": "TrustedProxyResolver: resolve bracketed IPv6+port forms (#50)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-05-29T19:58:12Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f1824b7e254e7c8ed827749b7ad5124ac215890b",
"body": "… (#49)\n\nextractChain() iterated X-Forwarded-For / Forwarded from the left and\nstopped at maxChainEntries (default 50), discarding the proxy-appended\ntail when chains were oversized. The parser now slices to the last N\nentries before the right-to-left walk in resolve(), which is the\ndirection that c\n[…]\nhe authoritative entries.\n\nAlso consolidates per-entry cleanup in normalizeIp() (it was duplicated\nin extractChain()) and factors the split / trim / slice pattern into a\nshared splitAndSlice() helper.",
"is_bot": false,
"headline": "TrustedProxyResolver: keep rightmost N entries when truncating chains…",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-05-29T19:37:33Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "f84b44d516bcdac7ef08aa6a5db6e2c8e5ff69da",
"body": "Example 09 (Monolog) previously logged get_object_vars($event), which\nserialises the embedded ServerRequest (every header + parsed body) into\nthe log sink. Example 10 (OpenTelemetry) put $event->key into a span\nattribute, which can be the raw Authorization / X-Api-Key value for\nrules keyed on those headers. Both examples now extract rule, method,\npath, remote address, and a sha256 fingerprint of the key instead.",
"is_bot": false,
"headline": "Extract a curated subset in the observability examples (#48)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-05-29T13:38:20Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ac869d6d284b09bbffbcc69c0d4af5261eb67b02",
"body": "recordFailure() previously required the handler to pass the discriminator\nverbatim, even though the rule already had a keyExtractor that could\nderive it. The second argument is now optional — when null, the firewall\nextracts the key from the rule against the current request at processing\ntime. Expli\n[…]\nordedSignal and gained a BanType field;\nFirewall::processRecordedFailure() became processRecordedSignal() and\ndispatches by ban type. RequestContext::getRecordedFailures() is now\ngetRecordedSignals().",
"is_bot": false,
"headline": "RequestContext: optional key, recordHit() for allow2ban (#47)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-05-29T13:12:02Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "9b1796665ea125689ad0035d61f2bfa13431a1b8",
"body": "increment() previously swallowed every \\Throwable from the Predis client\nand returned 0, which every counter caller interpreted as \"no hits this\nwindow\". The exception now bubbles up to Middleware::process() so the\nconfigured Config::failOpen policy applies uniformly across infrastructure\nerrors; an E_USER_WARNING is emitted before the re-throw for diagnostic\nvisibility.",
"is_bot": false,
"headline": "Re-throw RedisCache::increment errors instead of returning 0 (#46)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-05-27T15:39:48Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e81a635463fe73bacedc9dc15cc6ae0451d1ead7",
"body": "The per-rule audit registry was written without a TTL, so it accumulated\nentries across ban churn until something called listBans() or\nclearBans() pruned them. Each save now carries a TTL matching the\nlongest-surviving entry and prunes already-expired entries before\nwriting. Concurrent ban() calls for the same rule can still drop one of\nthe registry entries, which is acceptable because the primary ban cache\nkey set by ban() is the source of truth and is unaffected by the race.",
"is_bot": false,
"headline": "Bound BanManager registry lifetime with a TTL (#45)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-05-27T11:05:31Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "06a9149b0188e7069f5d35f727c2299b8bbff5c4",
"body": null,
"is_bot": false,
"headline": "Add SECURITY.md (#44)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-05-20T13:40:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1c31b0ade3e909c9310c7f0f1f4a2775bff11481",
"body": "Matches the 0.3.0 release pattern (commit a3a14f0): swap \"Unreleased\"\nfor the release date in the changelog header just before tagging.",
"is_bot": false,
"headline": "Date CHANGELOG for 0.4.0 release (#43)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-05-19T12:59:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "dffbbdc8e270b6e6ced24f2782d6eab78b11dfb4",
"body": "PortableConfig::toConfig() still depends on the deprecated add*() flow\n(addSafelist, addBlocklist, addThrottle, addFail2Ban, addTrack). Migrating\nit cleanly is out of scope for 0.4, so push the trait removal one release\nout rather than ship a 0.4 that breaks PortableConfig.\n\nUpdates the @deprecated tag on the trait, the 0.3.0 CHANGELOG Deprecated\nnote, and the 0.4.0 Config-section-API entry to reference 0.5.",
"is_bot": false,
"headline": "Defer DeprecatedConfigMethods removal from 0.4 to 0.5 (#42)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-05-19T12:55:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "edb0d93cdc688c325a90a1d48332412843b5d194",
"body": "CRS rule 942511 wraps its alternation in literal single quotes, mirroring\n942510's literal backticks. SecRuleParser::parseOperator called stripQuotes\non the @rx argument, removing those literal apostrophes before the pattern\nreached RegexEvaluator. The regex then collapsed to its inner alternation,\n\n[…]\nayer to strip. Short-circuit @rx in parseOperator so the pattern\npasses through verbatim. The 942510 fix only covered the evaluator-side\ndelimiter heuristic; this completes the fix on the parser side.",
"is_bot": false,
"headline": "Fix SecRuleParser stripping literal quotes from @rx args (#41)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-05-19T11:04:17Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "78c44286d571d9d716178846756cab63e2ef119d",
"body": "* Unify ban-evaluator threshold semantics to >=\n\nThe pre-handler fail2ban path and the allow2ban path previously used\n$count > $threshold, which differs from both the post-handler fail2ban\npath (>=) and from classic fail2ban semantics where maxretry=N means\n\"ban at the Nth attempt\". Setting threshol\n[…]\nnding\n\nCo-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>\n\n---------\n\nCo-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>",
"is_bot": false,
"headline": "Unify ban-evaluator threshold semantics to >= (#40)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-05-19T07:12:11Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "0481699627475156d6d454b33acae4942bf47191",
"body": "…rs (#39)\n\nensureRegexDelimiters() included an \"if first char == last char and\nit's a non-alphanumeric, non-bracket character, return unchanged\"\nheuristic on the assumption the caller had passed a pre-delimited\n~...~-style pattern. ModSecurity/CRS @rx arguments are bare PCRE\ncontent by spec, so this\n[…]\nelimiters() is\nthe only correct path for bare @rx content. Adds a regression test\npinning CRS 942510's pattern against typical HTTP values and against\na backtick-quoted SQL fragment that should match.",
"is_bot": false,
"headline": "Fix RegexEvaluator treating literal first/last chars as PCRE delimite…",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-05-19T06:47:33Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "62ff7ca059d1d320aa8e6beb77112fad506450dd",
"body": null,
"is_bot": false,
"headline": "Fix broken documentation links in README (#38)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-04-14T11:54:11Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d04cbad2062c4cf46bb81158cac1e736ac453caa",
"body": "End-to-end integration tests using phpt format that exercise the full\nPSR-15 middleware pipeline. Each test is a standalone PHP script that\nconfigures a firewall, processes requests, and asserts response status\ncodes and headers.\n\nCoverage: safelists, blocklists, IP blocking, known scanners,\nsuspici\n[…]\nail-closed, disabled firewall,\nand post-handler RequestContext signaling.\n\nInfrastructure: shared _bootstrap.inc helper, separate Integration\ntest suite in phpunit.xml.dist, composer test:phpt script.",
"is_bot": false,
"headline": "Add phpt integration tests for all core features (22 tests) (#37)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-04-08T17:08:07Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "a3a14f0bd0348e1a2a4841a8fc78a634dbee0e10",
"body": "Covers all 35 PRs since 0.2.0, organized by Added, Changed, Fixed,\nSecurity, and Deprecated sections. Breaking change (opt-in response\nheaders) is called out explicitly.",
"is_bot": false,
"headline": "Add CHANGELOG.md for 0.3.0 release (#36)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-04-08T13:10:26Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0481cb761f9365526185e311862003f1cb371575",
"body": null,
"is_bot": false,
"headline": "Surface RedisCache::increment() failures via trigger_error() (#35)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-04-08T12:25:20Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d6ff95988e9b16b962852dbf600d0c148019e506",
"body": "* Add ReDoS length guard to RegexEvaluator (8 KiB limit)\n\n* Add bypass trade-off documentation and boundary tests for ReDoS guard\n\nDocument that overlength values are intentionally skipped (false negatives)\nas a security trade-off against catastrophic backtracking. Add tests for\nexact boundary (8192\n[…]\ne the existing public RegexMatcher::MAX_SUBJECT_LENGTH to keep\nthe subject-length policy consistent across the codebase. Extract a\nclass-level constant in the test to eliminate repeated magic numbers.",
"is_bot": false,
"headline": "Add ReDoS length guard to RegexEvaluator (8 KiB limit) (#34)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-04-08T11:19:21Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "0e66397474dd752d85aedaac6214ce24c5a534e7",
"body": null,
"is_bot": false,
"headline": "Add Allow2BanBanned event tracking to DiagnosticsCounters (#33)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-04-08T09:51:44Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f8986560c611dcad8dbe42f2e8bd7548ab976aee",
"body": "…ry logic (#32)\n\nConvert PatternKind from a final class with string constants to a\nstring-backed enum, making it a first-class type throughout the pattern\nsubsystem. PatternEntry::$kind is now typed as PatternKind instead of\nstring, enabling exhaustive matching and compile-time safety.\n\nExtract dupl\n[…]\nduced\nexpiresAt: 0, causing them to be treated as expired on next read.\n\nAdditionally fixes unnecessary file rewrites in FilePatternBackend by\ncomparing merged field values instead of object identity.",
"is_bot": false,
"headline": "Refactor PatternKind to string-backed enum and deduplicate PatternEnt…",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-04-08T09:33:50Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "03ba75ec922f02d71d6744c6e4c954456a8ac786",
"body": "…type (#31)",
"is_bot": false,
"headline": "Extract Firewall::decide() into dedicated evaluator classes per rule …",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-04-07T21:48:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ac401312e5da3c3b3abe96bcb0de93b77a63542d",
"body": "DiagnosticsCounters was implementing EventDispatcherInterface despite\nbeing an observer — preventing event forwarding to other listeners.\n\nIntroduce DiagnosticsDispatcher as a PSR-14 decorator that counts\nevents via DiagnosticsCounters and optionally forwards them to an\ninner dispatcher, enabling diagnostics and application event handling\nin a single pass.",
"is_bot": false,
"headline": "Separate DiagnosticsCounters (observer) from event dispatching (#30)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-04-07T21:18:21Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "336388a175b25c5bf76fbed449b8f6ba61fbe8c3",
"body": "Deduplicate the fail counter increment → threshold check → ban →\ndispatch sequence shared between processRecordedFailure() and decide().\n\nThe new incrementAndBanIfNeeded() method accepts a postHandler flag:\n- true (post-handler): uses >= so the Nth failure triggers the ban\n- false (pre-handler): uses > so N matches are allowed, ban on N+1",
"is_bot": false,
"headline": "Extract shared fail2ban increment-and-ban logic (#29)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-04-07T20:41:23Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "271ade341be09f35d4e32668d68fed9ec126c46a",
"body": "* Extract CoreRule operator and variable logic into strategy classes\n\nRefactor CoreRule by extracting evaluateOperator() into OperatorEvaluatorInterface\nimplementations (RegexEvaluator, ContainsEvaluator, StringEqualEvaluator,\nStartsWithEvaluator, EndsWithEvaluator, PhraseMatchEvaluator,\nPhraseMatch\n[…]\n\\\\~ where the backslash is itself\nescaped and the tilde is unescaped. A simple negative lookbehind\nonly checks for a single preceding backslash.\n\nAdd tests for even/odd backslash + tilde combinations.",
"is_bot": false,
"headline": "Extract CoreRule operator and variable logic into strategy classes (#28)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-04-07T20:07:10Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "4f1b7cd51700fba9eb4d27036414b891ce78fbab",
"body": "Removes duplicated increment logic between Firewall::increment() and\nFixedWindowStrategy by extracting the shared cache-based counter into\na dedicated FixedWindowCounter class.\n\n- FixedWindowCounter handles the CounterStoreInterface fast-path\n internally, so callers no longer need to check for it\n-\n[…]\n instance\n- FixedWindowStrategy simplified to a single delegation call\n- Migrate deprecated getter methods to section API in Firewall\n- Add FixedWindowCounterTest with 12 tests covering all edge cases",
"is_bot": false,
"headline": "Extract shared fixed-window counter logic into FixedWindowCounter (#27)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-04-07T19:18:00Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "24692bc3be3cec84f4f3a660925b92144f356a4f",
"body": "…t on Nth (#26)\n\nThe threshold check in decide() used >= which banned the request that\nreached the threshold count itself. With threshold=3, the 3rd request\nwas already blocked instead of being the last allowed one.\n\nChange >= to > in decide() so that threshold=N means \"allow N failures,\nblock on N+\n[…]\ns: the handler already ran, so banning\nwhen count reaches threshold means the next request is blocked — which\nis consistent with decide()'s behavior.\n\nAffects fail2ban (decide) and allow2ban (decide).",
"is_bot": false,
"headline": "Fix fail2ban/allow2ban threshold off-by-one: ban after N failures, no…",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-04-07T14:28:03Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "f80f6f9de726f6fcefd113a47a9289e049406dc2",
"body": "Diagnostic response headers (X-Phirewall, X-Phirewall-Matched,\nX-Phirewall-Safelist) now require an explicit $config->enableResponseHeaders()\ncall. This prevents leaking internal rule names and firewall topology to\nclients by default.\n\n- Add enableResponseHeaders() toggle to Config (default false)\n-\n[…]\nin always-on\n\nBREAKING CHANGE: X-Phirewall, X-Phirewall-Matched, and X-Phirewall-Safelist\nheaders are no longer included in responses by default. Call\n$config->enableResponseHeaders() to restore them.",
"is_bot": false,
"headline": "Make X-Phirewall/X-Phirewall-Matched response headers opt-in (#25)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-04-07T13:23:23Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "b7ae3adf4dd9fc33a21cf905555c93114a7f7a74",
"body": "Move detailed documentation to the phirewall.de docs site and\nreplace the local markdown files with a quick-reference table\nlinking to https://phirewall.de",
"is_bot": false,
"headline": "Replace local docs with links to phirewall.de (#24)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-03-26T21:54:53Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fb9ff28d60022ed31f5423384323b7a1a3ee90e9",
"body": "Introduce RequestContext, a mutable recorder attached to PSR-7 request\nattributes, that allows application code to signal fail2ban failures\nafter the handler has inspected the response. This replaces the\nX-Login-Failed header pattern with a direct, type-safe API.\n\nNew classes:\n- Context\\RequestConte\n[…]\nwall::processRecordedFailure() processes signals against rules\n- Middleware::process() attaches context before handler, processes\n recorded signals after handler returns (fail-open/fail-closed aware)",
"is_bot": false,
"headline": "Add request attribute API for post-handler fail2ban signaling (#22)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-03-25T21:58:18Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "e3c02686388156ac9b1bea1063c7ec04b30594e2",
"body": "Model best practice for database credential handling in examples.",
"is_bot": false,
"headline": "Replace hardcoded credentials with getenv() in PdoCache example (#19)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-03-25T21:01:13Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "49bed38d2133b6f06f71915e65752bc8ad601fab",
"body": "…rsal (#20)\n\nPre-compute strtolower(operator), regex delimiters, and parsed phrase\nlists once in constructor instead of on every evaluateOperator() call.\nReject @pmFromFile paths containing '..' to prevent directory traversal.",
"is_bot": false,
"headline": "Cache OWASP operator preprocessing and prevent @pmFromFile path trave…",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-03-25T21:00:44Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c62aa0771aeb842b395df0c20d6e1027fe75369b",
"body": "Replace four repeated instanceof Closure checks with a single resolved\ncallable, eliminating branching on every rule evaluation.",
"is_bot": false,
"headline": "Resolve discriminator normalizer once at top of decide() (#21)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-03-25T20:28:30Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "60002082c10b84239ff0f38e56bbdd40cc985f31",
"body": "Fail2BanRule now validates name, threshold, period, banSeconds matching\nAllow2BanRule. ThrottleRule and TrackRule validate non-empty name.",
"is_bot": false,
"headline": "Add consistent constructor validation across all rule types (#18)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-03-25T20:23:27Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "36a2f4b8d3be075e47a53e35447deadfe7d5e962",
"body": "…y (#17)",
"is_bot": false,
"headline": "Improve documentation: middleware ordering, TYPO3 example, terminolog…",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-03-25T13:52:51Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "72daca5453e82c2457f7e970f9d6a1bbed2c161f",
"body": "Replace getDiagnosticsCounters() with DiagnosticsCounters class in all\nexamples. Extract decisionPath string literals into a type-safe\nstring-backed DecisionPath enum used across Firewall, PerformanceMeasured,\nand DiagnosticsCounters.",
"is_bot": false,
"headline": "Modernize examples and extract DecisionPath enum (#16)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-03-25T13:41:42Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "703c89162e4cd85e19ae6d27d033f3b5294022d8",
"body": null,
"is_bot": false,
"headline": "Update documentation and examples to current API (#15)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-03-24T21:34:59Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "69c30ba92fbc20cf6786d6fb2737c2031e4b0761",
"body": "Introduce Psr17BlocklistedResponseFactory and Psr17ThrottledResponseFactory\nas PSR-17-based alternatives to closure response factories. Add convenience\nmethod Config::usePsr17Responses() to wire both factories from standard\nResponseFactoryInterface and optional StreamFactoryInterface.\n\nUpdate Middleware to delegate to configured factory interfaces with fallback\nto bare PSR-17 response creation.",
"is_bot": false,
"headline": "Add PSR-17 response factory support (#14)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-03-24T09:39:25Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c352caa8441b74adbe8d066ff79792d0ba4c4548",
"body": null,
"is_bot": false,
"headline": "Add comprehensive infrastructure adapter tests with vfsStream (#13)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-03-23T22:59:13Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c360d05785c3e0115feedcad00574141fb3c304f",
"body": "The Middleware now catches exceptions from Firewall::decide() and either\npasses the request through (fail-open, default) or re-throws (fail-closed).\n\nThis prevents a cache/storage outage from taking down the application.\nA FirewallError PSR-14 event is dispatched in fail-open mode so errors\ncan be l\n[…]\n true\n- Add FirewallError event with exception and request\n- Middleware catches Throwable from decide() and delegates to handleError()\n- Refactor Middleware: extract buildBlockedResponse() for clarity",
"is_bot": false,
"headline": "Add fail-open/fail-closed middleware error handling (#12)",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-03-23T20:47:39Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "38939241f2ae64c65b2cf70592a760bb5d26924a",
"body": "…tructure (#11)\n\nPdoCache provides a PDO-backed PSR-16 cache with CounterStoreInterface\nsupport for SQLite, MySQL, and PostgreSQL. With a shared database it\nsupports distributed counters across multiple application servers.\n\nPdoCache:\n- Type-safe QuotedIdentifier value objects prevent accidental SQL\n[…]\nge-backends.md with decision tree, DBAL integration,\n and per-dialect monitoring SQL\n- Reset helpers documented in configuration.md\n- Example 24 (pdo-storage) with SQLite demo and connection examples",
"is_bot": false,
"headline": "Add PdoCache storage backend, reset helpers, and database test infras…",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-03-23T18:30:55Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "3e146dd2492ff5f1fc6ebc357cfa4e2778a29a49",
"body": "…d flag (#10)\n\nTrack rules now accept an optional limit parameter. When set, the\nTrackHit event includes a thresholdReached flag indicating whether\nthe counter has reached the configured threshold. Events are always\ndispatched regardless of the threshold, preserving full observability.",
"is_bot": false,
"headline": "Add track threshold with optional limit parameter and thresholdReache…",
"author_name": "Sascha Egerer",
"author_login": "sascha-egerer",
"committed_at": "2026-03-21T21:41:17Z",
"body_truncated": false,
"is_coding_agent": false
}
],
"releases_count": 9,
"commits_last_year": 147,
"latest_release_at": "2026-07-09T20:11:46Z",
"latest_release_tag": "0.8.0",
"releases_from_tags": false,
"days_since_last_push": 0,
"active_weeks_last_year": 20,
"days_since_latest_release": 14,
"mean_days_between_releases": 26.1
},
"community": {
"has_readme": true,
"has_license": true,
"has_description": true,
"has_contributing": false,
"health_percentage": 62,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"ecosystem": {
"packages": [
{
"name": "flowd/phirewall",
"exists": true,
"license": "LGPL-3.0-or-later",
"keywords": [],
"ecosystem": "packagist",
"matches_repo": true,
"registry_url": "https://packagist.org/packages/flowd/phirewall",
"is_deprecated": false,
"latest_version": "0.8.0",
"repository_url": "https://github.com/flowd/phirewall",
"versions_count": 9,
"total_downloads": 7404,
"dependents_count": 4,
"deprecation_note": null,
"maintainers_count": null,
"monthly_downloads": 3581,
"first_published_at": null,
"latest_published_at": "2026-07-09T20:08:33Z",
"latest_version_yanked": null,
"days_since_latest_publish": 14
}
]
},
"popularity": {
"forks": 1,
"stars": 17,
"watchers": 0,
"fork_history": {
"days": [
{
"date": "2026-06-08",
"count": 1
}
],
"complete": true,
"collected": 1,
"total_forks": 1
},
"star_history": null,
"open_issues_and_prs": 1
},
"ai_readiness": {
"has_nix": false,
"example_dirs": [
"examples"
],
"has_llms_txt": false,
"has_dockerfile": true,
"has_mcp_signal": false,
"bootstrap_files": [],
"api_schema_files": [],
"has_devcontainer": false,
"typecheck_configs": [],
"toolchain_manifests": [],
"largest_source_bytes": 54692,
"source_files_sampled": 213,
"oversized_source_files": 0,
"agent_instruction_files": [],
"agent_instruction_max_bytes": null
},
"dependencies": {
"manifests": [
"composer.json"
],
"advisories": {
"error": "No resolved dependencies carried a version and a supported ecosystem",
"scope": "repository_graph",
"source": null,
"findings": [],
"collected": false,
"malicious": [],
"truncated": false,
"by_severity": {},
"advisory_count": 0,
"affected_count": 0,
"assessed_count": 0,
"malicious_count": 0,
"assessed_package": null,
"unassessed_count": 14,
"direct_affected_count": 0
},
"ecosystems": [
"packagist"
],
"dependencies": [
{
"name": "psr/http-message",
"manifest": "composer.json",
"ecosystem": "packagist",
"version_constraint": "^1.1 || ^2.0"
},
{
"name": "psr/http-server-middleware",
"manifest": "composer.json",
"ecosystem": "packagist",
"version_constraint": "^1.0"
},
{
"name": "psr/http-server-handler",
"manifest": "composer.json",
"ecosystem": "packagist",
"version_constraint": "^1.0"
},
{
"name": "psr/http-factory",
"manifest": "composer.json",
"ecosystem": "packagist",
"version_constraint": "^1.1"
},
{
"name": "psr/simple-cache",
"manifest": "composer.json",
"ecosystem": "packagist",
"version_constraint": "^3.0"
},
{
"name": "psr/event-dispatcher",
"manifest": "composer.json",
"ecosystem": "packagist",
"version_constraint": "^1.0"
}
],
"all_dependencies": {
"error": null,
"source": "github-sbom",
"packages": [
{
"name": "psr/event-dispatcher",
"direct": true,
"version": null,
"ecosystem": "packagist"
},
{
"name": "psr/http-factory",
"direct": true,
"version": null,
"ecosystem": "packagist"
},
{
"name": "psr/http-message",
"direct": true,
"version": null,
"ecosystem": "packagist"
},
{
"name": "psr/http-server-handler",
"direct": true,
"version": null,
"ecosystem": "packagist"
},
{
"name": "psr/http-server-middleware",
"direct": true,
"version": null,
"ecosystem": "packagist"
},
{
"name": "psr/simple-cache",
"direct": true,
"version": null,
"ecosystem": "packagist"
},
{
"name": "friendsofphp/php-cs-fixer",
"direct": false,
"version": null,
"ecosystem": "packagist"
},
{
"name": "infection/infection",
"direct": false,
"version": null,
"ecosystem": "packagist"
},
{
"name": "mikey179/vfsstream",
"direct": false,
"version": null,
"ecosystem": "packagist"
},
{
"name": "nyholm/psr7",
"direct": false,
"version": null,
"ecosystem": "packagist"
},
{
"name": "php",
"direct": false,
"version": null,
"ecosystem": "packagist"
},
{
"name": "phpstan/phpstan",
"direct": false,
"version": null,
"ecosystem": "packagist"
},
{
"name": "phpunit/phpunit",
"direct": false,
"version": null,
"ecosystem": "packagist"
},
{
"name": "rector/rector",
"direct": false,
"version": null,
"ecosystem": "packagist"
}
],
"collected": true,
"truncated": false,
"total_count": 14,
"direct_count": 6,
"indirect_count": 8
}
},
"maintainership": {
"issues": {
"open_prs": 1,
"merged_prs": 108,
"open_issues": 0,
"closed_ratio": null,
"closed_issues": 0,
"closed_unmerged_prs": 7
},
"bus_factor": 1,
"bot_contributors": 0,
"top_contributors": [
{
"type": "User",
"login": "sascha-egerer",
"commits": 146,
"avatar_url": "https://avatars.githubusercontent.com/u/1651414?v=4"
},
{
"type": "User",
"login": "KamiYang",
"commits": 1,
"avatar_url": "https://avatars.githubusercontent.com/u/16732079?v=4"
}
],
"contributors_sampled": 2,
"top_contributor_share": 0.993
},
"quality_signals": {
"has_ci": true,
"has_tests": true,
"ci_workflows": [
"ci.yml",
"database-tests.yml",
"examples.yml"
],
"has_docs_dir": true,
"linter_configs": [
".php-cs-fixer.php"
],
"has_editorconfig": false,
"has_linter_config": true,
"has_precommit_config": false
},
"security_signals": {
"lockfiles": [],
"scorecard": {
"checks": [
{
"name": "Binary-Artifacts",
"score": 10,
"reason": "no binaries found in the repo",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#binary-artifacts"
},
{
"name": "Branch-Protection",
"score": 3,
"reason": "branch protection is not maximal on development and all release branches",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#branch-protection"
},
{
"name": "CI-Tests",
"score": 10,
"reason": "30 out of 30 merged PRs checked by a CI test -- score normalized to 10",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#ci-tests"
},
{
"name": "CII-Best-Practices",
"score": 0,
"reason": "no effort to earn an OpenSSF best practices badge detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#cii-best-practices"
},
{
"name": "Code-Review",
"score": 0,
"reason": "Found 0/30 approved changesets -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#code-review"
},
{
"name": "Contributors",
"score": 3,
"reason": "project has 1 contributing companies or organizations -- score normalized to 3",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#contributors"
},
{
"name": "Dangerous-Workflow",
"score": null,
"reason": "no workflows found",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dangerous-workflow"
},
{
"name": "Dependency-Update-Tool",
"score": 0,
"reason": "no update tool detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dependency-update-tool"
},
{
"name": "Fuzzing",
"score": 0,
"reason": "project is not fuzzed",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#fuzzing"
},
{
"name": "License",
"score": 9,
"reason": "license file detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#license"
},
{
"name": "Maintained",
"score": 10,
"reason": "30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#maintained"
},
{
"name": "Packaging",
"score": null,
"reason": "packaging workflow not detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#packaging"
},
{
"name": "Pinned-Dependencies",
"score": 0,
"reason": "dependency not pinned by hash detected -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#pinned-dependencies"
},
{
"name": "SAST",
"score": 10,
"reason": "SAST tool is run on all commits",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#sast"
},
{
"name": "Security-Policy",
"score": 10,
"reason": "security policy file detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#security-policy"
},
{
"name": "Signed-Releases",
"score": null,
"reason": "no releases found",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#signed-releases"
},
{
"name": "Token-Permissions",
"score": null,
"reason": "No tokens found",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#token-permissions"
},
{
"name": "Vulnerabilities",
"score": 10,
"reason": "0 existing vulnerabilities detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#vulnerabilities"
}
],
"commit": "76efa746582671f42e50496ae6f4acc0acada09b",
"ran_at": "2026-07-24T11:55:02Z",
"aggregate_score": 5.4,
"scorecard_version": "v5.5.0"
},
"has_codeql_workflow": false,
"has_security_policy": true,
"has_dependabot_config": false
},
"contribution_flow": {
"collected": true,
"ci_last_run_at": "2026-07-23T15:44:01Z",
"oldest_open_prs": [
{
"number": 116,
"created_at": "2026-07-24T11:54:32Z",
"last_comment_at": null,
"last_comment_author": null
}
],
"last_merged_pr_at": "2026-07-11T09:43:23Z",
"ci_last_conclusion": "SUCCESS",
"oldest_open_issues": []
}
},
"config": {
"disabled_metrics": [],
"disabled_categories": [],
"disabled_components": {}
},
"source": {
"url": "https://github.com/flowd/phirewall",
"host": "github.com",
"name": "phirewall",
"owner": "flowd"
},
"metrics": {
"overall": {
"key": "overall",
"band": "moderate",
"name": "Overall health",
"note": null,
"notes": [],
"value": 63,
"inputs": {
"security": 54,
"vitality": 87,
"community": 36,
"governance": 53,
"engineering": 80
},
"components": []
},
"categories": [
{
"key": "vitality",
"band": "excellent",
"name": "Vitality",
"value": 87,
"weight": 0.22,
"metrics": [
{
"key": "development_activity",
"band": "good",
"name": "Development activity",
"note": null,
"notes": [],
"value": 78,
"inputs": {
"commits_last_year": 147,
"human_commit_share": 1,
"days_since_last_push": 0,
"active_weeks_last_year": 20
},
"components": [
{
"key": "push_recency",
"name": "Push recency",
"detail": "last push 0 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "push_recency",
"params": {
"days": 0
}
}
],
"max_points": 36
},
{
"key": "commit_cadence",
"name": "Commit cadence",
"detail": "20/52 weeks with commits",
"points": 13.8,
"status": "partial",
"details": [
{
"code": "commit_cadence_weeks",
"params": {
"weeks": 20
}
}
],
"max_points": 36
},
{
"key": "commit_volume",
"name": "Commit volume",
"detail": "147 commits in the last year",
"points": 18,
"status": "met",
"details": [
{
"code": "commits_last_year",
"params": {
"count": 147
}
}
],
"max_points": 18
},
{
"key": "openssf_scorecard_maintained",
"name": "OpenSSF Scorecard: Maintained",
"detail": "30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
},
{
"key": "release_discipline",
"band": "excellent",
"name": "Release discipline",
"note": "Excluded from scoring (no data or not applicable): OpenSSF Scorecard: Signed-Releases. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"openssf_scorecard_signed_releases"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 100,
"inputs": {
"releases_count": 9,
"latest_release_tag": "0.8.0",
"releases_from_tags": false,
"days_since_latest_release": 14,
"mean_days_between_releases": 26.1
},
"components": [
{
"key": "ships_releases",
"name": "Ships releases",
"detail": "9 releases published",
"points": 27,
"status": "met",
"details": [
{
"code": "releases_published",
"params": {
"count": 9
}
}
],
"max_points": 27
},
{
"key": "release_recency",
"name": "Release recency",
"detail": "latest release 14 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "release_recency",
"params": {
"days": 14
}
}
],
"max_points": 36
},
{
"key": "release_cadence",
"name": "Release cadence",
"detail": "a release every ~26.1 days",
"points": 27,
"status": "met",
"details": [
{
"code": "release_cadence",
"params": {
"gap": 26.1
}
}
],
"max_points": 27
},
{
"key": "openssf_scorecard_signed_releases",
"name": "OpenSSF Scorecard: Signed-Releases",
"detail": "no releases found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 10
}
]
},
{
"key": "abandonment",
"band": "excellent",
"name": "Abandonment",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"cap": null,
"state": "maintained",
"guards": [],
"signals": [],
"red_flag": false,
"multiplier_pct": 100,
"declared_reason": null,
"unverified_reason": null,
"unanswered_open_prs": null,
"unanswered_open_issues": null,
"days_since_last_merged_pr": null,
"days_since_last_human_commit": 13,
"days_since_last_human_commit_is_floor": false
},
"components": [
{
"key": "project_is_still_maintained",
"name": "Project is still maintained",
"detail": "last human commit 13 days ago",
"points": 100,
"status": "met",
"details": [
{
"code": "abandonment_maintained",
"params": {
"days": 13
}
}
],
"max_points": 100
}
]
}
],
"description": "Is the project alive — is code being written and are releases shipping?"
},
{
"key": "community",
"band": "at_risk",
"name": "Community & Adoption",
"value": 36,
"weight": 0.18,
"metrics": [
{
"key": "popularity",
"band": "critical",
"name": "Popularity & adoption",
"note": null,
"notes": [],
"value": 20,
"inputs": {
"forks": 1,
"stars": 17,
"watchers": 0,
"growth_state": "unverified",
"growth_factor_pct": 100,
"growth_unverified_reason": "no_history"
},
"components": [
{
"key": "stars",
"name": "Stars",
"detail": "17 stars",
"points": 19.5,
"status": "partial",
"details": [
{
"code": "stars",
"params": {
"count": 17
}
}
],
"max_points": 60
},
{
"key": "forks",
"name": "Forks",
"detail": "1 forks",
"points": 0,
"status": "missed",
"details": [
{
"code": "forks",
"params": {
"count": 1
}
}
],
"max_points": 25
},
{
"key": "watchers",
"name": "Watchers",
"detail": "0 watchers",
"points": 0,
"status": "missed",
"details": [
{
"code": "watchers",
"params": {
"count": 0
}
}
],
"max_points": 15
}
]
},
{
"key": "community_health",
"band": "at_risk",
"name": "Community health",
"note": null,
"notes": [],
"value": 44,
"inputs": {
"has_readme": true,
"has_license": true,
"has_contributing": false,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 22.5,
"status": "met",
"details": [],
"max_points": 22.5
},
{
"key": "license",
"name": "License",
"detail": "license file present, not a recognized license",
"points": 16.9,
"status": "partial",
"details": [
{
"code": "license_custom",
"params": {}
}
],
"max_points": 22.5
},
{
"key": "contributing_guide",
"name": "CONTRIBUTING guide",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 18
},
{
"key": "code_of_conduct",
"name": "Code of conduct",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 13.5
},
{
"key": "issue_template",
"name": "Issue template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.2
},
{
"key": "pr_template",
"name": "PR template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.3
}
]
},
{
"key": "ecosystem_adoption",
"band": "moderate",
"name": "Ecosystem adoption (downloads)",
"note": null,
"notes": [],
"value": 52,
"inputs": {
"packages": [
"flowd/phirewall"
],
"dependents": 4,
"ecosystems": "packagist",
"total_downloads": 7404,
"monthly_downloads": 3581
},
"components": [
{
"key": "monthly_downloads",
"name": "Monthly downloads",
"detail": "3,581 downloads/month across packagist",
"points": 47.4,
"status": "partial",
"details": [
{
"code": "downloads_monthly",
"params": {
"count": 3581,
"ecosystems": "packagist"
}
}
],
"max_points": 80
},
{
"key": "registry_dependents",
"name": "Registry dependents",
"detail": "4 packages depend on it",
"points": 4.7,
"status": "partial",
"details": [
{
"code": "registry_dependents",
"params": {
"count": 4
}
}
],
"max_points": 20
}
]
}
],
"description": "Does the project have users, downloads, attention, and a welcoming setup for contributors?"
},
{
"key": "governance",
"band": "moderate",
"name": "Sustainability & Governance",
"value": 53,
"weight": 0.24,
"metrics": [
{
"key": "maintainer_resilience",
"band": "critical",
"name": "Maintainer resilience (bus factor)",
"note": null,
"notes": [],
"value": 15,
"inputs": {
"bus_factor": 1,
"contributors_sampled": 2,
"top_contributor_share": 0.993
},
"components": [
{
"key": "bus_factor",
"name": "Bus factor",
"detail": "1 contributor(s) cover half of all commits",
"points": 9,
"status": "partial",
"details": [
{
"code": "bus_factor",
"params": {
"count": 1
}
}
],
"max_points": 54
},
{
"key": "commit_distribution",
"name": "Commit distribution",
"detail": "top contributor authored 99% of commits",
"points": 0.2,
"status": "partial",
"details": [
{
"code": "top_contributor_share",
"params": {
"share": 99
}
}
],
"max_points": 22.5
},
{
"key": "contributor_breadth",
"name": "Contributor breadth",
"detail": "2 contributors",
"points": 2.7,
"status": "partial",
"details": [
{
"code": "contributors_sampled",
"params": {
"count": 2
}
}
],
"max_points": 13.5
},
{
"key": "openssf_scorecard_contributors",
"name": "OpenSSF Scorecard: Contributors",
"detail": "project has 1 contributing companies or organizations -- score normalized to 3",
"points": 3,
"status": "partial",
"details": [],
"max_points": 10
}
]
},
{
"key": "responsiveness",
"band": "moderate",
"name": "Issue & PR responsiveness",
"note": "Excluded from scoring (no data or not applicable): Issue resolution. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"issue_resolution"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 67,
"inputs": {
"merged_prs": 108,
"open_issues": 0,
"closed_issues": 0,
"issue_closed_ratio": null,
"closed_unmerged_prs": 7
},
"components": [
{
"key": "issue_resolution",
"name": "Issue resolution",
"detail": "no issues or no data",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_issues_or_data",
"params": {}
}
],
"max_points": 46.75
},
{
"key": "pr_acceptance",
"name": "PR acceptance",
"detail": "108/115 decided PRs merged",
"points": 35.9,
"status": "partial",
"details": [
{
"code": "decided_prs_merged",
"params": {
"merged": 108,
"decided": 115
}
}
],
"max_points": 38.25
},
{
"key": "openssf_scorecard_code_review",
"name": "OpenSSF Scorecard: Code-Review",
"detail": "Found 0/30 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
}
]
},
{
"key": "stewardship",
"band": "at_risk",
"name": "Ownership & stewardship",
"note": null,
"notes": [],
"value": 48,
"inputs": {
"followers": 2,
"owner_type": "Organization",
"is_verified": null,
"owner_login": "flowd",
"public_repos": 6,
"account_age_days": 1484
},
"components": [
{
"key": "ownership_backing",
"name": "Ownership backing",
"detail": "organization-owned",
"points": 30,
"status": "met",
"details": [
{
"code": "owner_organization",
"params": {}
}
],
"max_points": 30
},
{
"key": "verified_domain",
"name": "Verified domain",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 20
},
{
"key": "owner_reach",
"name": "Owner reach",
"detail": "2 followers of flowd",
"points": 3.4,
"status": "partial",
"details": [
{
"code": "owner_followers",
"params": {
"count": 2,
"login": "flowd"
}
}
],
"max_points": 25
},
{
"key": "track_record",
"name": "Track record",
"detail": "6 public repos, account ~4 yr old",
"points": 14.3,
"status": "partial",
"details": [
{
"code": "public_repos",
"params": {
"count": 6
}
},
{
"code": "account_age_years",
"params": {
"years": 4
}
}
],
"max_points": 25
}
]
},
{
"key": "package_maintenance",
"band": "excellent",
"name": "Package maintenance",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"packages": [
"flowd/phirewall"
],
"ecosystems": "packagist",
"any_deprecated": false,
"min_days_since_publish": 14
},
"components": [
{
"key": "published_resolvable",
"name": "Published & resolvable",
"detail": "1 package(s) on packagist",
"points": 25,
"status": "met",
"details": [
{
"code": "packages_published",
"params": {
"count": 1,
"ecosystems": "packagist"
}
}
],
"max_points": 25
},
{
"key": "publish_recency",
"name": "Publish recency",
"detail": "latest publish 14 days ago",
"points": 35,
"status": "met",
"details": [
{
"code": "publish_recency",
"params": {
"days": 14
}
}
],
"max_points": 35
},
{
"key": "version_history",
"name": "Version history",
"detail": "9 published versions",
"points": 20,
"status": "met",
"details": [
{
"code": "published_versions",
"params": {
"count": 9
}
}
],
"max_points": 20
},
{
"key": "not_deprecated",
"name": "Not deprecated",
"detail": "active, not deprecated or yanked",
"points": 20,
"status": "met",
"details": [
{
"code": "package_not_deprecated",
"params": {}
}
],
"max_points": 20
}
]
}
],
"description": "Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?"
},
{
"key": "engineering",
"band": "good",
"name": "Engineering Quality",
"value": 80,
"weight": 0.2,
"metrics": [
{
"key": "engineering_practices",
"band": "good",
"name": "Engineering practices",
"note": null,
"notes": [],
"value": 84,
"inputs": {
"has_ci": true,
"has_tests": true,
"has_editorconfig": false,
"has_linter_config": true,
"has_precommit_config": false
},
"components": [
{
"key": "ci_workflows",
"name": "CI workflows",
"detail": "3 workflow(s)",
"points": 24,
"status": "met",
"details": [
{
"code": "ci_workflows",
"params": {
"count": 3
}
}
],
"max_points": 24
},
{
"key": "tests_present",
"name": "Tests present",
"detail": null,
"points": 24,
"status": "met",
"details": [],
"max_points": 24
},
{
"key": "linter_config",
"name": "Linter config",
"detail": ".php-cs-fixer.php",
"points": 16,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": ".php-cs-fixer.php"
}
}
],
"max_points": 16
},
{
"key": "pre_commit_hooks",
"name": "Pre-commit hooks",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 9.6
},
{
"key": "editorconfig",
"name": ".editorconfig",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.4
},
{
"key": "openssf_scorecard_ci_tests",
"name": "OpenSSF Scorecard: CI-Tests",
"detail": "30 out of 30 merged PRs checked by a CI test -- score normalized to 10",
"points": 20,
"status": "met",
"details": [],
"max_points": 20
}
]
},
{
"key": "documentation",
"band": "good",
"name": "Documentation",
"note": null,
"notes": [],
"value": 75,
"inputs": {
"topics": [],
"has_wiki": true,
"homepage": null,
"has_readme": true,
"has_docs_dir": true,
"has_description": true
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 30,
"status": "met",
"details": [],
"max_points": 30
},
{
"key": "documentation_directory",
"name": "Documentation directory",
"detail": null,
"points": 25,
"status": "met",
"details": [],
"max_points": 25
},
{
"key": "documentation_homepage_site",
"name": "Documentation / homepage site",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
},
{
"key": "repository_description",
"name": "Repository description",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "topics",
"name": "Topics",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
},
{
"key": "wiki",
"name": "Wiki",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
}
],
"description": "Are baseline engineering and documentation practices in place?"
},
{
"key": "security",
"band": "moderate",
"name": "Security",
"value": 54,
"weight": 0.16,
"metrics": [
{
"key": "security_posture",
"band": "moderate",
"name": "Security posture",
"note": "Excluded from scoring (no data or not applicable): Dangerous-Workflow, Packaging, Signed-Releases, Token-Permissions. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"dangerous_workflow",
"packaging",
"signed_releases",
"token_permissions"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 54,
"inputs": {
"source": "openssf_scorecard",
"checks_evaluated": 14,
"scorecard_version": "v5.5.0",
"checks_inconclusive": 4,
"scorecard_aggregate": 5.4
},
"components": [
{
"key": "binary_artifacts",
"name": "Binary-Artifacts",
"detail": "no binaries found in the repo",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "branch_protection",
"name": "Branch-Protection",
"detail": "branch protection is not maximal on development and all release branches",
"points": 2.2,
"status": "partial",
"details": [],
"max_points": 7.5
},
{
"key": "ci_tests",
"name": "CI-Tests",
"detail": "30 out of 30 merged PRs checked by a CI test -- score normalized to 10",
"points": 2.5,
"status": "met",
"details": [],
"max_points": 2.5
},
{
"key": "cii_best_practices",
"name": "CII-Best-Practices",
"detail": "no effort to earn an OpenSSF best practices badge detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "code_review",
"name": "Code-Review",
"detail": "Found 0/30 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "contributors",
"name": "Contributors",
"detail": "project has 1 contributing companies or organizations -- score normalized to 3",
"points": 0.8,
"status": "partial",
"details": [],
"max_points": 2.5
},
{
"key": "dangerous_workflow",
"name": "Dangerous-Workflow",
"detail": "no workflows found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 10
},
{
"key": "dependency_update_tool",
"name": "Dependency-Update-Tool",
"detail": "no update tool detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "fuzzing",
"name": "Fuzzing",
"detail": "project is not fuzzed",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "license",
"name": "License",
"detail": "license file detected",
"points": 2.2,
"status": "partial",
"details": [],
"max_points": 2.5
},
{
"key": "maintained",
"name": "Maintained",
"detail": "30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "packaging",
"name": "Packaging",
"detail": "packaging workflow not detected",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 5
},
{
"key": "pinned_dependencies",
"name": "Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "sast",
"name": "SAST",
"detail": "SAST tool is run on all commits",
"points": 5,
"status": "met",
"details": [],
"max_points": 5
},
{
"key": "security_policy",
"name": "Security-Policy",
"detail": "security policy file detected",
"points": 5,
"status": "met",
"details": [],
"max_points": 5
},
{
"key": "signed_releases",
"name": "Signed-Releases",
"detail": "no releases found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 7.5
},
{
"key": "token_permissions",
"name": "Token-Permissions",
"detail": "No tokens found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 7.5
},
{
"key": "vulnerabilities",
"name": "Vulnerabilities",
"detail": "0 existing vulnerabilities detected",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
}
]
},
{
"key": "high_risk_jurisdiction_exposure",
"band": "excellent",
"name": "High-Risk Jurisdiction Exposure",
"note": "Only high-confidence self-published location evidence affects this multiplier. Ambiguous matches are review-only; country evidence is not proof of nationality, citizenship, legal registration, malicious intent, or sanctions status.",
"notes": [
{
"code": "jurisdiction_evidence_limits",
"params": {}
}
],
"value": 100,
"inputs": {
"meaning": "self-published location evidence; not nationality or citizenship",
"red_flag": false,
"exposures": [],
"policy_countries": [
"Russia",
"Iran",
"North Korea"
],
"review_only_matches": 0,
"assessed_self_published_locations": 3
},
"components": [
{
"key": "policy_exposure_multiplier",
"name": "Policy exposure multiplier",
"detail": "no confirmed policy-scope location match",
"points": 100,
"status": "met",
"details": [
{
"code": "jurisdiction_no_match",
"params": {}
}
],
"max_points": 100
}
]
}
],
"description": "Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure?"
},
{
"key": "ai_readiness",
"band": "at_risk",
"name": "AI Readiness",
"value": 44,
"weight": 0,
"metrics": [
{
"key": "ai_agent_context",
"band": "at_risk",
"name": "Agent context & guidance",
"note": null,
"notes": [],
"value": 40,
"inputs": {
"has_llms_txt": false,
"legible_history_share": 0.96,
"agent_instruction_files": [],
"agent_instruction_max_bytes": null
},
"components": [
{
"key": "agent_instructions",
"name": "Agent instructions",
"detail": "no CLAUDE.md / AGENTS.md / editor rules",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_agent_instructions",
"params": {}
}
],
"max_points": 45
},
{
"key": "machine_readable_docs_llms_txt",
"name": "Machine-readable docs (llms.txt)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
},
{
"key": "legible_commit_history",
"name": "Legible commit history",
"detail": "96 of 100 human commits state their intent (structured subject or explanatory body)",
"points": 40,
"status": "met",
"details": [
{
"code": "legible_history",
"params": {
"legible": 96,
"sampled": 100
}
}
],
"max_points": 40
}
]
},
{
"key": "ai_verify_loop",
"band": "at_risk",
"name": "Verify loop (build / test / typecheck)",
"note": null,
"notes": [],
"value": 45,
"inputs": {
"has_nix": false,
"has_tests": true,
"lockfiles": [],
"has_dockerfile": true,
"typed_language": false,
"bootstrap_files": [],
"has_devcontainer": false,
"has_linter_config": true,
"typecheck_configs": [],
"agent_commit_share": 0.01,
"toolchain_manifests": [],
"dependency_bot_commit_share": 0
},
"components": [
{
"key": "one_command_bootstrap",
"name": "One-command bootstrap",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 18
},
{
"key": "automated_tests",
"name": "Automated tests",
"detail": null,
"points": 22,
"status": "met",
"details": [],
"max_points": 22
},
{
"key": "lint_format_config",
"name": "Lint / format config",
"detail": ".php-cs-fixer.php",
"points": 11,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": ".php-cs-fixer.php"
}
}
],
"max_points": 11
},
{
"key": "static_type_checking",
"name": "Static type checking",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 11
},
{
"key": "reproducible_environment",
"name": "Reproducible environment",
"detail": "Dockerfile",
"points": 10,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "Dockerfile"
}
}
],
"max_points": 10
},
{
"key": "demonstrated_agent_practice",
"name": "Demonstrated agent practice",
"detail": "1 of the last 100 commits agent-authored or agent-credited",
"points": 2,
"status": "partial",
"details": [
{
"code": "agent_authored_commits",
"params": {
"count": 1,
"sampled": 100
}
}
],
"max_points": 10
},
{
"key": "automated_maintenance",
"name": "Automated maintenance",
"detail": "no automated dependency updates observed",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_dependency_automation",
"params": {}
}
],
"max_points": 8
},
{
"key": "openssf_scorecard_pinned_dependencies",
"name": "OpenSSF Scorecard: Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "ai_code_legibility",
"band": "moderate",
"name": "Code legibility for models",
"note": null,
"notes": [],
"value": 55,
"inputs": {
"primary_language": "PHP",
"largest_source_bytes": 54692,
"source_files_sampled": 213,
"oversized_source_files": 0
},
"components": [
{
"key": "type_checkable_code",
"name": "Type-checkable code",
"detail": "PHP without a type-check config",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_typecheck_config_language",
"params": {
"language": "PHP"
}
}
],
"max_points": 45
},
{
"key": "manageable_file_sizes",
"name": "Manageable file sizes",
"detail": "0/213 source files over 60KB",
"points": 55,
"status": "met",
"details": [
{
"code": "oversized_source_files",
"params": {
"kb": 60,
"sampled": 213,
"oversized": 0
}
}
],
"max_points": 55
}
]
},
{
"key": "ai_interfaces",
"band": "at_risk",
"name": "Machine-readable interfaces",
"note": null,
"notes": [],
"value": 40,
"inputs": {
"example_dirs": [
"examples"
],
"has_mcp_signal": false,
"api_schema_files": []
},
"components": [
{
"key": "api_schema_openapi_graphql_proto",
"name": "API schema (OpenAPI/GraphQL/proto)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 40
},
{
"key": "mcp_server",
"name": "MCP server",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 20
},
{
"key": "runnable_examples",
"name": "Runnable examples",
"detail": "examples",
"points": 40,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "examples"
}
}
],
"max_points": 40
}
]
}
],
"description": "How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score."
}
],
"metrics_version": "1.13.0"
},
"warnings": [
"Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token",
"No resolved dependencies carried a version and a supported ecosystem"
],
"report_type": "repository",
"generated_at": "2026-07-24T11:55:18.421989Z",
"schema_version": "0.27.0",
"badge_url": "https://raw.githubusercontent.com/inspect-software/badges/main/v1/f/flowd/phirewall.svg",
"full_name": "flowd/phirewall",
"license_state": "custom",
"license_spdx": null
}