From 37fcee1e8c7ec539476a8ae94e0a5c1a2f4cd866 Mon Sep 17 00:00:00 2001 From: ggbdpq Date: Sat, 5 Sep 2026 07:35:45 +0800 Subject: [PATCH 1/2] docs(architecture): audit Desktop and frontend group against implementation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Audit the seven Desktop and frontend documents from the #3522 documentation audit against the current implementation. - frontend-css-governance.md + zh-CN: conventions hold and every cited path resolves (styles.css entry, styles/**, maka-tokens.css, reference-shell.css, styles/settings/**); the pair stays in lockstep (7 sections each). - astryx-surface-file-inventory.md: verified with the repository's own check — `npm run astryx:surface-inventory` reports "coverage: ok (249 files, 1 exclusions)". - astryx-alignment-inventory.md: already carries its own superseded- for-file-coverage note; the family-level map stands. - astryx-full-surface-audit.md and settings-astryx-deep-review.zh-CN.md: dated review records whose spot-checked paths still resolve (settings-section.tsx, rows.css, and the overlay/shell files). - frontend-architecture-astryx-review-2026-08-09.md: a review pinned to HEAD 0ad579d33; a status note now records which cited paths have since moved (workbar refactor under features/workbar/) and that the Astryx core patch is now 0.5.2, while the findings tables stay as written. Every other cited filename was re-checked against the current tree. The six hand-maintained documents gained the standard frontmatter block with `last_verified` (the CSS governance pair keeps `translation_status: synced`). astryx-surface-file-inventory.md stays frontmatter-free on purpose: it is generated by `scripts/generate-astryx-surface-inventory.mjs`, and `npm run astryx:surface-inventory` compares the file byte-for-byte with regenerated output, so manual frontmatter on it fails CI. Refs #3522 Generated-by: GLM-5.3-Flash (ZCode) --- docs/astryx-alignment-inventory.md | 12 ++++++++++++ docs/astryx-full-surface-audit.md | 12 ++++++++++++ ...d-architecture-astryx-review-2026-08-09.md | 19 +++++++++++++++++++ docs/frontend-css-governance.md | 12 ++++++++++++ docs/frontend-css-governance.zh-CN.md | 12 ++++++++++++ docs/settings-astryx-deep-review.zh-CN.md | 12 ++++++++++++ 6 files changed, 79 insertions(+) diff --git a/docs/astryx-alignment-inventory.md b/docs/astryx-alignment-inventory.md index 264191655b..f243eef4e6 100644 --- a/docs/astryx-alignment-inventory.md +++ b/docs/astryx-alignment-inventory.md @@ -1,3 +1,15 @@ +--- +doc_id: astryx-alignment-inventory +title: "Astryx alignment inventory" +language: en +source_language: en +implementation_status: current +document_status: current +translation_status: source-only +last_verified: 2026-09-04 +owners: + - maka-backend +---