aboutsummaryrefslogtreecommitdiff
path: root/docs/superpowers
diff options
context:
space:
mode:
Diffstat (limited to 'docs/superpowers')
-rw-r--r--docs/superpowers/plans/2026-07-27-lectio-national-bibles.md2
-rw-r--r--docs/superpowers/specs/2026-07-27-lectio-national-bibles-design.md2
2 files changed, 2 insertions, 2 deletions
diff --git a/docs/superpowers/plans/2026-07-27-lectio-national-bibles.md b/docs/superpowers/plans/2026-07-27-lectio-national-bibles.md
index c07b254..08aed9e 100644
--- a/docs/superpowers/plans/2026-07-27-lectio-national-bibles.md
+++ b/docs/superpowers/plans/2026-07-27-lectio-national-bibles.md
@@ -14,7 +14,7 @@
- **Corpus text format:** exactly 6 tab-separated columns, UTF-8, one verse per row: `Book · Abbrev · BookNum · Chapter · Verse · Text`. Loader uses columns 1/4/5/6; columns 2/3 are informational.
- **`Book` column:** canonical English name; must be one of the 73 keys in `internal/bible/books.ini`.
-- **Metadata sidecar `<code>.ini`:** keys `lang` (required), `name` (required), `psalm_system` (required, one of `vulgate`/`hebrew`/`drb`), `sigla` (optional). Parsed with `internal/ini` (full-line comments only).
+- **Metadata sidecar `<code>.ini`:** keys `lang` (required), `name` (required), `psalm_system` (required, one of `vulgate`/`hebrew`/`drb`), `sigla` (optional), `autoselect` (optional bool, default `true`; `false` excludes the corpus from language auto-match). Parsed with `internal/ini` (full-line comments only). The validator must accept `autoselect` and must NOT flag the built-in `wuj` (which sets `autoselect = false`); `make check-corpora` passes for all four built-ins.
- **User corpus dir:** `~/.config/lectio/corpora/`. A user `<code>` overrides the embedded one; new codes add.
- **Selection order:** `reading_version` (explicit code) → corpus whose `lang` == `reading_lang` → corpus whose `lang` == `ui_language` → `""` (caller uses `vul`).
- **`traditional_lang` is not touched** and is never read by the corpus resolver.
diff --git a/docs/superpowers/specs/2026-07-27-lectio-national-bibles-design.md b/docs/superpowers/specs/2026-07-27-lectio-national-bibles-design.md
index 96b61f9..adc5ac0 100644
--- a/docs/superpowers/specs/2026-07-27-lectio-national-bibles-design.md
+++ b/docs/superpowers/specs/2026-07-27-lectio-national-bibles-design.md
@@ -10,7 +10,7 @@
- **Corpus text format:** 6 tab-separated columns, exactly, UTF-8, one row per verse: `Book · Abbrev · BookNum · Chapter · Verse · Text`. Rows whose column count != 6 are skipped by the loader (existing behaviour, unchanged).
- **`Book` column:** the canonical English book name, and it MUST be a member of the canonical book set (the 73 keys in `internal/bible/books.ini`). Lookups key on this column; `Abbrev` (col 2) and `BookNum` (col 3) are informational and ignored by the loader.
-- **Metadata sidecar:** `<code>.ini`, full-line-comment INI (parsed by `internal/ini`), keys: `lang` (required), `name` (required), `psalm_system` (required: `vulgate`|`hebrew`|`drb`), `sigla` (optional, a `books.ini` dialect id).
+- **Metadata sidecar:** `<code>.ini`, full-line-comment INI (parsed by `internal/ini`), keys: `lang` (required), `name` (required), `psalm_system` (required: `vulgate`|`hebrew`|`drb`), `sigla` (optional, a `books.ini` dialect id), `autoselect` (optional, default `true`). `autoselect = false` excludes a corpus from language auto-match (reachable only via explicit `reading_version`/`--ref`) — the built-in `wuj` sets this because it is incomplete, so Polish is not silently re-served the defective Wujek; a corrected Wujek drop-in auto-serves.
- **Delivery:** both compile-in (glob `go:embed` + Makefile validate/embed) and runtime drop-in (a user directory, overrides built-ins). Same format and validator for both.
- **User corpus directory:** `~/.config/lectio/corpora/` (consistent with `~/.config/lectio/calendars/`; see Open Decision D1).
- **Selection order (offline reading text):** `reading_version` (explicit corpus code) → corpus whose `lang` matches `reading_lang` → corpus whose `lang` matches `ui_language` → Latin `vul` fallback. Defaults preserved via the `ui_language` step (en→drb; pl→no pl corpus→vul).