crosseno/learning

Storage-neutral contracts for directional bilingual learning packs in Crosseno.

dev-main 2026-07-18 15:31 UTC

Requires

• php: ^8.5
• crosseno/clues: ^0.1
• crosseno/core: ^0.1
• crosseno/lexicon: ^0.1

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.95
• phpstan/phpstan: ^2.2
• phpunit/phpunit: ^12.5

MIT

Published on Packagist.org on 2026-07-26 19:00 UTC

README

Storage-neutral contracts for directional bilingual learning packs in Crosseno.

The package models CEFR proficiency, approved sense mappings, confidence and ambiguity thresholds, metadata-only eligibility queries, deterministic selection, and coverage masks tied to a specific answer-pack ordinal space.

composer install
composer check

The library contains no language dataset and no clue text storage. A concrete learning pack supplies a catalog and documents its CEFR rubric in its manifest.

The typical runtime flow is metadata-only and directional:

use Crosseno\Learning\Model\CoverageQuery;

$manifest = $learningPack->manifest();
$query = new CoverageQuery(
    $manifest->languages,
    $proficiency,
    maximumResults: 10_000,
);
$mask = $learningPack->coverageIndex()->query($query);
$mask->assertCompatible($answerPack->manifest());
$eligibleClues = $learningPack->catalog()->eligible($query);

The host supplies $learningPack, $answerPack, and the learner's $proficiency. The coverage query never loads clue text into generator search.