# Changelog

## Score

- CAI 61 → 60 (-0.3)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

## Lenses

- Code Health 63 → 62 (-1.4)
- Architecture 99 → 99 (+0.1)
- Maturity 66 → 65 (-0.2)
- Readiness 53 → 53 (+0.0)
- Security 68 → 70 (+1.7)

## Resolved (10)

- Boundary-crossing change coupling: AsyncAwsS3Adapter.php ↔ AwsS3V3Adapter.php (src/AsyncAwsS3/AsyncAwsS3Adapter.php)
- Boundary-crossing change coupling: FtpAdapter.php ↔ SftpAdapter.php (src/Ftp/FtpAdapter.php)
- Boundary-crossing change coupling: InMemoryFilesystemAdapter.php ↔ LocalFilesystemAdapter.php (src/InMemory/InMemoryFilesystemAdapter.php)
- Duplicate intent for existence checks: `has` vs `fileExists`/`directoryExists`. The `Filesystem` class exposes both `has()` and `fileExists()`. The `FilesystemReader` interface also exposes both `has()` and `fileExists()`. While `has` might imply checking for both files and directories, the API does not clearly distinguish the behavior from `fileExists` (which likely only checks files) or `directoryExists`. This creates confusion for users on which method to use for a general existence check.
- High secret: WD-SECRET-0005 (docs/package-lock.json)
- Inconsistent return type for fileSize retrieval: `int` vs `FileAttributes`. The `Filesystem` and `FilesystemReader` return an `int`, while `FilesystemAdapter` returns a `FileAttributes` object. This is part of a broader pattern of inconsistency in metadata retrieval.
- Inconsistent return type for lastModified retrieval: `int` vs `FileAttributes`. The `Filesystem` and `FilesystemReader` return an `int` (timestamp), while `FilesystemAdapter` returns a `FileAttributes` object. This is part of a broader pattern of inconsistency in metadata retrieval.
- Inconsistent return type for mimeType retrieval: `string` vs `FileAttributes`. Similar to the visibility issue, `Filesystem` and `FilesystemReader` return a `string`, while `FilesystemAdapter` returns a `FileAttributes` object. This inconsistency exists across multiple metadata retrieval methods.
- Inconsistent return type for visibility retrieval: `string` vs `FileAttributes`. The `Filesystem` and `FilesystemReader` interfaces return a `string` (the visibility value), but the underlying `FilesystemAdapter` interface returns a `FileAttributes` object containing the visibility among other metadata. This forces the `Filesystem` class to unwrap the object, but exposes a different contract than the adapter, potentially confusing developers who might expect the richer metadata if they are working closer to the adapter level.
- Off-boarding risk: anonymized user #1

## New (37)

- Documentation: no build, run or usage example (readme.md)
- Edited copies of one member (3 members, 14+ corresponding lines) (src/Ftp/FtpConnectionOptions.php)
- Edited copy of a member (10 corresponding lines) (src/ZipArchive/ZipArchiveAdapter.php)
- Edited copy of a member (11 corresponding lines) (src/AsyncAwsS3/AsyncAwsS3Adapter.php)
- Edited copy of a member (11 corresponding lines) (src/PhpseclibV3/SftpConnectionProvider.php)
- Edited copy of a member (12 corresponding lines) (src/AsyncAwsS3/AsyncAwsS3Adapter.php)
- Edited copy of a member (12 corresponding lines) (src/PhpseclibV2/SftpConnectionProvider.php)
- Edited copy of a member (13 corresponding lines) (src/InMemory/InMemoryFilesystemAdapter.php)
- Edited copy of a member (13 corresponding lines) (src/WebDAV/WebDAVAdapter.php)
- Edited copy of a member (13 corresponding lines) (src/WebDAV/WebDAVAdapter.php)
- Edited copy of a member (13 corresponding lines) (src/WebDAV/WebDAVAdapter.php)
- Edited copy of a member (15 corresponding lines) (src/Filesystem.php)
- Edited copy of a member (15 corresponding lines) (src/PhpseclibV2/SftpConnectionProvider.php)
- Edited copy of a member (16 corresponding lines) (src/AsyncAwsS3/AsyncAwsS3Adapter.php)
- Edited copy of a member (17 corresponding lines) (src/Local/LocalFilesystemAdapter.php)
- Edited copy of a member (18 corresponding lines) (src/GridFS/GridFSAdapter.php)
- Edited copy of a member (19 corresponding lines) (src/AsyncAwsS3/AsyncAwsS3Adapter.php)
- Edited copy of a member (25 corresponding lines) (src/PhpseclibV2/SftpAdapter.php)
- Edited copy of a member (25 corresponding lines) (src/WebDAV/WebDAVAdapter.php)
- Edited copy of a member (3 corresponding lines) (src/AsyncAwsS3/AsyncAwsS3Adapter.php)
- …and 17 more

## Changes since last survey

- 2 commits — 1 feature/other, 1 fixes

## By area

- (repo) — 1 commit
- src/AwsS3V3 — 1 commit

## Notable commits

- fix: Merge pull request #1935 from dhrupo/fix/s3-client-stub-constructor-return
- change: Do not return a value from the S3ClientStub constructor
