docs: house encyclopedia design #16

Open
claude-bot wants to merge 6 commits from docs/house-encyclopedia-design into main
Member

Design for a Wikipedia-style, bilingual (de/en) encyclopedia generated from the wiki notes. It is built inside this service and refreshed as part of reconciliation.

  • Public and private split: private content is visible only to the Authentik wiki group.
  • Reachable only from the LAN or via NetBird.

Approved by the owner in session; the implementation plan follows.

🤖 Generated with Claude Code

Design for a Wikipedia-style, bilingual (de/en) encyclopedia generated from the wiki notes. It is built inside this service and refreshed as part of reconciliation. - Public and private split: private content is visible only to the Authentik wiki group. - Reachable only from the LAN or via NetBird. Approved by the owner in session; the implementation plan follows. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
claude-bot added 1 commit 2026-10-24 08:26:51 +00:00
docs: house encyclopedia design
ci/woodpecker/pr/test Pipeline was successful
ci/woodpecker/push/test Pipeline was successful
e560fd13a7
Wikipedia-style, bilingual (de/en) articles generated from the wiki,
with public/private split via Authentik group, LAN/NetBird only.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
claude-bot added 1 commit 2026-10-24 08:30:15 +00:00
docs: encyclopedia on one host, gated by the app's own OIDC
ci/woodpecker/push/test Pipeline was successful
ci/woodpecker/pr/test Pipeline was successful
e240bea5b1
wiki.renner.uno has been plain Traefik with in-app OIDC since homelab
2026-10-19; the gate-based two-hostname split no longer applies.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
claude-bot added 1 commit 2026-10-24 08:35:55 +00:00
docs: house encyclopedia implementation plan
ci/woodpecker/pr/test Pipeline was successful
ci/woodpecker/push/test Pipeline was successful
1d5df07ad0
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@@ -0,0 +87,4 @@
- **There is one hostname: `wiki.renner.uno`.** The service already does OIDC itself, so it knows whether a reader is signed in. Only wiki-group members can sign in, because of the policy binding.
- The encyclopedia routes allow anonymous readers. Every other route keeps requiring a login.
- For an anonymous reader, private sections and private articles are left out of the HTML entirely, not merely hidden. A "log in to see more" link starts the OIDC login.
- The host stays LAN- and NetBird-only, as it is today: there is no `dns.renner.uno/public` label.
Owner

and not netbitrd.renner.uno/public label either

and not netbitrd.renner.uno/public label either
@@ -0,0 +90,4 @@
- The host stays LAN- and NetBird-only, as it is today: there is no `dns.renner.uno/public` label.
- **Articles go live without human approval**, as the owner decided. The service commits generated articles directly to the notes repo, the same way it already commits raw deposits. Leak protection is therefore entirely automatic and has three layers:
- the writer marks content private;
- a deterministic filter on the public text catches IP addresses (v4 and v6), hostnames and FQDNs, HA entity IDs, MACs, file paths, and OpenBao or secret paths. Any match moves the paragraph into a private section;
Owner

generic examples may well belong in the public section

generic examples may well belong in the public section
claude-bot added 1 commit 2026-10-24 09:38:05 +00:00
docs(encyclopedia): no netbird public label; generic examples stay public
ci/woodpecker/pr/test Pipeline was successful
ci/woodpecker/push/test Pipeline was successful
a42c978a99
The wiki Ingress carries neither dns.renner.uno/public nor
netbird.renner.uno/public; either publishes the host via
netbird-service-sync.

The deterministic leak filter only counts this house's identifiers:
values found in the article's source notes, names under renner.uno, and
credentials. Reserved example values (RFC 5737, RFC 3849, RFC 2606)
never count. Writer and leak-check prompts keep generic examples public.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
claude-bot added 1 commit 2026-10-24 10:20:49 +00:00
docs(encyclopedia): drop credential handling
ci/woodpecker/push/test Pipeline was successful
ci/woodpecker/pr/test Pipeline was successful
206c4629aa
Credentials in the wiki are an upstream failure, not a case the
encyclopedia handles: no credential scanner rule, no writer instruction.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
claude-bot added 1 commit 2026-10-24 10:42:59 +00:00
docs(encyclopedia): nightly run, fold in concept review
ci/woodpecker/pr/test Pipeline was successful
ci/woodpecker/push/test Pipeline was successful
e93da3990c
Nightly schedule (RunAt 06:00, after the 04:30 distill) instead of a
run after every sync. Reconciler never stops the host; catalog
freshness gate; failure memory in articles/_state.json; a missing or
shrunken plan never deletes; translation unit by unit with structure
reassembled by the service; links and listings to private articles
dropped for anonymous readers; media paths validated; in-page 404;
PilotSlugs; Cache-Control no-store; mermaid strict.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
All checks were successful
ci/woodpecker/push/test Pipeline was successful
ci/woodpecker/pr/test Pipeline was successful
You are not authorized to merge this pull request.
This pull request can be merged automatically.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin docs/house-encyclopedia-design:docs/house-encyclopedia-design
git checkout docs/house-encyclopedia-design
Sign in to join this conversation.