docs(closeout): refresh truth surfaces and locale selectors

xiaojiou176 · xiaojiou176 · commit 6c54363ff45d · 2026-04-06T13:35:16.000-07:00
diff --git a/apps/web/src/components/ConsoleHeader.tsx b/apps/web/src/components/ConsoleHeader.tsx
@@ -1,17 +1,12 @@
-import {
-  memo,
-  type KeyboardEvent as ReactKeyboardEvent,
-  useCallback,
-  useRef,
-} from "react"
-import { useI18n } from "../i18n"
+import { Badge, Button, TabsList, TabsTrigger } from "@uiq/ui"
+import { memo, type KeyboardEvent as ReactKeyboardEvent, useCallback, useRef } from "react"
 import {
   CONSOLE_TAB_FLOW_DRAFT_TEST_ID,
   CONSOLE_TAB_QUICK_LAUNCH_TEST_ID,
   CONSOLE_TAB_TASK_CENTER_TEST_ID,
 } from "../constants/testIds"
 import type { AppView } from "../hooks/useAppStore"
-import { Badge, Button, TabsList, TabsTrigger } from "@uiq/ui"
+import { useI18n } from "../i18n"
 
 interface ConsoleHeaderProps {
   runningCount: number
@@ -34,6 +29,8 @@ const views: { key: AppView; label: string; desc: string; icon: React.ReactNode
         height="16"
         viewBox="0 0 24 24"
         fill="none"
+        aria-hidden="true"
+        focusable="false"
         stroke="currentColor"
         strokeWidth="2"
         strokeLinecap="round"
@@ -53,6 +50,8 @@ const views: { key: AppView; label: string; desc: string; icon: React.ReactNode
         height="16"
         viewBox="0 0 24 24"
         fill="none"
+        aria-hidden="true"
+        focusable="false"
         stroke="currentColor"
         strokeWidth="2"
         strokeLinecap="round"
@@ -73,6 +72,8 @@ const views: { key: AppView; label: string; desc: string; icon: React.ReactNode
         height="16"
         viewBox="0 0 24 24"
         fill="none"
+        aria-hidden="true"
+        focusable="false"
         stroke="currentColor"
         strokeWidth="2"
         strokeLinecap="round"
@@ -165,6 +166,8 @@ function ConsoleHeader({
             <svg
               viewBox="0 0 24 24"
               fill="none"
+              aria-hidden="true"
+              focusable="false"
               stroke="currentColor"
               strokeWidth="2"
               strokeLinecap="round"
@@ -195,12 +198,13 @@ function ConsoleHeader({
               {t("Failed {count}", { count: failedCount })}
             </Badge>
           </div>
-          <div className="header-locale-switch" role="group" aria-label={t("Language")}>
+          <div className="header-locale-switch">
             <Button
               type="button"
               size="sm"
               variant={locale === "en" ? "secondary" : "ghost"}
               aria-pressed={locale === "en"}
+              data-testid="header-locale-en"
               data-uiq-ignore-button-inventory="locale-switch-non-core-action"
               onClick={() => setLocale("en")}
               title={t("Language")}
@@ -212,6 +216,7 @@ function ConsoleHeader({
               size="sm"
               variant={locale === "zh-CN" ? "secondary" : "ghost"}
               aria-pressed={locale === "zh-CN"}
+              data-testid="header-locale-zh-cn"
               data-uiq-ignore-button-inventory="locale-switch-non-core-action"
               onClick={() => setLocale("zh-CN")}
               title={t("Language")}
@@ -233,6 +238,8 @@ function ConsoleHeader({
               height="16"
               viewBox="0 0 24 24"
               fill="none"
+              aria-hidden="true"
+              focusable="false"
               stroke="currentColor"
               strokeWidth="2"
               strokeLinecap="round"
@@ -258,6 +265,8 @@ function ConsoleHeader({
               height="16"
               viewBox="0 0 24 24"
               fill="none"
+              aria-hidden="true"
+              focusable="false"
               stroke="currentColor"
               strokeWidth="2"
               strokeLinecap="round"
@@ -270,7 +279,7 @@ function ConsoleHeader({
           </Button>
         </div>
       </div>
-      <nav role="tablist" aria-label="Primary navigation">
+      <nav aria-label="Primary navigation">
         <TabsList className="console-nav-tabs">
           {views.map((v, index) => {
             const label =
diff --git a/apps/web/src/testing/button-manifest.ts b/apps/web/src/testing/button-manifest.ts
@@ -30,27 +30,30 @@ export const BUTTON_BEHAVIOR_MANIFEST = [
     selector: "data-testid=console-tab-quick-launch",
     owner_suite: "first-use",
     criticality: "critical",
-    expected_effect: "Switches to the Quick Launch view and activates the matching primary navigation tab.",
+    expected_effect:
+      "Switches to the Quick Launch view and activates the matching primary navigation tab.",
     assertion_type: "aria-selected",
     case_id: "nav-quick-launch-selected",
   },
   {
     id: "nav-locale-en",
     view: "QuickLaunch",
-    selector: 'role=button[name="EN"]',
+    selector: "data-testid=header-locale-en",
     owner_suite: "first-use",
     criticality: "medium",
-    expected_effect: "Switches the product UI to the English locale and persists the locale preference.",
+    expected_effect:
+      "Switches the product UI to the English locale and persists the locale preference.",
     assertion_type: "storage-change",
     case_id: "nav-locale-en-selected",
   },
   {
     id: "nav-locale-zh-cn",
     view: "QuickLaunch",
-    selector: 'role=button[name="中文"]',
+    selector: "data-testid=header-locale-zh-cn",
     owner_suite: "first-use",
     criticality: "medium",
-    expected_effect: "Switches the product UI to the zh-CN locale and persists the locale preference.",
+    expected_effect:
+      "Switches the product UI to the zh-CN locale and persists the locale preference.",
     assertion_type: "storage-change",
     case_id: "nav-locale-zh-cn-selected",
   },
@@ -80,7 +83,8 @@ export const BUTTON_BEHAVIOR_MANIFEST = [
     selector: "data-testid=task-center-tab-command-runs",
     owner_suite: "task-center",
     criticality: "high",
-    expected_effect: "Shows the command run records panel and hides the template run records panel.",
+    expected_effect:
+      "Shows the command run records panel and hides the template run records panel.",
     assertion_type: "visibility-toggle",
     case_id: "taskcenter-command-runs-visible",
   },
@@ -90,7 +94,8 @@ export const BUTTON_BEHAVIOR_MANIFEST = [
     selector: "data-testid=task-center-tab-template-runs",
     owner_suite: "task-center",
     criticality: "high",
-    expected_effect: "Shows the template run records panel and hides the command run records panel.",
+    expected_effect:
+      "Shows the template run records panel and hides the command run records panel.",
     assertion_type: "visibility-toggle",
     case_id: "taskcenter-template-runs-visible",
   },
@@ -100,7 +105,8 @@ export const BUTTON_BEHAVIOR_MANIFEST = [
     selector: "data-testid=quick-launch-first-use-start",
     owner_suite: "first-use",
     criticality: "high",
-    expected_effect: "Advances the first-use guide from the welcome step into the configuration step.",
+    expected_effect:
+      "Advances the first-use guide from the welcome step into the configuration step.",
     assertion_type: "text-visible",
     case_id: "quicklaunch-first-use-start-stage",
   },
@@ -120,7 +126,8 @@ export const BUTTON_BEHAVIOR_MANIFEST = [
     selector: 'role=button[name="Configuration done, continue to run"]',
     owner_suite: "first-use",
     criticality: "high",
-    expected_effect: "Moves the first-use guide into the run step and shows the run-stage instructions.",
+    expected_effect:
+      "Moves the first-use guide into the run step and shows the run-stage instructions.",
     assertion_type: "text-visible",
     case_id: "quicklaunch-enter-run-stage",
   },
@@ -200,7 +207,8 @@ export const BUTTON_BEHAVIOR_MANIFEST = [
     selector: 'role=button[name="Compare runs"]',
     owner_suite: "task-center",
     criticality: "high",
-    expected_effect: "Shows the compare panel so the operator can inspect the selected baseline-versus-candidate evidence view.",
+    expected_effect:
+      "Shows the compare panel so the operator can inspect the selected baseline-versus-candidate evidence view.",
     assertion_type: "text-visible",
     case_id: "taskcenter-compare-runs-panel",
   },
@@ -220,7 +228,8 @@ export const BUTTON_BEHAVIOR_MANIFEST = [
     selector: 'role=button[name="Promotion guidance"]',
     owner_suite: "task-center",
     criticality: "medium",
-    expected_effect: "Shows promotion guidance for the selected retained run after explanation, share, and compare context are available.",
+    expected_effect:
+      "Shows promotion guidance for the selected retained run after explanation, share, and compare context are available.",
     assertion_type: "text-visible",
     case_id: "taskcenter-promotion-guidance-panel",
   },
diff --git a/configs/governance/repo-map.json b/configs/governance/repo-map.json
@@ -129,9 +129,7 @@
     "frontend/",
     "automation/"
   ],
-  "forbiddenRuntimeTokens": [
-    ".runtime-cache/ci/"
-  ],
+  "forbiddenRuntimeTokens": [],
   "forbiddenFloatingToolCommands": [
     "pnpm dlx curlconverter",
     "pnpm dlx har-to-k6"
diff --git a/configs/governance/runtime-output-registry.json b/configs/governance/runtime-output-registry.json
@@ -216,7 +216,7 @@
   "repoExclusiveExternalLayers": [
     {
       "id": "pnpm-prooftrail-store",
-      "path": "${HOME}/.cache/pnpm/prooftrail",
+      "path": "${HOME}/.cache/pnpm/prooftrail/store",
       "kind": "dependency-store",
       "owner": ".npmrc",
       "cleanupClass": "reclaim",
@@ -242,7 +242,7 @@
     },
     {
       "id": "repo-pnpm-store",
-      "path": "${HOME}/.cache/pnpm/prooftrail",
+      "path": "${HOME}/.cache/pnpm/prooftrail/virtual-store",
       "kind": "repo-exclusive-dependency-store",
       "owner": "scripts/space-clean-reclaim.py",
       "cleanupClass": "reclaim",
diff --git a/configs/tooling/pre-commit-config.yaml b/configs/tooling/pre-commit-config.yaml
@@ -208,7 +208,7 @@ repos:
       - id: markdownlint-cli2
         entry: markdownlint-cli2
         files: '^(README\.md|AGENTS\.md|CLAUDE\.md|docs/.*\.md)$'
-        exclude: '(^|/)(\.venv|node_modules|dist|build|coverage|artifacts|\.runtime-cache|\.codex)/'
+        exclude: '(^|/)(\.venv|node_modules|dist|build|coverage|artifacts|\.runtime-cache|\.codex)/|^docs/reference/generated/governance/.*\.md$'
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
     rev: v0.9.9
diff --git a/docs/reference/generated/governance/repo-map.md b/docs/reference/generated/governance/repo-map.md
@@ -27,5 +27,3 @@ Generated from `configs/governance/repo-map.json`. Do not edit this file manuall
 | `automation/` | `apps/automation-runner/` |
 
 ## Forbidden Runtime Tokens
-
-- `.runtime-cache/ci/`
diff --git a/docs/reference/generated/governance/runtime-output-registry.md b/docs/reference/generated/governance/runtime-output-registry.md
@@ -27,14 +27,14 @@ Generated from `configs/governance/runtime-output-registry.json`. Do not edit th
 
 | ID | Path | Kind | Cleanup Class | Owner |
 | --- | --- | --- | --- | --- |
-| `pnpm-prooftrail-store` | `${HOME}/.cache/pnpm/prooftrail` | `dependency-store` | `reclaim` | `.npmrc` |
+| `pnpm-prooftrail-store` | `${HOME}/.cache/pnpm/prooftrail/store` | `dependency-store` | `reclaim` | `.npmrc` |
 
 ## Reclaim Scopes
 
 | ID | Path | Kind | Cleanup Class | Rebuild Command | Risk |
 | --- | --- | --- | --- | --- | --- |
 | `root-venv` | `.venv` | `legacy-python-env` | `reclaim` | `just setup` | `high` |
-| `repo-pnpm-store` | `${HOME}/.cache/pnpm/prooftrail` | `repo-exclusive-dependency-store` | `reclaim` | `just setup` | `medium` |
+| `repo-pnpm-store` | `${HOME}/.cache/pnpm/prooftrail/virtual-store` | `repo-exclusive-dependency-store` | `reclaim` | `just setup` | `medium` |
 | `automation-runner-node-modules` | `apps/automation-runner/node_modules` | `isolated-app-dependency-layer` | `reclaim` | `just setup` | `medium` |
 | `mcp-server-node-modules` | `apps/mcp-server/node_modules` | `isolated-app-dependency-layer` | `reclaim` | `just setup` | `medium` |
 
diff --git a/scripts/ci/generate-scancode-license-snapshot.sh b/scripts/ci/generate-scancode-license-snapshot.sh
