chore: bump Framework to 4.2.0 and CLI to 3.2.0 (#48)

montfort · claude · web-flow · commit b380b9768190 · 2026-04-04T18:28:27.000-06:00
Version bump for the Simplified Chinese (zh-CN) localization release.

Co-authored-by: Claude Opus 4.6 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/.github/workflows/release-cli.yml b/.github/workflows/release-cli.yml
@@ -8,7 +8,7 @@ on:
   workflow_dispatch:
     inputs:
       tag:
-        description: 'Release tag (e.g., cli-3.0.0)'
+        description: 'Release tag (e.g., cli-3.2.0)'
         required: true
 
 permissions:
diff --git a/.github/workflows/release-framework.yml b/.github/workflows/release-framework.yml
@@ -7,7 +7,7 @@ on:
   workflow_dispatch:
     inputs:
       tag:
-        description: 'Release tag (e.g., fw-4.1.1)'
+        description: 'Release tag (e.g., fw-4.2.0)'
         required: true
 
 permissions:
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -7,6 +7,24 @@ and this project uses [independent versioning](README.md#versioning) for Framewo
 
 ---
 
+## Framework 4.2.0 / CLI 3.2.0 — Simplified Chinese (zh-CN) Localization
+
+### Added (Framework)
+- **Simplified Chinese (zh-CN)**: Complete localization as the third supported language alongside English and Spanish
+  - 12 document templates (AILOG, ADR, AIDEC, DPIA, ETH, INC, MCARD, REQ, SBOM, SEC, TDE, TES)
+  - 12 governance documents (AGENT-RULES, AI-GOVERNANCE-POLICY, AI-KPIS, AI-LIFECYCLE-TRACKER, AI-RISK-CATALOG, C4-DIAGRAM-GUIDE, DOCUMENTATION-POLICY, GIT-BRANCHING-STRATEGY, MANAGEMENT-REVIEW-TEMPLATE, OBSERVABILITY-GUIDE, PRINCIPLES, QUICK-REFERENCE)
+  - 5 NIST implementation guides (AI RMF Govern/Map/Measure/Manage + GenAI Risks)
+  - 6 user-facing docs (README, CONTRIBUTING, CODE_OF_CONDUCT, ADOPTION-GUIDE, CLI-REFERENCE, WORKFLOWS)
+
+### Added (CLI)
+- **Generic language support**: Template resolution now supports any configured language, not just hardcoded `es`
+
+### Changed (Framework)
+- Language navigation links updated across all three languages (EN, ES, zh-CN) in governance and documentation files
+- Language navigation links added to English governance files (PRINCIPLES, DOCUMENTATION-POLICY, AGENT-RULES) that previously lacked them
+
+---
+
 ## CLI 3.1.1 — crates.io README Fix
 
 ### Fixed (CLI)
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -42,8 +42,8 @@ DevTrail uses **independent versions** for framework and CLI:
 
 | Component | Tag format | Current | Example |
 |-----------|-----------|---------|---------|
-| Framework | `fw-X.Y.Z` | fw-4.1.1 | `fw-4.1.1` |
-| CLI | `cli-X.Y.Z` | cli-3.1.1 | `cli-3.1.1` |
+| Framework | `fw-X.Y.Z` | fw-4.2.0 | `fw-4.2.0` |
+| CLI | `cli-X.Y.Z` | cli-3.2.0 | `cli-3.2.0` |
 
 Follow [semver](https://semver.org/):
 - **Major**: breaking changes
diff --git a/README.md b/README.md
@@ -149,8 +149,8 @@ DevTrail uses independent version tags for each component:
 
 | Component | Tag prefix | Example | Includes |
 |-----------|-----------|---------|----------|
-| Framework | `fw-` | `fw-4.1.1` | Templates (12 types), governance, directives |
-| CLI | `cli-` | `cli-3.1.1` | The `devtrail` binary |
+| Framework | `fw-` | `fw-4.2.0` | Templates (12 types), governance, directives |
+| CLI | `cli-` | `cli-3.2.0` | The `devtrail` binary |
 
 Check installed versions with `devtrail status` or `devtrail about`.
 
@@ -180,7 +180,7 @@ See [CLI Reference](docs/adopters/CLI-REFERENCE.md) for detailed usage.
 ```bash
 # Download the latest framework release ZIP from GitHub
 # Go to https://github.com/StrangeDaysTech/devtrail/releases
-# and download the latest fw-* release (e.g., fw-4.1.1)
+# and download the latest fw-* release (e.g., fw-4.2.0)
 
 # Extract and copy to your project
 unzip devtrail-fw-*.zip -d your-project/
diff --git a/cli/Cargo.lock b/cli/Cargo.lock
diff --git a/cli/Cargo.toml b/cli/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "devtrail-cli"
-version = "3.1.1"
+version = "3.2.0"
 edition = "2021"
 description = "CLI tool for DevTrail - Documentation Governance for AI-Assisted Development"
 license = "MIT"
diff --git a/dist/.devtrail/00-governance/AGENT-RULES.md b/dist/.devtrail/00-governance/AGENT-RULES.md
@@ -270,4 +270,4 @@ When a change modifies API endpoints:
 
 ---
 
-*DevTrail v4.1.1 | [Strange Days Tech](https://strangedays.tech)*
+*DevTrail v4.2.0 | [Strange Days Tech](https://strangedays.tech)*
diff --git a/dist/.devtrail/00-governance/C4-DIAGRAM-GUIDE.md b/dist/.devtrail/00-governance/C4-DIAGRAM-GUIDE.md
@@ -234,4 +234,4 @@ Use a Level 1 (Context) diagram to illustrate:
 
 ---
 
-*DevTrail v4.1.1 | [Strange Days Tech](https://strangedays.tech)*
+*DevTrail v4.2.0 | [Strange Days Tech](https://strangedays.tech)*
diff --git a/dist/.devtrail/00-governance/DOCUMENTATION-POLICY.md b/dist/.devtrail/00-governance/DOCUMENTATION-POLICY.md
@@ -249,4 +249,4 @@ See also [ADR-2025-01-20-001] for architectural context.
 
 ---
 
-*DevTrail v4.1.1 | [Strange Days Tech](https://strangedays.tech)*
+*DevTrail v4.2.0 | [Strange Days Tech](https://strangedays.tech)*
diff --git a/dist/.devtrail/00-governance/QUICK-REFERENCE.md b/dist/.devtrail/00-governance/QUICK-REFERENCE.md
@@ -188,4 +188,4 @@ Mark `review_required: true` when:
 
 ---
 
-*DevTrail v4.1.1 | [Strange Days Tech](https://strangedays.tech)*
+*DevTrail v4.2.0 | [Strange Days Tech](https://strangedays.tech)*
diff --git a/dist/.devtrail/00-governance/i18n/es/AGENT-RULES.md b/dist/.devtrail/00-governance/i18n/es/AGENT-RULES.md
@@ -270,4 +270,4 @@ Cuando un cambio modifica endpoints de API:
 
 ---
 
-*DevTrail v4.1.1 | [Strange Days Tech](https://strangedays.tech)*
+*DevTrail v4.2.0 | [Strange Days Tech](https://strangedays.tech)*
diff --git a/dist/.devtrail/00-governance/i18n/es/C4-DIAGRAM-GUIDE.md b/dist/.devtrail/00-governance/i18n/es/C4-DIAGRAM-GUIDE.md
@@ -234,4 +234,4 @@ Usar un diagrama de Nivel 1 (Contexto) para ilustrar:
 
 ---
 
-*DevTrail v4.1.1 | [Strange Days Tech](https://strangedays.tech)*
+*DevTrail v4.2.0 | [Strange Days Tech](https://strangedays.tech)*
diff --git a/dist/.devtrail/00-governance/i18n/es/DOCUMENTATION-POLICY.md b/dist/.devtrail/00-governance/i18n/es/DOCUMENTATION-POLICY.md
@@ -249,4 +249,4 @@ Ver también [ADR-2025-01-20-001] para contexto arquitectónico.
 
 ---
 
-*DevTrail v4.1.1 | [Strange Days Tech](https://strangedays.tech)*
+*DevTrail v4.2.0 | [Strange Days Tech](https://strangedays.tech)*
diff --git a/dist/.devtrail/00-governance/i18n/es/QUICK-REFERENCE.md b/dist/.devtrail/00-governance/i18n/es/QUICK-REFERENCE.md
@@ -188,4 +188,4 @@ Marcar `review_required: true` cuando:
 
 ---
 
-*DevTrail v4.1.1 | [Strange Days Tech](https://strangedays.tech)*
+*DevTrail v4.2.0 | [Strange Days Tech](https://strangedays.tech)*
diff --git a/dist/.devtrail/00-governance/i18n/zh-CN/AGENT-RULES.md b/dist/.devtrail/00-governance/i18n/zh-CN/AGENT-RULES.md
@@ -270,4 +270,4 @@ confidence: high | medium | low
 
 ---
 
-*DevTrail v4.1.1 | [Strange Days Tech](https://strangedays.tech)*
+*DevTrail v4.2.0 | [Strange Days Tech](https://strangedays.tech)*
diff --git a/dist/.devtrail/00-governance/i18n/zh-CN/C4-DIAGRAM-GUIDE.md b/dist/.devtrail/00-governance/i18n/zh-CN/C4-DIAGRAM-GUIDE.md
@@ -234,4 +234,4 @@ Rel(api, db, "Reads/Writes", "SQL")
 
 ---
 
-*DevTrail v4.1.1 | [Strange Days Tech](https://strangedays.tech)*
+*DevTrail v4.2.0 | [Strange Days Tech](https://strangedays.tech)*
diff --git a/dist/.devtrail/00-governance/i18n/zh-CN/DOCUMENTATION-POLICY.md b/dist/.devtrail/00-governance/i18n/zh-CN/DOCUMENTATION-POLICY.md
@@ -249,4 +249,4 @@ draft ──────► accepted ──────► deprecated
 
 ---
 
-*DevTrail v4.1.1 | [Strange Days Tech](https://strangedays.tech)*
+*DevTrail v4.2.0 | [Strange Days Tech](https://strangedays.tech)*
diff --git a/dist/.devtrail/00-governance/i18n/zh-CN/QUICK-REFERENCE.md b/dist/.devtrail/00-governance/i18n/zh-CN/QUICK-REFERENCE.md
@@ -188,4 +188,4 @@ risk_level: low | medium | high | critical
 
 ---
 
-*DevTrail v4.1.1 | [Strange Days Tech](https://strangedays.tech)*
+*DevTrail v4.2.0 | [Strange Days Tech](https://strangedays.tech)*
diff --git a/dist/.devtrail/QUICK-REFERENCE.md b/dist/.devtrail/QUICK-REFERENCE.md
@@ -168,4 +168,4 @@ Mark `review_required: true` when:
 
 ---
 
-*DevTrail v4.1.1 | [GitHub](https://github.com/StrangeDaysTech/devtrail) | [Strange Days Tech](https://strangedays.tech)*
+*DevTrail v4.2.0 | [GitHub](https://github.com/StrangeDaysTech/devtrail) | [Strange Days Tech](https://strangedays.tech)*
diff --git a/dist/dist-manifest.yml b/dist/dist-manifest.yml
@@ -1,4 +1,4 @@
-version: "4.1.1"
+version: "4.2.0"
 description: "DevTrail distribution manifest"
 repository: "https://github.com/StrangeDaysTech/devtrail"
 
diff --git a/docs/adopters/ADOPTION-GUIDE.md b/docs/adopters/ADOPTION-GUIDE.md
@@ -213,7 +213,7 @@ The CLI automatically:
 
 1. **Download the latest release**
 
-   Go to [GitHub Releases](https://github.com/StrangeDaysTech/devtrail/releases) and download the latest `fw-*` release ZIP (e.g., `fw-4.1.1`).
+   Go to [GitHub Releases](https://github.com/StrangeDaysTech/devtrail/releases) and download the latest `fw-*` release ZIP (e.g., `fw-4.2.0`).
 
 2. **Extract to your project**
    ```bash
diff --git a/docs/adopters/CLI-REFERENCE.md b/docs/adopters/CLI-REFERENCE.md
@@ -48,8 +48,8 @@ DevTrail uses **independent version tags** for each component:
 
 | Component | Tag prefix | Example | What it includes |
 |-----------|-----------|---------|------------------|
-| Framework | `fw-` | `fw-4.1.1` | Templates (12 types), governance docs, directives |
-| CLI | `cli-` | `cli-3.1.1` | The `devtrail` binary |
+| Framework | `fw-` | `fw-4.2.0` | Templates (12 types), governance docs, directives |
+| CLI | `cli-` | `cli-3.2.0` | The `devtrail` binary |
 
 Framework and CLI are released independently. A framework update does not require a CLI update, and vice versa.
 
@@ -86,7 +86,7 @@ Initialize DevTrail in a project directory.
 
 ```bash
 $ devtrail init .
-✔ Downloaded DevTrail fw-4.1.1
+✔ Downloaded DevTrail fw-4.2.0
 ✔ Created .devtrail/ directory structure
 ✔ Created DEVTRAIL.md
 ✔ Configured AI agent directives
@@ -108,9 +108,9 @@ If `.devtrail/` does not exist in the current directory, the framework update is
 ```bash
 $ devtrail update
 Updating framework...
-✔ Framework updated to fw-4.1.1
+✔ Framework updated to fw-4.2.0
 Updating CLI...
-✔ CLI updated to cli-3.1.1
+✔ CLI updated to cli-3.2.0
 ```
 
 ---
@@ -125,7 +125,7 @@ Update only the framework files. Looks for the latest `fw-*` release on GitHub.
 
 ```bash
 $ devtrail update-framework
-✔ Framework updated to fw-4.1.1
+✔ Framework updated to fw-4.2.0
 ```
 
 ---
@@ -143,11 +143,11 @@ Use `--method` to override auto-detection: `--method=github` or `--method=cargo`
 
 ```bash
 $ devtrail update-cli
-✔ CLI updated to cli-3.1.1
+✔ CLI updated to cli-3.2.0
 
 $ devtrail update-cli --method=cargo
 Compiling from source, this may take a few minutes...
-✔ CLI updated to cli-3.1.1
+✔ CLI updated to cli-3.2.0
 ```
 
 ---
@@ -209,8 +209,8 @@ $ devtrail status
   Project
   ┌───────────┬──────────────────────────┐
   │ Path      │ /home/user/my-project    │
-  │ Framework │ fw-4.1.1                 │
-  │ CLI       │ cli-3.1.1                │
+  │ Framework │ fw-4.2.0                 │
+  │ CLI       │ cli-3.2.0                │
   │ Language  │ en                       │
   └───────────┴──────────────────────────┘
 
@@ -266,7 +266,7 @@ Repairing DevTrail in /home/user/my-project
 → Restoring 1 missing directory...
 ✓ Restored .devtrail/templates/
 → Downloading framework to restore missing files...
-  Using version: fw-4.1.1
+  Using version: fw-4.2.0
 ✓ Restored 16 file(s) from framework
 → Updating checksums...
 
@@ -634,8 +634,8 @@ Show version, authorship, and license information.
 ```bash
 $ devtrail about
 DevTrail CLI
-  CLI version:       cli-3.1.1
-  Framework version: fw-4.1.1
+  CLI version:       cli-3.2.0
+  Framework version: fw-4.2.0
   Author:            Strange Days Tech, S.A.S.
   License:           MIT
   Repository:        https://github.com/StrangeDaysTech/devtrail
diff --git a/docs/i18n/es/README.md b/docs/i18n/es/README.md
@@ -149,8 +149,8 @@ DevTrail usa tags de versión independientes para cada componente:
 
 | Componente | Prefijo de tag | Ejemplo | Incluye |
 |------------|---------------|---------|---------|
-| Framework | `fw-` | `fw-4.1.1` | Plantillas (12 tipos), gobernanza, directivas |
-| CLI | `cli-` | `cli-3.1.1` | El binario `devtrail` |
+| Framework | `fw-` | `fw-4.2.0` | Plantillas (12 tipos), gobernanza, directivas |
+| CLI | `cli-` | `cli-3.2.0` | El binario `devtrail` |
 
 Verifica las versiones instaladas con `devtrail status` o `devtrail about`.
 
@@ -180,7 +180,7 @@ Ver [Referencia CLI](adopters/CLI-REFERENCE.md) para uso detallado.
 ```bash
 # Descargar el último release ZIP del framework desde GitHub
 # Ve a https://github.com/StrangeDaysTech/devtrail/releases
-# y descarga el último release fw-* (ej. fw-4.1.1)
+# y descarga el último release fw-* (ej. fw-4.2.0)
 
 # Extraer y copiar a tu proyecto
 unzip devtrail-fw-*.zip -d tu-proyecto/
diff --git a/docs/i18n/es/adopters/ADOPTION-GUIDE.md b/docs/i18n/es/adopters/ADOPTION-GUIDE.md
@@ -204,7 +204,7 @@ El CLI automáticamente:
 
 1. **Descargar el último release**
 
-   Ve a [GitHub Releases](https://github.com/StrangeDaysTech/devtrail/releases) y descarga el último release `fw-*` (ej. `fw-4.1.1`).
+   Ve a [GitHub Releases](https://github.com/StrangeDaysTech/devtrail/releases) y descarga el último release `fw-*` (ej. `fw-4.2.0`).
 
 2. **Extraer en tu proyecto**
    ```bash
diff --git a/docs/i18n/es/adopters/CLI-REFERENCE.md b/docs/i18n/es/adopters/CLI-REFERENCE.md
@@ -48,8 +48,8 @@ DevTrail usa **tags de versión independientes** para cada componente:
 
 | Componente | Prefijo de tag | Ejemplo | Qué incluye |
 |------------|---------------|---------|-------------|
-| Framework | `fw-` | `fw-4.1.1` | Plantillas (12 tipos), docs de gobernanza, directivas |
-| CLI | `cli-` | `cli-3.1.1` | El binario `devtrail` |
+| Framework | `fw-` | `fw-4.2.0` | Plantillas (12 tipos), docs de gobernanza, directivas |
+| CLI | `cli-` | `cli-3.2.0` | El binario `devtrail` |
 
 Framework y CLI se publican de forma independiente. Una actualización del framework no requiere actualización del CLI, y viceversa.
 
@@ -86,7 +86,7 @@ Inicializa DevTrail en un directorio de proyecto.
 
 ```bash
 $ devtrail init .
-✔ Downloaded DevTrail fw-4.1.1
+✔ Downloaded DevTrail fw-4.2.0
 ✔ Created .devtrail/ directory structure
 ✔ Created DEVTRAIL.md
 ✔ Configured AI agent directives
@@ -107,9 +107,9 @@ Si `.devtrail/` no existe en el directorio actual, la actualización del framewo
 ```bash
 $ devtrail update
 Updating framework...
-✔ Framework updated to fw-4.1.1
+✔ Framework updated to fw-4.2.0
 Updating CLI...
-✔ CLI updated to cli-3.1.1
+✔ CLI updated to cli-3.2.0
 ```
 
 ---
@@ -124,7 +124,7 @@ Actualiza solo los archivos del framework. Busca el último release `fw-*` en Gi
 
 ```bash
 $ devtrail update-framework
-✔ Framework updated to fw-4.1.1
+✔ Framework updated to fw-4.2.0
 ```
 
 ---
@@ -142,11 +142,11 @@ Usa `--method` para forzar el método: `--method=github` o `--method=cargo`.
 
 ```bash
 $ devtrail update-cli
-✔ CLI updated to cli-3.1.1
+✔ CLI updated to cli-3.2.0
 
 $ devtrail update-cli --method=cargo
 Compiling from source, this may take a few minutes...
-✔ CLI updated to cli-3.1.1
+✔ CLI updated to cli-3.2.0
 ```
 
 ---
@@ -203,8 +203,8 @@ $ devtrail status
 DevTrail Status
 ───────────────
 Path:              /home/user/my-project
-Framework version: fw-4.1.1
-CLI version:       cli-3.1.1
+Framework version: fw-4.2.0
+CLI version:       cli-3.2.0
 Language:          en
 Structure:         ✔ Complete
 
@@ -513,8 +513,8 @@ Muestra información de versión, autoría y licencia.
 ```bash
 $ devtrail about
 DevTrail CLI
-  CLI version:       cli-3.1.1
-  Framework version: fw-4.1.1
+  CLI version:       cli-3.2.0
+  Framework version: fw-4.2.0
   Author:            Strange Days Tech, S.A.S.
   License:           MIT
   Repository:        https://github.com/StrangeDaysTech/devtrail
diff --git a/docs/i18n/zh-CN/README.md b/docs/i18n/zh-CN/README.md
@@ -149,8 +149,8 @@ DevTrail 为每个组件使用独立的版本标签：
 
 | 组件 | 标签前缀 | 示例 | 包含内容 |
 |------|----------|------|----------|
-| Framework | `fw-` | `fw-4.1.1` | 模板（12 种类型）、治理文档、指令 |
-| CLI | `cli-` | `cli-3.1.1` | `devtrail` 二进制文件 |
+| Framework | `fw-` | `fw-4.2.0` | 模板（12 种类型）、治理文档、指令 |
+| CLI | `cli-` | `cli-3.2.0` | `devtrail` 二进制文件 |
 
 使用 `devtrail status` 或 `devtrail about` 查看已安装的版本。
 
@@ -180,7 +180,7 @@ DevTrail 为每个组件使用独立的版本标签：
 ```bash
 # 从 GitHub 下载最新的框架发布 ZIP
 # 前往 https://github.com/StrangeDaysTech/devtrail/releases
-# 下载最新的 fw-* 发布（例如 fw-4.1.1）
+# 下载最新的 fw-* 发布（例如 fw-4.2.0）
 
 # 解压并复制到你的项目
 unzip devtrail-fw-*.zip -d your-project/
diff --git a/docs/i18n/zh-CN/adopters/ADOPTION-GUIDE.md b/docs/i18n/zh-CN/adopters/ADOPTION-GUIDE.md
diff --git a/docs/i18n/zh-CN/adopters/CLI-REFERENCE.md b/docs/i18n/zh-CN/adopters/CLI-REFERENCE.md

Original file line number	Diff line number	Diff line change
`@@ -270,4 +270,4 @@ When a change modifies API endpoints:`
`270`	`270`
`271`	`271`	`---`
`272`	`272`
`273`		`-DevTrail v4.1.1 \| [Strange Days Tech](https://strangedays.tech)`
	`273`	`+DevTrail v4.2.0 \| [Strange Days Tech](https://strangedays.tech)`
Original file line number	Diff line number	Diff line change
`@@ -234,4 +234,4 @@ Use a Level 1 (Context) diagram to illustrate:`
`234`	`234`
`235`	`235`	`---`
`236`	`236`
`237`		`-DevTrail v4.1.1 \| [Strange Days Tech](https://strangedays.tech)`
	`237`	`+DevTrail v4.2.0 \| [Strange Days Tech](https://strangedays.tech)`
Original file line number	Diff line number	Diff line change
`@@ -249,4 +249,4 @@ See also [ADR-2025-01-20-001] for architectural context.`
`249`	`249`
`250`	`250`	`---`
`251`	`251`
`252`		`-DevTrail v4.1.1 \| [Strange Days Tech](https://strangedays.tech)`
	`252`	`+DevTrail v4.2.0 \| [Strange Days Tech](https://strangedays.tech)`