chore: bump CLI to 3.0.0 and Framework to 4.1.0 (#34)

montfort · claude · web-flow · commit 3bb44c367a2a · 2026-04-02T13:25:49.000-06:00
CLI 3.0.0 — new commands (analyze, new), --staged flag, arborist-metrics
integration with 12 languages, complexity-based documentation triggers.

Framework 4.1.0 — governance updated to use devtrail analyze as primary
documentation trigger with &gt;20 lines fallback, arborist-metrics promotion.

Updated version references across all docs, footers, and examples.
Also fixed stale fw-2.1.0 references in ADOPTION-GUIDE (EN + ES).

Co-authored-by: Claude Opus 4.6 (1M context) &lt;noreply@anthropic.com&gt;
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.0.0 | `fw-4.0.0` |
-| CLI | `cli-X.Y.Z` | cli-2.1.0 | `cli-2.1.0` |
+| Framework | `fw-X.Y.Z` | fw-4.1.0 | `fw-4.1.0` |
+| CLI | `cli-X.Y.Z` | cli-3.0.0 | `cli-3.0.0` |
 
 Follow [semver](https://semver.org/):
 - **Major**: breaking changes
diff --git a/README.md b/README.md
@@ -146,8 +146,8 @@ DevTrail uses independent version tags for each component:
 
 | Component | Tag prefix | Example | Includes |
 |-----------|-----------|---------|----------|
-| Framework | `fw-` | `fw-4.0.0` | Templates (12 types), governance, directives |
-| CLI | `cli-` | `cli-2.1.0` | The `devtrail` binary |
+| Framework | `fw-` | `fw-4.1.0` | Templates (12 types), governance, directives |
+| CLI | `cli-` | `cli-3.0.0` | The `devtrail` binary |
 
 Check installed versions with `devtrail status` or `devtrail about`.
 
@@ -177,7 +177,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.0.0)
+# and download the latest fw-* release (e.g., fw-4.1.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 = "2.1.0"
+version = "3.0.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
@@ -268,4 +268,4 @@ When a change modifies API endpoints:
 
 ---
 
-*DevTrail v4.0.0 | [Strange Days Tech](https://strangedays.tech)*
+*DevTrail v4.1.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.0.0 | [Strange Days Tech](https://strangedays.tech)*
+*DevTrail v4.1.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
@@ -247,4 +247,4 @@ See also [ADR-2025-01-20-001] for architectural context.
 
 ---
 
-*DevTrail v4.0.0 | [Strange Days Tech](https://strangedays.tech)*
+*DevTrail v4.1.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.0.0 | [Strange Days Tech](https://strangedays.tech)*
+*DevTrail v4.1.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.0.0 | [Strange Days Tech](https://strangedays.tech)*
+*DevTrail v4.1.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.0.0 | [Strange Days Tech](https://strangedays.tech)*
+*DevTrail v4.1.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.0.0 | [Strange Days Tech](https://strangedays.tech)*
+*DevTrail v4.1.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.0.0 | [Strange Days Tech](https://strangedays.tech)*
+*DevTrail v4.1.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.0.0 | [GitHub](https://github.com/StrangeDaysTech/devtrail) | [Strange Days Tech](https://strangedays.tech)*
+*DevTrail v4.1.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.0.0"
+version: "4.1.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-2.1.0`).
+   Go to [GitHub Releases](https://github.com/StrangeDaysTech/devtrail/releases) and download the latest `fw-*` release ZIP (e.g., `fw-4.1.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.0.0` | Templates (12 types), governance docs, directives |
-| CLI | `cli-` | `cli-2.1.0` | The `devtrail` binary |
+| Framework | `fw-` | `fw-4.1.0` | Templates (12 types), governance docs, directives |
+| CLI | `cli-` | `cli-3.0.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.0.0
+✔ Downloaded DevTrail fw-4.1.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.0.0
+✔ Framework updated to fw-4.1.0
 Updating CLI...
-✔ CLI updated to cli-2.1.0
+✔ CLI updated to cli-3.0.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.0.0
+✔ Framework updated to fw-4.1.0
 ```
 
 ---
@@ -138,7 +138,7 @@ Auto-update the `devtrail` binary itself. Looks for the latest `cli-*` release o
 
 ```bash
 $ devtrail update-cli
-✔ CLI updated to cli-2.1.0
+✔ CLI updated to cli-3.0.0
 ```
 
 ---
@@ -200,8 +200,8 @@ $ devtrail status
   Project
   ┌───────────┬──────────────────────────┐
   │ Path      │ /home/user/my-project    │
-  │ Framework │ fw-4.0.0                 │
-  │ CLI       │ cli-2.1.0                │
+  │ Framework │ fw-4.1.0                 │
+  │ CLI       │ cli-3.0.0                │
   │ Language  │ en                       │
   └───────────┴──────────────────────────┘
 
@@ -257,7 +257,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.0.0
+  Using version: fw-4.1.0
 ✓ Restored 16 file(s) from framework
 → Updating checksums...
 
@@ -625,8 +625,8 @@ Show version, authorship, and license information.
 ```bash
 $ devtrail about
 DevTrail CLI
-  CLI version:       cli-2.1.0
-  Framework version: fw-4.0.0
+  CLI version:       cli-3.0.0
+  Framework version: fw-4.1.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
@@ -146,8 +146,8 @@ DevTrail usa tags de versión independientes para cada componente:
 
 | Componente | Prefijo de tag | Ejemplo | Incluye |
 |------------|---------------|---------|---------|
-| Framework | `fw-` | `fw-4.0.0` | Plantillas (12 tipos), gobernanza, directivas |
-| CLI | `cli-` | `cli-2.1.0` | El binario `devtrail` |
+| Framework | `fw-` | `fw-4.1.0` | Plantillas (12 tipos), gobernanza, directivas |
+| CLI | `cli-` | `cli-3.0.0` | El binario `devtrail` |
 
 Verifica las versiones instaladas con `devtrail status` o `devtrail about`.
 
@@ -177,7 +177,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-2.1.0)
+# y descarga el último release fw-* (ej. fw-4.1.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-2.1.0`).
+   Ve a [GitHub Releases](https://github.com/StrangeDaysTech/devtrail/releases) y descarga el último release `fw-*` (ej. `fw-4.1.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.0.0` | Plantillas (12 tipos), docs de gobernanza, directivas |
-| CLI | `cli-` | `cli-2.1.0` | El binario `devtrail` |
+| Framework | `fw-` | `fw-4.1.0` | Plantillas (12 tipos), docs de gobernanza, directivas |
+| CLI | `cli-` | `cli-3.0.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.0.0
+✔ Downloaded DevTrail fw-4.1.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.0.0
+✔ Framework updated to fw-4.1.0
 Updating CLI...
-✔ CLI updated to cli-2.1.0
+✔ CLI updated to cli-3.0.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.0.0
+✔ Framework updated to fw-4.1.0
 ```
 
 ---
@@ -137,7 +137,7 @@ Auto-actualiza el binario `devtrail`. Busca el último release `cli-*` en GitHub
 
 ```bash
 $ devtrail update-cli
-✔ CLI updated to cli-2.1.0
+✔ CLI updated to cli-3.0.0
 ```
 
 ---
@@ -194,8 +194,8 @@ $ devtrail status
 DevTrail Status
 ───────────────
 Path:              /home/user/my-project
-Framework version: fw-4.0.0
-CLI version:       cli-2.1.0
+Framework version: fw-4.1.0
+CLI version:       cli-3.0.0
 Language:          en
 Structure:         ✔ Complete
 
@@ -504,8 +504,8 @@ Muestra información de versión, autoría y licencia.
 ```bash
 $ devtrail about
 DevTrail CLI
-  CLI version:       cli-2.1.0
-  Framework version: fw-4.0.0
+  CLI version:       cli-3.0.0
+  Framework version: fw-4.1.0
   Author:            Strange Days Tech, S.A.S.
   License:           MIT
   Repository:        https://github.com/StrangeDaysTech/devtrail

Original file line number	Diff line number	Diff line change
`@@ -268,4 +268,4 @@ When a change modifies API endpoints:`
`268`	`268`
`269`	`269`	`---`
`270`	`270`
`271`		`-DevTrail v4.0.0 \| [Strange Days Tech](https://strangedays.tech)`
	`271`	`+DevTrail v4.1.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.0.0 \| [Strange Days Tech](https://strangedays.tech)`
	`237`	`+DevTrail v4.1.0 \| [Strange Days Tech](https://strangedays.tech)`
Original file line number	Diff line number	Diff line change
`@@ -247,4 +247,4 @@ See also [ADR-2025-01-20-001] for architectural context.`
`247`	`247`
`248`	`248`	`---`
`249`	`249`
`250`		`-DevTrail v4.0.0 \| [Strange Days Tech](https://strangedays.tech)`
	`250`	`+DevTrail v4.1.0 \| [Strange Days Tech](https://strangedays.tech)`
Original file line number	Diff line number	Diff line change
@@ -188,4 +188,4 @@ Mark `review_required: true` when:
`188`	`188`
`189`	`189`	`---`
`190`	`190`
`191`		`-DevTrail v4.0.0 \| [Strange Days Tech](https://strangedays.tech)`
	`191`	`+DevTrail v4.1.0 \| [Strange Days Tech](https://strangedays.tech)`
Original file line number	Diff line number	Diff line change
`@@ -270,4 +270,4 @@ Cuando un cambio modifica endpoints de API:`
`270`	`270`
`271`	`271`	`---`
`272`	`272`
`273`		`-DevTrail v4.0.0 \| [Strange Days Tech](https://strangedays.tech)`
	`273`	`+DevTrail v4.1.0 \| [Strange Days Tech](https://strangedays.tech)`
Original file line number	Diff line number	Diff line change
`@@ -234,4 +234,4 @@ Usar un diagrama de Nivel 1 (Contexto) para ilustrar:`
`234`	`234`
`235`	`235`	`---`
`236`	`236`
`237`		`-DevTrail v4.0.0 \| [Strange Days Tech](https://strangedays.tech)`
	`237`	`+DevTrail v4.1.0 \| [Strange Days Tech](https://strangedays.tech)`