I3024 — The Knowledge screen's manual link names a page the site has, on the server and on Pages
The How to review panel of /ui/knowledge links to the knowledge manual as {DOCS_MOUNT}/docs/knowledge/, which a server serves from the site build mounted at /docs and which the published snapshot rebases to /docs/knowledge/ on majordomus.dev.
DONE wave 0 · p1 · implementation profile · parallel safe
Objective
The How to review panel of /ui/knowledge links to the knowledge manual as {DOCS_MOUNT}/docs/knowledge/, which a server serves from the site build mounted at /docs and which the published snapshot rebases to /docs/knowledge/ on majordomus.dev.
Why
Verified live on v0.30.1 (majordomus.dev, 9904000d2df) with headless Playwright: the manual link rendered as href=\"/knowledge/\", which answers 404, while https://majordomus.dev/docs/knowledge/ answers 200. A server mounts the whole site build under /docs, and the snapshot strips that mount (web/report/snapshot.rs), so the link written as /docs/knowledge/ named the site page /knowledge/, which does not exist.
Current state
manual() links to {DOCS_MOUNT}/knowledge/, which resolves to /knowledge/ on Pages and to a missing page under the server's /docs mount.
Desired state
manual() links to {DOCS_MOUNT}/docs/knowledge/; a crate test proves that the path below the mount is a page of site/content.
Scope
- apps/majordomus-cli/src/ui/knowledge.rs
Dependencies
None. This issue is a root of the graph.
Acceptance criteria
- The manual link is {DOCS_MOUNT}/docs/knowledge/ and is rebased to /docs/knowledge/ in the published snapshot
- A crate test resolves the link's path below the documentation mount to an existing file under site/content
Validation
- cargo test --lib ui::knowledge
- scripts/ui audit --only /ui/knowledge
Evidence required
- knowledge_manual_link_resolves
Evidence
| covers | type | command | result | at commit |
|---|---|---|---|---|
| knowledge_manual_link_resolves | ci | validate run 39438896504 at master 9a5a9b77520: rust (1-3) jobs 118683336143 118683336062 118683336401 run cargo test, incl. ui::knowledge::the_manual_link_names_a_page_of_the_site_on_either_surface (19d5dda61eb) | success (the run's only red job is pages, which runs no test) | a81b1e3 |
Timeline
- started
- 2026-10-20T16:15:26Z
- verified
- —
- completed
- 2026-10-20T16:27:54Z
Those three fields, the evidence above and the state of the dependencies are all the status is made of. There is no status field to disagree with them.
Canonical record: .ai/repo/project/issues/I3024.yaml. Read it back with majordomus plan show I3024.