Звіт у форматі 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
}