From 76588b274cdfc5054ef1f7ca63e743e800bd0bcb Mon Sep 17 00:00:00 2001
From: ggbdpq <ggbdpq@gmail.com>
Date: Sat, 5 Sep 2026 00:29:31 +0800
Subject: [PATCH] docs(architecture): audit CLI and distribution group against
 implementation

Audit the five CLI and distribution documents from the #3522
documentation audit against the current implementation (22715e84f).

No drift found in any of the five. Highlights of what was verified:

- cli-distribution.md: every named enforcement artifact exists
  (scripts/product-release-identity.mjs with the RELEASE.json identity
  fields, .github/workflows/release.yml, DISCLAIMER-WIP); the archive
  layout names are packaging-time outputs as the document describes.
- cli-npm-release.md + zh-CN: the workflow filenames resolve
  (npm-publication.yml, desktop-nightly.yml, release-cli-stage.yml,
  release-cli-finalize.yml), and the pair stays in lockstep on the
  Trusted Publisher / OIDC / 2FA / Finalize flow.
- windows-support.md: the installer name matches
  scripts/desktop-release-targets.mjs (`Maka-${version}-win-x64.exe`);
  the AppContainer filesystem-worker claim matches the tree; tracking
  issue #2142 is open as stated.
- windows-test-inventory.md: `npm run windows:inventory` (the repo's
  own check) passes with "Windows test skip inventory is current
  (76 declarations)".

The four hand-maintained documents gained the standard frontmatter
block with `last_verified` (the npm-release pair keeps
`translation_status: synced`). windows-test-inventory.md stays
frontmatter-free on purpose: it is generated by
`scripts/windows-test-inventory.mjs --write`, and its `--check`
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/cli-distribution.md      | 12 ++++++++++++
 docs/cli-npm-release.md       | 12 ++++++++++++
 docs/cli-npm-release.zh-CN.md | 12 ++++++++++++
 docs/windows-support.md       | 12 ++++++++++++
 4 files changed, 48 insertions(+)

diff --git a/docs/cli-distribution.md b/docs/cli-distribution.md
index 9f2655ed05..52a6c37e48 100644
--- a/docs/cli-distribution.md
+++ b/docs/cli-distribution.md
@@ -1,3 +1,15 @@
+---
+doc_id: cli-distribution
+title: "CLI/TUI convenience distribution contract"
+language: en
+source_language: en
+implementation_status: current
+document_status: current
+translation_status: source-only
+last_verified: 2026-09-04
+owners:
+  - maka-backend
+---
 <!--
   Licensed to the Apache Software Foundation (ASF) under one
   or more contributor license agreements.  See the NOTICE file
diff --git a/docs/cli-npm-release.md b/docs/cli-npm-release.md
index 51c7a7ce1c..1b6c7e47ee 100644
--- a/docs/cli-npm-release.md
+++ b/docs/cli-npm-release.md
@@ -1,3 +1,15 @@
+---
+doc_id: cli-npm-release
+title: "CLI npm release"
+language: en
+source_language: en
+implementation_status: current
+document_status: current
+translation_status: synced
+last_verified: 2026-09-04
+owners:
+  - maka-backend
+---
 <!--
   Licensed to the Apache Software Foundation (ASF) under one
   or more contributor license agreements.  See the NOTICE file
diff --git a/docs/cli-npm-release.zh-CN.md b/docs/cli-npm-release.zh-CN.md
index 93b22e552a..4806f54eed 100644
--- a/docs/cli-npm-release.zh-CN.md
+++ b/docs/cli-npm-release.zh-CN.md
@@ -1,3 +1,15 @@
+---
+doc_id: cli-npm-release
+title: "CLI npm release"
+language: zh-CN
+source_language: en
+implementation_status: current
+document_status: current
+translation_status: synced
+last_verified: 2026-09-04
+owners:
+  - maka-backend
+---
 <!--
   Licensed to the Apache Software Foundation (ASF) under one
   or more contributor license agreements.  See the NOTICE file
diff --git a/docs/windows-support.md b/docs/windows-support.md
index 9a1dc1d1a0..1501935577 100644
--- a/docs/windows-support.md
+++ b/docs/windows-support.md
@@ -1,3 +1,15 @@
+---
+doc_id: windows-support
+title: "Windows support baseline"
+language: en
+source_language: en
+implementation_status: current
+document_status: current
+translation_status: source-only
+last_verified: 2026-09-04
+owners:
+  - maka-backend
+---
 <!--
   Licensed to the Apache Software Foundation (ASF) under one
   or more contributor license agreements.  See the NOTICE file