imbajin opened a new pull request, #472:
URL: https://github.com/apache/hugegraph-doc/pull/472
## Before → after
| Before | After |
| --- | --- |
| Three release entries were split across configuration and build behavior.
| `versions.json` drives one immutable `latest / 1.7 / 1.5 / 1.3 / 1.0` release
contract, including selectors, aliases, SEO, and aggregate metadata. |
| Summary search had no durable load-failure recovery path. | Native summary
search remains primary and exposes distinct empty/error states with a stable
keyboard-accessible retry. |
| No optional AI integration contract existed. | Kapa is disabled by
default, locale-bound, and loaded only after an explicit click; timeout, late
response, and retry remain isolated from native search. |
| CI mixed build and publication concerns. | Fixed event plans build
immutable artifacts, revalidate the aggregate, run Chromium gates, and publish
only to reviewed ASF targets with minimal permissions. |
## Main changes
- Add the shared OINK shell behavior for navigation, version/locale-scoped
sidebar state, mobile isolation, focus restoration, theme, image zoom,
Backlinks, and Blog copy-link behavior.
- Keep local summary search authoritative while adding an optional Search
Tail
+ Floating Launcher Kapa adapter with privacy-safe click gating.
- Generate bilingual latest-only `llms-full.txt` files without adding them to
historical releases or making Kapa a build dependency.
- Build five immutable releases and preserve production historical links from
latest-only staging.
- Replace the previous workflow with fixed production/staging plans,
short-lived artifacts, aggregate/security validation, Node 24, Playwright,
Chromium, and fixed ASF publication targets.
## Ask AI direction
The selected design combines a contextual Search Tail with a restrained
Floating Launcher. It excludes a persistent side panel and the old red/pink
assistant treatment.
<img width="860" alt="Ask AI interaction direction comparison"
src="https://github.com/user-attachments/assets/013cceaa-fd72-47cf-88ff-69224e0ce32b";
/>
Full decision record:
https://github.com/apache/hugegraph-doc/issues/467#issuecomment-5541691334
## Validation
- `bash dist/validate-links.sh`
- `python3 -m unittest discover -s scripts -p 'test_*.py' -v` — 77 passed
- `node --test tests/ui-ai/*.test.cjs` — 15 passed
- `node --test tests/e2e/workflow-contract.test.cjs` — 5 passed
- Five-version production aggregate — 1,082 HTML, 3,413 published files,
10 error documents
- Latest-only ASF OINK staging aggregate — 276 HTML, 822 published files,
2 error documents; every historical selector remains on the production
origin
- Blocking Chromium suite — 26 passed, 3 expected PR-B-only skips
## Delivery boundaries
- Kapa remains disabled until the reviewed EN/CN source groups, staging
corpus,
CSP hosts, and live privacy/failure smoke checks pass.
- Community roster and content pilots remain isolated in PR-B.
- Full-content local search remains deferred and is tracked in #471.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
