docs(flows): DoD obligatorio con user-facing surface + abrir issues 0100-0103 (taxonomia, frontmatter migration, dev_console, work dashboard)

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

bash/functions/pipelines/redeploy_cpp_app_windows.md

@@ -3,16 +3,17 @@ name: redeploy_cpp_app_windows
 kind: pipeline
 lang: bash
 domain: pipelines
-version: "1.0.0"
+version: "1.1.0"
 purity: impure
 signature: "redeploy_cpp_app_windows(app_name: string, app_dir: string, [--build]) -> void"
-description: "Pipeline orquestador para redeployar una app C++ en Windows desde WSL2 en un solo comando. Reemplaza la secuencia manual taskkill+copy+launch+verify."
+description: "Pipeline orquestador para redeployar una app C++ en Windows desde WSL2 en un solo comando. Reemplaza la secuencia manual taskkill+copy+launch+verify e incluye refresh del icon cache del shell."
 tags: [cpp, windows, redeploy, pipeline, wsl, launcher, cpp-windows]
 uses_functions:
   - build_cpp_windows_bash_infra
   - deploy_cpp_exe_to_windows_bash_infra
   - launch_cpp_app_windows_bash_infra
   - is_cpp_app_running_windows_bash_infra
+  - refresh_windows_icon_cache_bash_infra
 uses_types: []
 returns: []
 returns_optional: false
@@ -47,6 +48,7 @@ redeploy_cpp_app_windows "chart_demo" "/home/lucas/fn_registry/cpp/apps/chart_de
 1. **Parsear flag `--build`** (default off, opt-in).
 2. **Si `--build`**: invocar `build_cpp_windows <app_name>` para compilar `cpp/build/windows/apps/<app_name>/<app_name>.exe`. Si falla, exit 1 sin tocar el Desktop.
 3. **Deploy**: invocar `deploy_cpp_exe_to_windows "<app_name>" "<app_dir>"`. Esta función mata el proceso si está vivo (taskkill.exe pre-autorizado), copia exe + DLLs + assets + runtime + enrichers, y preserva `local_files/`.
+3b. **Refresh icon cache** (v1.1.0+): invocar `refresh_windows_icon_cache` (best-effort). Llama `ie4uinit.exe -show` para que Explorer recargue `iconcache.db` sin esperar al timestamp. Si falla, no aborta el pipeline.
 4. **Launch**: invocar `launch_cpp_app_windows "<app_name>"` para arrancar la app en Windows.
 5. **Wait**: `sleep 1` — espera arranque corto.
 6. **Verify**: invocar `is_cpp_app_running_windows "<app_name>"`. Si NO está vivo → exit 1 con mensaje claro.

bash/functions/pipelines/redeploy_cpp_app_windows.sh

@@ -7,6 +7,7 @@ source "$SCRIPT_DIR/../infra/build_cpp_windows.sh"
 source "$SCRIPT_DIR/../infra/deploy_cpp_exe_to_windows.sh"
 source "$SCRIPT_DIR/../infra/launch_cpp_app_windows.sh"
 source "$SCRIPT_DIR/../infra/is_cpp_app_running_windows.sh"
+source "$SCRIPT_DIR/../infra/refresh_windows_icon_cache.sh"
 
 redeploy_cpp_app_windows() {
     local app_name=""
@@ -63,6 +64,12 @@ redeploy_cpp_app_windows() {
     fi
     echo "[2/4] Deploy OK"
 
+    # Refrescar cache de iconos del shell. Sin esto el .exe nuevo puede salir
+    # con el icono generico (Windows cachea por timestamp/path en iconcache.db
+    # y a veces no detecta el cambio inmediatamente). Best-effort: si falla
+    # no abortamos el redeploy.
+    refresh_windows_icon_cache || true
+
     # Paso 3: lanzar la app
     echo "[3/4] Launching $app_name..."
     if ! launch_cpp_app_windows "$app_name"; then