fix(website): audit sweep (legal, docs, rendering, accuracy)#62
Conversation
Addresses consolidated findings from four parallel audits (legal / business, docs rendering, paper vs website, content completeness). All 18 substantive items fixed; paper update and future blog posts deferred. P0 docs navigation: - content/docs/guides/meta.json expanded from 5 to 11 pages so langchain, openai-agents-sdk, crewai, offline-verify, base-l2-anchor and eu-compliance-walkthrough stop being orphaned in the sidebar. - content/docs/reference/meta.json now includes mcp-tools entry. P0 legal risk: - /sbom page copy no longer claims "authoritative CycloneDX published with every GitHub release"; now reads as a mirror of pyproject.toml at the tagged release with CycloneDX available when attached. - All NB-0482 TUV Sud references across atx-data.ts, atx-console-data, and hero-cert data replaced with "NB-XXXX Your certified auditor" so the mock no longer impersonates a real notified body. - hero-cert now shows an explicit "Sample / illustrative / not a real certificate" row to prevent regulatory confusion on screenshots. - /security page disclosures relabelled: ATX-* are internal tracking IDs, upstream PyJWT CVE now links to the upstream advisory index instead of citing a specific CVE number we have not published. - Pricing Enterprise tier dropped binding "SLA" language in favour of "priority support" wording until an actual SLA document exists. P0 content accuracy (paper cross-check): - ATX_STANDARDS strip trimmed: removed IEEE 7000, ISO/IEC 42001, and ERC-8004 (aspirational, not implemented per paper); added RFC 8785 JCS, RFC 6962 Merkle, and GDPR Article 17 which the paper validates. - VC issuance benchmark updated from 3.2 ms to 17 ms median to match paper measurement (paper Table 5 page 314). Detail line clarifies this covers canonicalise + sign + persist. P1 consent and disclosure hardening: - config.tsx highlights rewritten: `question`, `askedBy`, and `detail` fields removed from all 5 testimonials so internal GTM context is not exposed in the public repo. Only the fields actually rendered (event, quote, name, role, company, venue) remain. - Rishabh Pathak's company anonymised to "Major US airline" to avoid implying his employer endorses or has adopted Attestix. P1 docs rendering: - mermaid.tsx repalettised to the atx token set. Dropped indigo hardcodes; diagrams now render in warm-ink/gold/panel tones consistent with the rest of the v2 design. Font family chained through var(--font-sans). - globals.css sidebar-folder selector widened to also match Fumadocs v15.8+ markup variants (data-collapse, data-sidebar-folder) so folder labels stay mono uppercase if fumadocs-ui bumps DOM. - docs/layout nav title no longer uses the v2 serif; now matches docs body sans for visual consistency inside the docs surface. P2 polish: - Hero enforcement banner qualified: "Main enforcement wave ... (high-risk systems, Aug 2, 2026)" so it no longer implies single blanket deadline. - research-paper.mdx BibTeX switched from @Article to @online (no venue claimed yet) with a note that formal citation replaces it on publication. - Console fixtures for Health, Logistics, Talent, Financial, and Legal agent issuers renamed from "VibeTensor <division>" to "Example <division>" so the mock no longer implies VibeTensor has real business-unit subsidiaries. - Compliance checker result view now shows a top-of-page warning banner clarifying it is an educational heuristic, not legal advice. Footer disclaimer kept as reinforcement. Deferred (not in scope for website): - Paper itself updating from 284 tests (v0.2.0) to 358 tests (v0.3.0) is a paper-track change, not a website change. - New blog posts (Base L2 testnet milestone, framework integrations GA) authored when natural.
|
Caution Review failedPull request was closed or merged during review Note
|
| Cohort / File(s) | Summary |
|---|---|
Documentation Indexing website/content/docs/guides/meta.json, website/content/docs/reference/meta.json |
Added six new guide page slugs and one reference page slug to respective pages arrays for index discovery. |
Research & Publication Metadata website/content/research-paper.mdx |
Updated BibTeX citation from @article to @online type; added organization name and URL; appended note about future formal publication replacement. |
Compliance & Legal Guidance website/src/app/(marketing)/demo/compliance-checker/step-result.tsx |
Added top-of-page legal advisory callout clarifying that the classification tool is educational only and does not replace qualified EU AI Act legal counsel. |
SBOM Documentation website/src/app/(marketing)/sbom/page.tsx |
Updated metadata description and page copy to reference v0.3.0 release pyproject.toml and clarify CycloneDX artifact availability; changed external link target from releases page to main branch source. |
Security Disclosures website/src/app/(marketing)/security/page.tsx |
Added reference field to disclosure entries (null for internal ATX-* IDs; upstream advisory URL for PyJWT); clarified that ATX-* values are internal tracking IDs, not CVEs; updated PyJWT title to generic label. |
UI Typography & Sidebar Styling website/src/app/docs/layout.tsx, website/src/app/globals.css |
Reduced navigation title font size/weight (18px → 15px, serif → semibold); expanded CSS sidebar selectors to support multiple DOM markup structures for folder section labels. |
Mermaid Diagram Configuration website/src/components/mermaid.tsx |
Switched theme from "dark" to "base"; extracted hardcoded color values into PALETTE constant; updated font family to var(--font-sans) with fallback; aligned container classes to custom design tokens (rounded-atx-md, border-atx-line-soft, bg-atx-bg-sunken, text-atx-ink-dim). |
Marketing Hero Components website/src/components/sections/v2/hero-cert.tsx, website/src/components/sections/v2/hero-v2.tsx |
Added "illustrative · not a real certificate" label row to sample certificate display; expanded enforcement timeline messaging with specific date (Aug 2, 2026) and high-risk systems qualifier. |
Benchmark Data website/src/components/sections/v2/benchmarks.tsx |
Updated "VC issuance end-to-end" benchmark value from 3.2 to 17; refined detail description; adjusted spark series metrics accordingly. |
Example Data Placeholders website/src/lib/atx-console-data.ts |
Replaced five "VibeTensor" branded issuer names with generic "Example" variants across agent console sample data (Health Provider, Logistics Corp, Talent Services, Financial Services, Legal Services). |
Standards & Certificate Sample Data website/src/lib/atx-data.ts |
Added RFC standards (8785 JSON canonicalization, 6962 Merkle trees) and GDPR Article 17 erasure to ATX_STANDARDS; removed IEEE 7000 and ISO/IEC 42001 entries; updated notified body example from NB-0482 · TÜV SÜD to NB-XXXX · Your certified auditor placeholder. |
Pricing & Testimonials Configuration website/src/lib/config.tsx |
Updated "Enterprise" pricing features (support/deployment/audit → priority email/assistance/collaboration); simplified testimonial highlights by removing internal GTM fields (askedBy, question, detail) and generalizing context/event/venue values; updated one company reference to generic "Major US airline". |
Estimated code review effort
🎯 3 (Moderate) | ⏱️ ~20 minutes
Possibly related PRs
- feat(website): v2 revamp - editorial design, /console, 5 new routes, per-framework docs #61 — Introduces the same new documentation pages (eu-compliance-walkthrough, langchain, openai-agents-sdk, crewai, offline-verify, base-l2-anchor, mcp-tools) and updates matching docs metadata, indicating coordinated documentation refresh.
🚥 Pre-merge checks | ✅ 2 | ❌ 1
❌ Failed checks (1 warning)
| Check name | Status | Explanation | Resolution |
|---|---|---|---|
| Docstring Coverage | Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. | Write docstrings for the functions missing them to satisfy the coverage threshold. |
✅ Passed checks (2 passed)
| Check name | Status | Explanation |
|---|---|---|
| Description Check | ✅ Passed | Check skipped - CodeRabbit’s high-level summary is enabled. |
| Title check | ✅ Passed | The PR title accurately captures the main theme of the changeset: a comprehensive audit sweep addressing legal disclaimers, documentation updates, rendering improvements, and factual accuracy across the website. |
✏️ Tip: You can configure your own custom pre-merge checks in the settings.
✨ Finishing Touches
📝 Generate docstrings
- Create stacked PR
- Commit on current branch
🧪 Generate unit tests (beta)
- Create PR with unit tests
- Commit unit tests in branch
fix/audit-sweep-2026-04-20
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.
Comment @coderabbitai help to get the list of available commands and usage tips.
Deploying attestix with
|
| Latest commit: |
5fc7715
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://039fb0a0.attestix.pages.dev |
| Branch Preview URL: | https://fix-audit-sweep-2026-04-20.attestix.pages.dev |
Follow-up to PR #61. Addresses findings from four parallel audits (legal/business/confidential, docs rendering, paper vs website cross-check, blog/docs completeness).
15 files changed, 18 items fixed
P0
P1
P2
Deferred
Verified
Summary by CodeRabbit
Release Notes
New Features
Documentation
Improvements