fix(cli): translate metadata panel and welcome screen (cli-3.5.1) (#62)

The 3.5.0 i18n pass covered the navigation tree, status bar, and help
popup but missed two surfaces that stay visible on every session: the
Metadata panel (title plus all field labels) and the Document panel's
welcome screen (panel title plus the "DevTrail Explorer" landing page).

Add ~25 new entries to tui::i18n_strings::t and wire them into both
widgets. Field labels in the Metadata panel are padded to a single
visual-column width (LABEL_WIDTH = 13) so values line up across en, es
(longer words like "Confianza:") and zh-CN (shorter, e.g. "状态:").
Brand and company strings ("DevTrail Explorer", "Strange Days Tech")
stay in their canonical form on purpose.

Frontmatter values themselves remain unchanged — those are authored
content read directly from each markdown file, not UI strings.

Patch bump 3.5.0 → 3.5.1, CHANGELOG entry, and 6 doc files updated.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: montfort

CHANGELOG.md

@@ -7,6 +7,15 @@ and this project uses [independent versioning](README.md#versioning) for Framewo
 
 ---
 
+## CLI 3.5.1 — Metadata Panel and Welcome Screen i18n Coverage
+
+### Fixed (CLI)
+- The Metadata panel (title `Metadata`, the empty-state `No document selected`, and field labels `Status:`, `Created:`, `Agent:`, `Confidence:`, `Risk:`, `Review:`, `Tags:`, `Related:`, plus the `(Enter: search)` / `(Enter: follow)` hints and `⚠ REQUIRED`) now switches with the active language. Field labels are padded to a consistent visual width so values stay aligned across `en` / `es` / `zh-CN`.
+- The Document panel title and welcome screen (`DevTrail Explorer` brand line aside) now translate: `Documentation Governance for AI-Assisted Development`, `Total documents:`, `Quick start`, the keyboard-shortcut descriptions, `Developed by`, and the repo-root fallback notice. Brand and company names stay in their canonical form on purpose.
+- Frontmatter values themselves (status, tags, related IDs, dates) are still read verbatim from each document — they're authored content, not UI strings.
+
+---
+
 ## CLI 3.5.0 — TUI i18n Polish: Translated Shell, Live Switcher, Locale Auto-Detect
 
 Three changes that complete the language-aware `devtrail explore` work started in 3.4.0. Together they make the TUI feel native to non-English users instead of just "translated docs inside an English shell."

README.md

@@ -207,7 +207,7 @@ DevTrail uses independent version tags for each component:
 | Component | Tag prefix | Example | Includes |
 |-----------|-----------|---------|----------|
 | Framework | `fw-` | `fw-4.3.0` | Templates (12 types), governance, directives |
-| CLI | `cli-` | `cli-3.5.0` | The `devtrail` binary |
+| CLI | `cli-` | `cli-3.5.1` | The `devtrail` binary |
 
 Check installed versions with `devtrail status` or `devtrail about`.
 

cli/Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "devtrail-cli"
-version = "3.5.0"
+version = "3.5.1"
 edition = "2021"
 description = "CLI tool for DevTrail - Documentation Governance for AI-Assisted Development"
 license = "MIT"

cli/Cargo.toml

@@ -153,6 +153,80 @@ pub fn t<'a>(en: &'a str, lang: &str) -> &'a str {
         ("Cycle display language", "zh-CN") => "切换显示语言",
         ("Language", "es") => "Idioma",
         ("Language", "zh-CN") => "语言",
+
+        // ── Metadata panel ────────────────────────────────────────────
+        ("Metadata", "es") => "Metadatos",
+        ("Metadata", "zh-CN") => "元数据",
+        ("No document selected", "es") => "Sin documento seleccionado",
+        ("No document selected", "zh-CN") => "未选择文档",
+        ("File:", "es") => "Archivo:",
+        ("File:", "zh-CN") => "文件:",
+        ("No frontmatter", "es") => "Sin frontmatter",
+        ("No frontmatter", "zh-CN") => "无 frontmatter",
+        ("Status:", "es") => "Estado:",
+        ("Status:", "zh-CN") => "状态:",
+        ("Created:", "es") => "Creado:",
+        ("Created:", "zh-CN") => "创建:",
+        ("Agent:", "es") => "Agente:",
+        ("Agent:", "zh-CN") => "代理:",
+        ("Confidence:", "es") => "Confianza:",
+        ("Confidence:", "zh-CN") => "可信度:",
+        ("Risk:", "es") => "Riesgo:",
+        ("Risk:", "zh-CN") => "风险:",
+        ("Review:", "es") => "Revisión:",
+        ("Review:", "zh-CN") => "审查:",
+        ("⚠ REQUIRED", "es") => "⚠ REQUERIDA",
+        ("⚠ REQUIRED", "zh-CN") => "⚠ 需要",
+        ("Tags:", "es") => "Etiquetas:",
+        ("Tags:", "zh-CN") => "标签:",
+        ("Related:", "es") => "Relacionados:",
+        ("Related:", "zh-CN") => "关联:",
+        (" (Enter: search)", "es") => " (Enter: buscar)",
+        (" (Enter: search)", "zh-CN") => "（Enter: 搜索）",
+        (" (Enter: follow)", "es") => " (Enter: seguir)",
+        (" (Enter: follow)", "zh-CN") => "（Enter: 跳转）",
+
+        // ── Document panel ────────────────────────────────────────────
+        ("Document", "es") => "Documento",
+        ("Document", "zh-CN") => "文档",
+
+        // ── Welcome screen (empty doc state) ──────────────────────────
+        ("Documentation Governance for AI-Assisted Development", "es") => {
+            "Gobernanza de documentación para desarrollo asistido por IA"
+        }
+        ("Documentation Governance for AI-Assisted Development", "zh-CN") => {
+            "AI 辅助开发的文档治理"
+        }
+        ("Using repo root: ", "es") => "Usando raíz del repo: ",
+        ("Using repo root: ", "zh-CN") => "使用仓库根目录：",
+        ("Total documents: ", "es") => "Total de documentos: ",
+        ("Total documents: ", "zh-CN") => "文档总数：",
+        ("Quick start", "es") => "Inicio rápido",
+        ("Quick start", "zh-CN") => "快速开始",
+        ("Navigate groups in the left panel", "es") => {
+            "Navega grupos en el panel izquierdo"
+        }
+        ("Navigate groups in the left panel", "zh-CN") => "在左侧面板中导航分组",
+        ("Expand a group and open a document", "es") => {
+            "Expande un grupo y abre un documento"
+        }
+        ("Expand a group and open a document", "zh-CN") => "展开分组并打开文档",
+        ("Next panel / ", "es") => "Panel siguiente / ",
+        ("Next panel / ", "zh-CN") => "下一面板 / ",
+        ("Previous panel", "es") => "Panel anterior",
+        ("Previous panel", "zh-CN") => "上一面板",
+        ("Search by filename, title, tags, or date", "es") => {
+            "Buscar por archivo, título, etiquetas o fecha"
+        }
+        ("Search by filename, title, tags, or date", "zh-CN") => {
+            "按文件名、标题、标签或日期搜索"
+        }
+        ("Toggle document fullscreen", "es") => "Alternar pantalla completa",
+        ("Toggle document fullscreen", "zh-CN") => "切换文档全屏",
+        ("Show all keyboard shortcuts", "es") => "Mostrar todos los atajos",
+        ("Show all keyboard shortcuts", "zh-CN") => "显示所有快捷键",
+        ("Developed by ", "es") => "Desarrollado por ",
+        ("Developed by ", "zh-CN") => "由 ",
         ("Quit", "es") => "Salir",
         ("Quit", "zh-CN") => "退出",
         ("Force quit", "es") => "Forzar salida",

cli/src/tui/i18n_strings.rs

@@ -6,6 +6,7 @@ use ratatui::widgets::{Block, Borders, Paragraph, Scrollbar, ScrollbarOrientatio
 use unicode_width::UnicodeWidthStr;
 
 use crate::tui::app::{ActivePanel, App};
+use crate::tui::i18n_strings::t;
 use crate::tui::markdown::markdown_to_lines;
 use crate::tui::theme;
 
@@ -26,9 +27,10 @@ impl<'a> DocViewer<'a> {
             Style::default().fg(theme::SUBTLE)
         };
 
+        let lang = self.app.language.as_str();
         let title = match &self.app.current_doc {
             Some(doc) => format!(" {} ", doc.filename),
-            None => " Document ".to_string(),
+            None => format!(" {} ", t("Document", lang)),
         };
 
         let block = Block::default()
@@ -53,7 +55,7 @@ impl<'a> DocViewer<'a> {
             } else {
                 None
             };
-            let welcome = render_welcome(self.app.index.total_docs, fallback_info);
+            let welcome = render_welcome(self.app.index.total_docs, fallback_info, lang);
             let paragraph = Paragraph::new(welcome);
             paragraph.render(inner, buf);
             return;
@@ -129,7 +131,11 @@ impl<'a> DocViewer<'a> {
     }
 }
 
-fn render_welcome(total_docs: usize, fallback_path: Option<String>) -> Vec<Line<'static>> {
+fn render_welcome(
+    total_docs: usize,
+    fallback_path: Option<String>,
+    lang: &str,
+) -> Vec<Line<'static>> {
     let title = Style::default()
         .fg(theme::ACCENT)
         .add_modifier(Modifier::BOLD);
@@ -142,69 +148,86 @@ fn render_welcome(total_docs: usize, fallback_path: Option<String>) -> Vec<Line<
     let mut lines = vec![
         Line::from(""),
         Line::from(""),
+        // Brand name stays English in every locale.
         Line::from(Span::styled("  DevTrail Explorer", title)),
         Line::from(Span::styled(
-            "  Documentation Governance for AI-Assisted Development",
+            format!(
+                "  {}",
+                t("Documentation Governance for AI-Assisted Development", lang)
+            ),
             dim,
         )),
     ];
 
     if let Some(ref path) = fallback_path {
         lines.push(Line::from(""));
         lines.push(Line::from(vec![
-            Span::styled("  → Using repo root: ", Style::default().fg(Color::Yellow)),
+            Span::styled(
+                format!("  → {}", t("Using repo root: ", lang)),
+                Style::default().fg(Color::Yellow),
+            ),
             Span::styled(path.clone(), text),
         ]));
     }
 
     lines.push(Line::from(""));
     lines.push(Line::from(vec![
-        Span::styled("  Total documents: ", dim),
+        Span::styled(format!("  {}", t("Total documents: ", lang)), dim),
         Span::styled(
             total_docs.to_string(),
             text.add_modifier(Modifier::BOLD),
         ),
     ]));
     lines.push(Line::from(""));
-    lines.push(Line::from(Span::styled("  Quick start", title)));
+    lines.push(Line::from(Span::styled(
+        format!("  {}", t("Quick start", lang)),
+        title,
+    )));
     lines.push(Line::from(""));
     lines.push(Line::from(vec![
         Span::styled("    ↑↓ ", key),
-        Span::styled("Navigate groups in the left panel", text),
+        Span::styled(t("Navigate groups in the left panel", lang).to_string(), text),
     ]));
     lines.push(Line::from(vec![
         Span::styled("  Enter ", key),
-        Span::styled("Expand a group and open a document", text),
+        Span::styled(
+            t("Expand a group and open a document", lang).to_string(),
+            text,
+        ),
     ]));
     lines.push(Line::from(vec![
         Span::styled("   Tab  ", key),
-        Span::styled("Next panel / ", text),
+        Span::styled(t("Next panel / ", lang).to_string(), text),
         Span::styled("Shift+Tab  ", key),
-        Span::styled("Previous panel", text),
+        Span::styled(t("Previous panel", lang).to_string(), text),
     ]));
     lines.push(Line::from(vec![
         Span::styled("     /  ", key),
-        Span::styled("Search by filename, title, tags, or date", text),
+        Span::styled(
+            t("Search by filename, title, tags, or date", lang).to_string(),
+            text,
+        ),
     ]));
     lines.push(Line::from(vec![
         Span::styled("     f  ", key),
-        Span::styled("Toggle document fullscreen", text),
+        Span::styled(t("Toggle document fullscreen", lang).to_string(), text),
     ]));
     lines.push(Line::from(vec![
         Span::styled("     ?  ", key),
-        Span::styled("Show all keyboard shortcuts", text),
+        Span::styled(t("Show all keyboard shortcuts", lang).to_string(), text),
     ]));
     lines.push(Line::from(vec![
         Span::styled("     q  ", key),
-        Span::styled("Quit", text),
+        Span::styled(t("Quit", lang).to_string(), text),
     ]));
     lines.push(Line::from(""));
     lines.push(Line::from(Span::styled(
         "  ─────────────────────────────────────────────",
         dim,
     )));
     lines.push(Line::from(vec![
-        Span::styled("  Developed by ", dim),
+        Span::styled(format!("  {}", t("Developed by ", lang)), dim),
+        // Company name stays in its canonical form.
         Span::styled("Strange Days Tech, S.A.S.", text),
     ]));
     lines.push(Line::from(vec![