Close the licence gaps, absorb the ets pedagogy, and check links in CI

[pedrobritx]

Makes this repository the single home for the pedagogy, and fixes the two licence problems that would have made a commercial platform built on it legally awkward.

Part of consolidating four repositories into two — see ADR 0001 in lexis. The companion PRs are lexis#… (the commercial half) and ets#2 (the tombstone).

Licence

Two gaps, both of which would have bitten later rather than now:

Outside contributions could not be commercially licensed. The repo is dual-licensed — free for teachers, paid for tuition-charging institutions — but had no CLA, so a contributor retained rights that made the commercial half unsellable. CONTRIBUTING.md now requires a DCO sign-off plus an explicit dual-licensing grant.

The attribution clause applied to the copyright holder's own products. §4 requires attribution on generated materials, which would have meant every worksheet Lexis produces carrying a credit to its own framework. LICENSE.md §4.1 reserves the copyright holder's rights and names BRITX products explicitly.

The README also now states the source-available, not open source distinction plainly. "Open source" is a defined term and using it loosely for a licence that restricts commercial use invites arguments the licence never intended.

Absorbed from ets

That repository specified in prose what this one already implements. Its pedagogical half moves here, to sit with the data it describes:

Now here	Was
docs/CANON.md	The pedagogical half of ets/CANON.md — the 7-phase canon, positional archetype identity, per-level strand budgets, framework-vs-programme scope, single source of truth
docs/framework-overview.md	docs/framework/overview.md, with its "what is where" table repointed at src/data/*.js
docs/handout-authoring.md	docs/framework/authoring-guide.md, bannered
docs/research/	The SLA reference, the annotated bibliography, and the thesis framework this teaching model derives from
schemas/	Five JSON Schemas, $ids repointed to this repository
tools/validate.mjs	Rewritten to import src/data/*.js directly rather than a generated JSON mirror

efll-framework-v2-spec.md gets a superseded banner. It still read "locked decisions, ready for implementation" for a design that was deliberately not built — no router, a wizard rather than /compose routes, activity-keyed handouts rather than three authored tiers. The banner tabulates spec against reality and names the two things from it that are genuinely unbuilt rather than superseded: the saved-lesson library and answer keys.

docs/handout-authoring.md gets the same treatment for the same reason, and survives because its level-calibration tables describe pedagogy rather than file format — text length per level, exercise type per level, sentence-frame counts, how much of a rule the learner writes. Those are still correct.

Validation

npm run validate now imports the data modules rather than a generated copy, which is what makes the ets data/ directory deletable. It checks schema conformance plus four invariants no schema can express:

• every archetype's minute budget sums to 60
• every level's strand hours sum to 60
• the macro grid is complete at 6 × 6
• every phase has exactly one handout task per activity option — the index join that silently prints a blank handout when it is short

6 themes · 6 levels · 7 phases · 8 archetypes
36 macro cells · 252 prompts · 2160 handout tasks
archetype budgets: 60 ×8 · strand budgets: 60 ×6
activities/phase:  8 8 8 8 12 8 8

Each check was proved by injecting the fault it exists to catch. Removing one of the 2,160 handout tasks fails the run, which is the one that matters — that join is otherwise silent.

Link checking in CI

tools/check-links.mjs, ported from the ets migration tooling and stripped of the one-shot Notion page-id rewriting.

This migration produced dangling links twice, both times pointing at src/data/*.js paths that had moved, and both times invisible on GitHub until someone clicked. Docs here cite those paths constantly. External links are deliberately not checked — that needs the network and turns a deterministic check into a flaky one.

Also

• docs/research/annotated-bibliography.md deduplicated. Two copies existed after the migration; the root-level one was better formatted (the migrated copy carried Notion export artefacts that merged bold-run boundaries mid-sentence, producing things like "CS/Full-Stack StudentVerification pass"). The good copy moves into docs/research/ and the mangled one goes.
• README gains a documentation index; its project-structure tree now lists the data modules added since it was written.

Verification

• npm run validate — passes, with one intentional note about archetype 7's alias colliding with archetype 5's name
• npm run check-links — 40 relative links resolve; proved by injecting a dangling link, which failed with exit 1
• npm run build — succeeds
• All 252 prompts, 36 macro cells, 49 activity options and 8 archetype budgets in the retired ets mirror confirmed present in src/data/ before that mirror was deleted

---

Generated by Claude Code