docs(design): investigation for the rules and bestiary lookup (#553) #554

Merged

claude-bot merged 1 commit from docs/553-rules-reference-investigation into main

2026-09-08 01:20:24 +00:00

claude-bot commented

2026-09-08 01:02:02 +00:00

Contributor

The investigation #553 asked for, committed under docs/design/ (not the gitignored internal folder, which has already lost one review).

What exists: the game-system registry with versioned stat schemas, the stat-block renderer, the Shelf card and reveal pipeline, the Prep tool registry, the session tsvector search pattern, generate_structured_text with json_schema. Absent: any game content, any index over lore, embeddings, structured citations.
Data and licences: Pathfinder 2e remaster content under the ORC licence via the Foundry pf2e packs (per-record publication.license); SRD 5.1 and 5.2.1 under CC-BY-4.0 via Open5e's data (per-document licences). The Paizo Community Use Policy (Archives of Nethys, pf2ools) forbids commercial use and is ruled out for a hosted product. Attribution obligations spelled out; reserved material handled as an import rule.
Design: committed licence-filtered content packs built by repo scripts from pinned upstream commits; a reference_entries table with a generated tsvector and name-prefix ranking, seeded idempotently like the builtin schemas; two endpoints; a Look up Prep tool, a third Ctrl-K section, a reference Shelf card kind with sane reveal defaults, a licences page, the same search inside the redesign's Table mode, and an ask-the-rules tool with structured citations later.
Four phases; phase 1 (data and search) is backend-only and can start beside the redesign. Three decisions to confirm are listed at the end.

Reverses the 2026-07 no-content exclusion for ORC and CC-BY sources only; keeps it for Community Use Policy sources.

🤖 Generated with Claude Code

The investigation #553 asked for, committed under `docs/design/` (not the gitignored internal folder, which has already lost one review). - **What exists:** the game-system registry with versioned stat schemas, the stat-block renderer, the Shelf card and reveal pipeline, the Prep tool registry, the session `tsvector` search pattern, `generate_structured_text` with `json_schema`. Absent: any game content, any index over lore, embeddings, structured citations. - **Data and licences:** Pathfinder 2e remaster content under the ORC licence via the Foundry pf2e packs (per-record `publication.license`); SRD 5.1 and 5.2.1 under CC-BY-4.0 via Open5e's data (per-document licences). The Paizo Community Use Policy (Archives of Nethys, pf2ools) forbids commercial use and is ruled out for a hosted product. Attribution obligations spelled out; reserved material handled as an import rule. - **Design:** committed licence-filtered content packs built by repo scripts from pinned upstream commits; a `reference_entries` table with a generated `tsvector` and name-prefix ranking, seeded idempotently like the builtin schemas; two endpoints; a Look up Prep tool, a third Ctrl-K section, a `reference` Shelf card kind with sane reveal defaults, a licences page, the same search inside the redesign's Table mode, and an ask-the-rules tool with structured citations later. - **Four phases;** phase 1 (data and search) is backend-only and can start beside the redesign. Three decisions to confirm are listed at the end. Reverses the 2026-07 no-content exclusion for ORC and CC-BY sources only; keeps it for Community Use Policy sources. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

claude-bot added 1 commit

2026-09-08 01:02:02 +00:00

docs(design): investigation for the rules and bestiary lookup (#553 )

CI / Summarisation accuracy eval harness (stub provider) (pull_request) Successful in 59s

Details

CI / Bot/backend version sync (pull_request) Successful in 24s

Details

CI / Backend lint (ruff) (pull_request) Successful in 1m24s

Details

CI / Bot tests and audit (pull_request) Successful in 1m50s

Details

CI / Frontend tests, audit, and build (pull_request) Successful in 4m45s

Details

CI / Docker image build (pull_request) Successful in 4m32s

Details

CI / Backend migration, tests, and audit (pull_request) Successful in 17m37s

Details

CI / Synthetic session harness (no GPU, no LLM) (pull_request) Successful in 15m45s

Details

0a1a803abe

What exists (registry, stat schemas, Shelf, Prep tools, search, LLM), the
data sources and their licences (PF2e remaster under ORC via the Foundry
packs; SRD 5.1/5.2.1 under CC-BY-4.0 via Open5e; the Community Use Policy
ruled out for a hosted product), the design (committed licence-filtered
content packs, a reference_entries table with tsvector search, a Look up
tool, a Ctrl-K section, a reference Shelf card, a licences page, Table mode
search, ask-the-rules with structured citations), four phases, and the
decisions to confirm. Reverses the 2026-07 no-content exclusion for ORC and
CC-BY sources only.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

claude-bot scheduled this pull request to auto merge when all checks succeed

2026-09-08 01:02:24 +00:00

claude-bot merged commit 7eff749c99 into main

2026-09-08 01:20:24 +00:00

claude-bot referenced this pull request from a commit

2026-09-08 01:20:25 +00:00

Merge PR #554: docs(design): investigation for the rules and bestiary lookup (#553)

claude-bot deleted branch docs/553-rules-reference-investigation

2026-09-08 01:20:25 +00:00