docs: refresh public README and Pages navigation

[seonghobae]

Outcome

Refresh the public repository/Pages surface around LineageWeave's actual product responsibility while keeping evidence, license, and canonical-owner boundaries explicit. The root README/public landing becomes product-first, operator detail remains in its authoritative docs, publication fails closed when the source landing is absent, and repository-owned hosted jobs are pinned to an explicit supported image.

This PR does not introduce a release, customer, production deployment, benchmark superiority, certification claim, psychometric/statistical ownership, or model/provider routing implementation. TEPP/fast-mlsirm and contextual-orchestrator remain canonical owners.

Protected-main conflict repair

Fresh review 5116251331 found a real convergence conflict after protected #931: #908 and current main both modify Tests, PROV-O, and Ontology Pages workflows for different valid reasons. #908 needs explicit ubuntu-24.04 runners plus public-landing publication paths/tests; #931 needs ready_for_review/converted_to_draft, same-PR cancellation, and draft == false admission. Neither contract may be dropped.

Realistic RED 01895d1b9cd37e8c625e28daadedf2a6a395840e first merged the exact protected #931 workflow/contract blobs while retaining #908's structural hosted-runner regression. That deliberately made the branch's tests/test_github_hosted_runner_contract.py fail because the protected workflows still declared ubuntu-latest.

Causal convergence then combined both contracts:

• 53cbd8be9507c8a3bfb4f3bc249945beca7afc2b: Tests keeps fix(ci): defer repository-local jobs while PRs are Draft #931 Draft admission and pins both repository-owned jobs to ubuntu-24.04;
• 5e085c389731ab366210492a94f3aa7a3e1fdf78: PROV-O keeps fix(ci): defer repository-local jobs while PRs are Draft #931 Draft admission and pins its job to ubuntu-24.04;
• 00e90e03ae1afb7f13ae843dd578694d0f72b325: Ontology Pages keeps fix(ci): defer repository-local jobs while PRs are Draft #931 event/cancellation/Draft admission, restores docs: refresh public README and Pages navigation #908 public-landing paths/tests, and pins validate/publish to ubuntu-24.04.

The branch now contains protected main@83eba56149eb802cd63642c507c324c9976ec78e with no history rewrite and no gate weakening. The public README/Pages/test delta is preserved.

Commercial-license prerequisite

Issue #910 remains the policy blocker for public-surface integration: the reachable psycopg2-binary LGPL-family path must be removed/replaced rather than hidden by attribution or a license exception. PR #911 is the active pg8000 replacement lane and is now Ready on its unchanged exact head for current-head validation; #908 must not land before that prerequisite is normally merged and the protected line is re-verified license-clean.

Exact live boundary

• protected base: main@83eba56149eb802cd63642c507c324c9976ec78e
• exact current head: 00e90e03ae1afb7f13ae843dd578694d0f72b325
• live compare: protected main is the merge base and the branch is behind_by=0
• PR: open / Draft / mechanically mergeable
• repository-local Tests 33902990145 and PROV-O 33902990140: completed skipped under Draft admission
• Ontology Pages 33902990079: both exact-head jobs completed skipped; GitHub resolved their runner labels as ubuntu-24.04 without allocating a runner
• central SAST 33902990095, CodeQL 33902990162, Security 33902990087: queued at this snapshot
• exact-head product/release GREEN: not claimed
• qualifying independent current-head APPROVE: not established in this convergence step

Keep Draft behind #911 and current-head governance. Do not transfer predecessor checks/reviews, weaken license inventory, or publish/release from this head.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: f74b7b8c-f5ca-41a2-a0fa-07cce450b4ef

📥 Commits

Reviewing files that changed from the base of the PR and between 35b226b and 032a991.

📒 Files selected for processing (2)

• README.md
• tests/test_github_hosted_runner_contract.py

🚧 Files skipped from review as they are similar to previous changes (2)

• tests/test_github_hosted_runner_contract.py
• README.md

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.

---

📝 Walkthrough

Walkthrough

LineageWeave에 정적 공개 랜딩 페이지를 추가했습니다. 게시 스크립트는 랜딩 페이지를 검증하고 index.html로 복사합니다. 테스트와 CI는 복사 결과, 누락된 소스, 링크, 변경 감지와 고정된 실행 환경을 검증합니다.

Changes

공개 랜딩 페이지와 프로젝트 설명

Layer / File(s)	Summary
정적 랜딩 페이지와 프로젝트 설명 docs/index.html, README.md	docs/index.html에 프로젝트 소개, 탐색 링크, evidence boundary와 라이트·다크 스타일을 추가했습니다. README에 DeepWiki 링크, 제품 스택, 아키텍처, 보안 경계와 문서 지도를 추가했습니다.

랜딩 페이지 게시 및 검증

Layer / File(s)	Summary
랜딩 페이지 게시와 테스트 검증 scripts/publish_ontology_site.py, tests/test_public_landing.py, tests/test_publish_ontology_site.py	게시 스크립트가 docs/index.html의 존재와 파일 형식을 확인한 뒤 출력 디렉터리의 index.html로 복사합니다. 테스트는 바이트 단위 복사, 필수 링크와 누락된 소스에 대한 실패 동작을 검증합니다.

CI 트리거와 실행 환경 검증

Layer / File(s)	Summary
워크플로 트리거, 테스트 대상과 실행 환경 .github/workflows/ontology-pages.yml, .github/workflows/prov-o-contract.yml, .github/workflows/tests.yml, tests/test_github_hosted_runner_contract.py	docs/index.html과 tests/test_public_landing.py 변경을 감지합니다. validate 및 publish 작업에서 새 테스트를 실행하고, validate에서 해당 파일을 컴파일합니다. 지정된 워크플로 작업은 ubuntu-24.04를 사용하며 계약 테스트가 이를 구조적으로 검증합니다.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Merge Risk: ⚪ Minimal · up to 032a9

This refresh updates public documentation, Pages navigation, and explicit hosted-runner declarations without supplied evidence of a concrete correctness, security, availability, or deployment risk; no actionable merge-blocking risk remains after normal checks and review.

Sequence Diagram(s)

sequenceDiagram
  participant GitHub Actions
  participant publish_site
  participant landing_source
  participant output_index_html
  GitHub Actions->>publish_site: 게시 작업 실행
  publish_site->>landing_source: docs/index.html 검증
  publish_site->>output_index_html: 랜딩 페이지 복사
  output_index_html-->>GitHub Actions: 게시 결과 생성

Loading

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 42.86% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 7 functions across 4 files. (1 skipped: 1…	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	제목은 공개 README와 Pages 탐색 경로를 갱신하는 PR의 주요 변경 사항을 정확하고 간결하게 설명합니다.

Full details: Docstring Coverage

Explanation

Docstring coverage is 42.86% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 7 functions across 4 files. (1 skipped: 1 unsupported.)

• Fix all pre-merge checks with AI

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/public-surface-deepwiki

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[seonghobae]

Fresh protected-main review found a real convergence conflict, not a reason to close this PR. #908 modifies the same three repository-owned workflows that protected #931 later changed for Draft admission. GitHub now reports the PR non-mergeable. The valid #908 deltas are explicit ubuntu-24.04 runner pinning plus public-landing publication paths/tests; the valid protected deltas are ready_for_review/converted_to_draft handling, same-PR cancellation, and draft == false job admission. Neither side may be dropped. Repair must reconstruct the workflows with both contracts, preserve the public README/Pages/test delta, and retain protected tests/test_tests_workflow_contract.py. Pre-#931 hosted evidence does not transfer.