Source: ReadingListRepository.php

Bounded candidate reference — 2026-10-20: 0.2.0-rc.1 is committed locally through 84f415b3098af5653577b2c65eea31fca21df79c, unpublished and not production-approved; stable PHP >=8.5.11 <8.6.0 is required. This is documentation, not adoption: this knowledge base retains its installed 0.1.0-rc.1 dependency and PHP 8.2.11 local profile. Dated PHP 8.2 evidence is historical; earlier dirty-source reports retain their original test provenance, not retroactive clean-commit proof. Candidate examples are illustrative: API signatures were reviewed, but candidate code was not executed by this editorial update. See current checkpoint, open criteria and adoption boundary.

Origin: examples/reading-list/app/Repositories/ReadingListRepository.php

<?php

declare(strict_types=1);

namespace Portability\ReadingList\Repositories;

use Portability\ReadingList\Domain\ReadingItem;

/** Application persistence port expressed in reading-list concepts. */
interface ReadingListRepository
{
    /** @return list<ReadingItem> Return the ordered reading list. */
    public function all(): array;

    /** Return one entry by exact slug, or null when it does not exist. */
    public function findBySlug(string $slug): ?ReadingItem;
}

Editorial provenance

Source: examples/reading-list/app/Repositories/ReadingListRepository.php. Source SHA-256: 01903d982472f2fb2787bc81c88c6c724e9da004bb9638d28fea607a609583d2.

Framework candidate reference; editorial checkpoint 2026-10-20. See candidate status and adoption boundary.