epic: Phase 1 — useful steward corpus (public parity first)
Maintainers usually reply within 1 day
@DerekRoberts is already working on this.
Since Sep 24, 2026.
Assessment
This issue has not been assessed yet.
Description
Phase: Phase 1. Docs first. This epic is the order and the gates. #700 is the design.
Decision (Derek Roberts, 2026-09-24)
Order is docs, then reliability, then forkability. Forkability is nice-to-have, not a priority. He would rather the app be down than serve an incorrect answer.
Public parity first. Member-portal documents only after an export path exists. my.bcgeu.ca cannot be fetched by the public HTML sentinel. Member docs are out of this epic until #711 is done.
If a fork ever happens, a stranger forks, brings their own documents (URLs, PDFs, Markdown), and hosts on their own Hugging Face Space. Not a template product. Not MinionTech-hosted multi-tenant. Victoria School Board is an illustration only. They are not customers. Nobody is a customer. Do not build a Victoria bot. The parked contract is #712. Phase 1 ingest stays declarative so that stays possible. Forkability is a constraint on ingest shape, not a workstream in this phase.
Alert channel, when a human is paged, is GitHub issues only. No Slack. No email. That paging work is Phase 2, not this epic.
Telemetry (#340, draft PR #679) stays untouched.
Gates
- No committed legal file is deleted without substantive parity. A human pull request updates legal text. The image build does not fetch upstream legal text.
- #696 is the HTML sentinel already in flight (
feat/automate-doc-ingestion). Do not open another pull request for that work. - Public sources already in git (statutes, OHS, WCB, agreements) get a parity pass before replacement.
- PDFs: #699
- HTML sentinel: #695 and PR #696
- #701, #702, and #703 stay out of this epic until #711 (export of
my.bcgeu.ca, plus Derek's yes to commit that text).
#697 and #698 stay children of the design epic #700. They are not re-filed here and they are not a Phase 1 gate.
Sequenced work
- #700 — design: declarative link-driven knowledge base
- #695 / PR #696 — HTML sentinel already in flight. No second pull request.
- #699 — PDF extraction and shadow-audit of multi-part statutes
- #711 — member-portal export gate. Blocks #701, #702, #703. Not part of the public parity pass.
Acceptance criteria
- Every public source already committed under
app/data/(statutes, OHS, WCB, agreements) has a recorded parity result against its upstream before any replacement. PDF sources are the work in #699. HTML sources are the sentinel in #695 and PR #696. - No pull request in this phase deletes a committed legal file unless that parity result shows substantive parity.
- Legal text changes land only through a human-reviewed pull request.
app/Containerfileand.github/workflows/pr.ymldo not fetch upstream legal text during the image build. - PR #696 remains the in-flight HTML sentinel. No second pull request is opened for that sentinel from this epic.
-
app/data/sources.yamlstays the declarative registry (URLs, PDFs, Markdown), so #712 stays possible without a second bot. - #701, #702, and #703 have no ingestion work under this epic. They stay blocked on #711.
- #340 and draft PR #679 are unchanged by this epic.
Later public sources
- BC core policy (CPPM), https://www2.gov.bc.ca/gov/content/governments/policies-for-government/core-policy/about-cppm (suggested by @pbastia, formerly #565). Add it through the same parity-gated path once Phase 1 gates pass.
- Dominant language
- Python
- Stars
- 2
- Forks
- 1
- Avg merge
- 4h 16m
- Merged PRs (30d)
- 38
Getting set up
- Ships a Dockerfile or Docker Compose file
- No pull request template
- No contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from MinionTech/vexilon
-
Difficulty 2/5 Half a day Newbie friendliness 66/100
MinionTech/vexilon#844 ·
Maintainers usually reply within 1 day
-
OHS Part 8 source missing B.C. Reg. 135/2026 (face-seal amendments, in force 2026-11-06)Possibly taken @DerekRoberts claimed this today. Open
Difficulty 2/5 1-3 hours Newbie friendliness 55/100
MinionTech/vexilon#842 · 1 assignee ·
Maintainers usually reply within 1 day
-
research: consume from canli.orgPossibly taken @DerekRoberts claimed this 1 day ago. Open
MinionTech/vexilon#836 · 1 assignee ·
Maintainers usually reply within 1 day
-
enhancement
Difficulty 5/5 Over a week Newbie friendliness 22/100
MinionTech/vexilon#821 · 1 assignee ·
Maintainers usually reply within 1 day
-
feat(rag): hybrid BM25 + FAISS retrieval with reciprocal-rank fusionMay be free again @DerekRoberts claimed this 28 days ago, and no pull request is open. Openenhancement
MinionTech/vexilon#802 · 1 assignee ·
Maintainers usually reply within 1 day
All issues in MinionTech/vexilon
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 64/100
cal-itp/data-infra#5887 ·
Maintainers usually reply within 1 day
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
ranacseruet/vaice#139 ·
Maintainers usually reply within 1 day
-
numpy.bytes_ attributes are recorded as a truncated repr instead of their contentPossibly taken @JoeyTan21 claimed this today. Open
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
batocera-linux/batocera.linux#17423 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 62/100