chore: auto-commit (97 archivos)

- .claude/CLAUDE.md
- .claude/agents/fn-recopilador/SKILL.md
- .claude/rules/INDEX.md
- .claude/rules/cpp_apps.md
- bash/functions/infra/build_cpp_windows.sh
- cpp/CMakeLists.txt
- cpp/PATTERNS.md
- cpp/framework/app_base.cpp
- cpp/framework/app_base.h
- dev/issues/README.md
- ...

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

cpp/functions/infra/job_cache_sha256.h

@@ -0,0 +1,48 @@
+#pragma once
+
+#include <string>
+
+// job_cache_sha256 — addressable cache layout helper.
+//
+// Layout:
+//   <root>/<key[0:2]>/<key><suffix>
+//
+// El caller calcula el `key` (tipicamente SHA-256 hex de algun valor
+// canonico — URL, parametros, etc.). Esta funcion no hashea: solo
+// gestiona el path y la I/O.
+//
+// Suffix permite multiples blobs por la misma key (`.html`, `.md`,
+// `.json`). Pasa "" si solo hay un blob.
+
+namespace fn::cache_sha256 {
+
+// Pure. Devuelve "<root>/<key[0:2]>/<key><suffix>". No toca disco.
+// Si key tiene menos de 2 caracteres, usa la key entera como subdir.
+std::string path_for(const std::string& root,
+                     const std::string& key,
+                     const std::string& suffix = "");
+
+// Impure. Crea el directorio `<root>/<key[0:2]>/` si no existe.
+// Devuelve true en exito. No falla si ya existe.
+bool ensure_dir(const std::string& root, const std::string& key);
+
+// Impure. Lee el archivo en `path_for(root, key, suffix)` entero.
+// Devuelve true si existia y se leyo; false en caso contrario.
+bool read(const std::string& root,
+          const std::string& key,
+          const std::string& suffix,
+          std::string* out);
+
+// Impure. Escribe `bytes` en `path_for(root, key, suffix)`. Crea el
+// directorio padre si no existe. Devuelve true en exito.
+bool write(const std::string& root,
+           const std::string& key,
+           const std::string& suffix,
+           const std::string& bytes);
+
+// Impure. true si el archivo existe en `path_for(root, key, suffix)`.
+bool exists(const std::string& root,
+            const std::string& key,
+            const std::string& suffix);
+
+} // namespace fn::cache_sha256