@pasosdejesus/m 0.22.1 → 0.22.3

package/dist/CHANGELOG.md

@@ -0,0 +1,902 @@
+# Changelog
+
+All notable changes to `@pasosdejesus/m` are documented in this file.
+
+## [0.22.3] - 2026-09-27
+
+### Added
+
+- **`README.md` en el paquete `m`** (npm lo incluye automáticamente) para que la
+  página de npm y quien lee `node_modules/@pasosdejesus/m` tengan la descripción,
+  la tabla de comandos por área, los subpath exports y los enlaces a
+  `ARCHITECTURE.md`, `API.md` y `doc/`.
+
+### Changed
+
+- **`dist/CHANGELOG.md`**, generado en el build desde el `CHANGELOG.md` de la raíz
+  (fuente única: no queda una copia dentro del paquete que se pueda pudrir).
+- **`files` de `m`** ya no nombra rutas inexistentes (`CHANGELOG.md`, `doc`): npm
+  las omitía en silencio. El paquete publica `dist` (con su `CHANGELOG.md`) y los
+  `src/*/README.md`.
+
+## [0.22.2] - 2026-09-27
+
+### Fixed
+
+- **El paquete publicado ya no lleva archivos de otra rama.** `files: ["dist"]`
+  empaqueta el directorio tal cual y `tsc -b` no borra las salidas cuya fuente
+  desapareció, así que `@pasosdejesus/m@0.22.1` incluyó **46 archivos obsoletos**
+  (516 entradas frente a 470 de 0.22.2): los 44 de `dist/base-model/**` y
+  `dist/tasks/base-model.*`, compilados desde la rama `msip1` —código cuyo fuente no
+  está en `main` y que el wildcard `./dist/*` dejaba además importable— y 2 de
+  `dist/templates/apps/hardhat/{contracts/MockUSDT.sol,test/MockUSDT.test.ts}`,
+  que se habían movido al motor `usdt` en v0.21.0. Ahora `build` limpia `dist`
+  antes de compilar y `publish` verifica el contenido antes de empaquetar.
+
+### Added
+
+- **`scripts/check-dist.mjs`** con `make dist-check` y un paso obligatorio en
+  `make publish`: falla si alguna salida en `dist` no tiene fuente en el
+  repositorio, que es el caso que dejó pasar `base-model`.
+
+### Changed
+
+- **`make clean`** (nuevo) y **`build` de `m`/`mpdj` limpia antes de compilar**:
+  `packages/m/dist` y `packages/mpdj/dist` no están en git, de modo que un cambio
+  de rama podía dejar código obsoleto listo para publicar. Costo: el build de `m`
+  es siempre completo (~23 s) en vez de incremental.
+
+## [0.22.1] - 2026-09-27
+
+### Changed
+
+- **Sin emojis en la salida de los comandos ni en la documentación.** Las
+  terminales OpenBSD/adJ no renderizan emojis: los mensajes y los documentos usan
+  los indicadores de `AGENTS.md` (`[OK]`, `[FAIL]`, `[WARN]`, `[INFO]`) o texto
+  plano. Se conservan los dos marcadores que son protocolo del formato de REQ
+  (`packages/m/src/tasks/req.ts`: la detección de "Pendiente en" y la etiqueta
+  heredada de estado).
+- **`mpdj@0.2.8`:** los 11 instrumentos de `ia/alineacion_*.md` comparten una
+  **misma sección de detección de eco** (idéntica línea por línea); lo propio de
+  cada instrumento quedó en secciones separadas (`## Eco temático`,
+  `## Autoauditoría final`, `## Si no puedes calcular`) y los emojis salieron
+  también de `ai:framework`, `ai:principles`, `ai:skill` y `ai:adJ`.
+
+### Added
+
+- **`mpdj@0.2.8`:** test de regresión
+  (`packages/mpdj/__tests__/ia-alignment.test.ts`) que falla si la sección de eco
+  diverge entre instrumentos, si aparece un emoji o si un instrumento deja de
+  distinguir la adopción analítica de la afirmación metafísica.
+
+### Fixed
+
+- **`ai:context`:** `normalizeStatus()` ignora los marcadores de la nueva
+  convención (`[OK]`, `[FAIL]`, ...) al clasificar el estado de un REQ. Sin esto,
+  `**Status:** [OK] Closed` dejaba de reconocerse como cerrado y el requerimiento
+  seguía apareciendo entre los abiertos.
+
+### Removed
+
+- **`mpdj@0.2.8`: `ia/manifiesto.md`.** Su contenido vive en
+  `ia/alineacion_*.md` e `ia/principles.md`; `ARCHITECTURE.md` y la lista de
+  archivos de `AGENTS.md` ya no lo referencian.
+- **`dist/` de la raíz** (412 archivos): espejo del layout previo al monorepo que
+  nadie leía. Sus tres dependientes (`ai.verify.test.ts`, `db.console.test.ts` y
+  `scripts/repro-call-dataload-sstore.js`) ahora apuntan a `packages/*/dist`, y
+  `/dist/` quedó en `.gitignore` para que no vuelva.
+- **22 archivos compilados sueltos dentro de `packages/m/src/`** (`.js` y `.d.ts`
+  con su gemelo `.ts`, ni publicados ni referenciados).
+
+### Documentation
+
+- `AGENTS.md`, `ARCHITECTURE.md`, `CONTRIBUTING.md`, `API.md`, `doc/*`, `REQ/*` y
+  las plantillas de `templates/` sin emojis; `doc/version-bump.md` con los
+  conteos de pruebas al día y `usdt` en la lista de paquetes.
+
+## [usdt 0.1.3] - 2026-09-27
+
+### Fixed
+
+- **`usdt@0.1.3`: `useContractPayment` encadena las transferencias.** Un pago a
+  curso, clúster o país puede llevar USDT y SLEARN; el hook las mandaba una tras
+  otra y la segunda reutilizaba el nonce de la primera —que seguía en el mempool—
+  así que el nodo la rechazaba con `replacement transaction underpriced` (reporte
+  del operador en learn.tg, 2026-09-27; el patrón de Celo L2 está documentado en
+  [`doc/celo-nonce-handling.md`](doc/celo-nonce-handling.md)). Ahora se espera el
+  recibo de la anterior antes de enviar la siguiente y una colisión de nonce se
+  reintenta (el nodo rechazó esa transacción: no se duplica el pago).
+- **`usdt@0.1.3`: mensajes de error sin emojis** (`lib/parse-wallet-error`), que
+  el host muestra tal cual al estudiante.
+
+### Added
+
+- **`usdt@0.1.3`: `@pasosdejesus/usdt/lib/send-transfers`** (`sendTransfers`,
+  `isNonceCollision`) — envío encadenado de transferencias ERC-20, reutilizable por
+  los hosts (learn.tg, sivel3) distintos del hook de pago.
+
+## [0.22.0] - 2026-09-19
+
+### Added
+
+- **`ai:context`** reescrito (https://gitlab.com/pasosdeJesus/m/-/work_items/45):
+  detección de tipo de proyecto y *workspace roots* (`rails`, `nextjs`,
+  `hardhat`, `node`, `monorepo`), perfiles de tarea (`--task nextjs:auth`,
+  `rails:auth`, `pwa`, `wallet`, `contracts`, `tests`) cargables desde JSON sin
+  tocar código (`ai/context-profiles.json`, `.m/context-profiles.json`,
+  `~/.config/m/context-profiles.json`), `--type`, `--root`, `--depth`,
+  `--list-tasks`, `--print-config`, `--include`/`--exclude`, `--git`,
+  `--git-authors`, `--untracked`, `--reqs`, `--req-max`, `--structure`,
+  `--files`, `--stdout`, `--truncate` y `--deterministic`.
+- Lista de secretos con denegación absoluta (`.env*`, `*.pem`, `*.key`,
+  `config/master.key`, `config/credentials.yml.enc`, billeteras), aplicada
+  después de `--include`, y auto-exclusión del archivo de salida.
+- `parseFlags` acepta banderas repetibles (`type: 'array'`).
+
+### Changed
+
+- **`ai:context` formato de salida incompatible (schema 1):** documento estable
+  en inglés con secciones `Git state`, `Open requirements`, `Directory
+  structure`, `Key files`, `Not found` y `Skipped`; se abandonan los marcadores
+  `___INICIO_ARCHIVO_<ts>___` y las cabeceras en español del documento (los
+  mensajes de consola siguen localizados). `--limit` pasa a ser un tope **duro**
+  del tamaño final del documento, y los archivos binarios se omiten.
+- `DEFAULT_EXCLUDES` (`.contextignore` y `--exclude` ahora **extienden** en vez
+  de reemplazar); `node_modules`, `dist`, `build`, `.git`, `coverage`, `.next`,
+  `tmp` y `vendor` nunca se recorren, ni con `--include "**/*"`.
+- El árbol de directorios se genera desde la lista de archivos de git, por lo
+  que ya no requiere el binario `tree` (ausente en OpenBSD base).
+
+### Fixed
+
+- **`--help`:** la categoría `Requirements` y las órdenes `req:*` no aparecían
+  desde que `req:*` pasó de plugin a órdenes built-in de `m.ts` (`showHelp()`
+  armaba la categoría solo con comandos de plugin). Ahora une las built-in con
+  las de plugins (`tests/req.test.ts` 19/19).
+
+### Documentation
+
+- **`mpdj@0.2.7`:** `SKILL.md` documenta la superficie completa de `ai:context`
+  (flags nuevas, perfiles JSON, esquema del documento).
+- `API.md` (tabla de flags y ejemplos), `README.md` y
+  `packages/m/src/tasks/README.md` actualizados para `ai:context`.
+
+## [0.21.1] - 2026-08-28
+
+### Changed
+
+- **`usdt@0.1.2`**: `useGasEstimation` — cuando estimar gas falla con un saldo
+  de CELO prácticamente cero (< 2^50 wei, ~0.0011 CELO), clasifica `'no-gas'`
+  (guía al usuario a obtener CELO) en vez de `'warn'` genérico (redes reales:
+  "insufficient funds for gas").
+- **`edr@0.1.2`**: fixes que el `0.1.1` publicado no incluía — `eth_call` usa un
+  bloque con `block.timestamp` actual (+ `timestampOffset`), así las view
+  functions ven los efectos de `evm_increaseTime`/`evm_mine`; mensajes de
+  revert simplificados (reason/revertMsg se pasan por separado).
+- **`usdt@0.1.1`**: imports relativos con `.js` en el source (requisito ESM
+  para paquetes publicados; el `0.1.0` sin extensión rompía el consumo desde
+  node_modules en vite/Node). learn.tg y sivel3 adoptan la versión publicada
+  (`^0.1.0` → caret incluye `0.1.1`) y eliminan `scripts/link-usdt.mjs`.
+- **`doc/engines.md`**: pitfall nuevo — los motores **publicados** (shared,
+  ESM) deben usar imports relativos con `.js` (como `mpdj`); sin extensión
+  solo para motores locales consumidos por webpack.
+
+## [0.21.0] - 2026-08-28
+
+### Added
+
+- **Motor `@pasosdejesus/usdt` (0.1.0)** — primera graduación `local → shared`
+  de un motor (REQ/35 Fase 7): infraestructura de pago USDT/SLEARN compartida
+  entre learn.tg y sivel3 (`lib/donate-utils`, `lib/parse-wallet-error`,
+  `hooks/useGasEstimation`, `hooks/useContractPayment` sin next-auth — deps
+  inyectadas, `components/TransactionStatus`) y el contrato `MockUSDT.sol`
+  (fuente canónica; los hosts lo copian vía `sync-usdt.mjs` a
+  `contracts/_usdt_mock.sol`).
+- **Descubrimiento de motores con grafo de inclusiones**: `scripts/engine-scan.mjs`
+  (cohesión, salientes D2, entrantes D3, SDK build-time) + fixture sintético de
+  validación (https://gitlab.com/pasosdeJesus/m/-/work_items/35).
+- **Template `m:create`**: los proyectos generados ya no copian `MockUSDT.sol`
+  (versión vieja manual); dependen de `@pasosdejesus/usdt` y lo compilan desde
+  el paquete.
+
+### Changed
+
+- **`contract-test@0.1.4`**: el runner carga artifacts de todo `artifacts/`
+  (incluye contratos importados de node_modules) y compila con `hardhat
+  compile` directo (sin el typechain del build del proyecto).
+- **Docs**: `doc/engine.md` + `doc/engines.md` unificados en `doc/engines.md`
+  (estructura de motor, namespace, D1-D3, playbook, pitfalls, graduación);
+  `README.md`, `ARCHITECTURE.md` y `API.md` documentan `@pasosdejesus/usdt`.
+- **`mpdj@0.2.6`**: SKILL.md actualizado (enlace `doc/engines.md`).
+
+## [0.20.1] - 2026-08-26
+
+### Added
+
+- **E2E: rotación de billeteras entre specs**: el runner de `test:e2e` asigna
+  `WALLET_INDEX` (0,1,2,…) a cada spec e `initTestEnv` elige
+  `account = wallets[idx % wallets.length]`. Con `TEST_PRIVATE_KEYS` de N
+  billeteras, cada spec usa una distinta y no se tropieza con el rate-limit por
+  wallet (429/cooldown) del sitio bajo prueba
+  (https://gitlab.com/pasosdeJesus/m/-/issues/35).
+
+### Changed
+
+- **`test:e2e`**: pausa configurable entre specs (`E2E_SPEC_DELAY_MS`,
+  default 1500) para reducir la flakiness de la suite contra el rate-limit del
+  dev site (https://gitlab.com/pasosdeJesus/m/-/issues/35).
+
+## [0.20.0] - 2026-08-26
+
+### Added
+
+- **E2E multi-wallet**: `initTestEnv` expone `env.wallets: E2EAccount[]` desde
+  `TEST_PRIVATE_KEYS` (lista separada por comas; `account` = primera, retrocompatible).
+  Permite flujos de claim que necesitan una billetera de sesión (SIWE) y otra
+  claimer con fondos para gas (https://gitlab.com/pasosdeJesus/m/-/issues/35).
+
+### Fixed
+
+- **`initTestEnv` lee `apps/.env`**: `loadEnvFile` ahora prueba `../.env`
+  (apps/ cuando cwd=apps/<app>), `../../.env` y `.env`. Antes solo `../../.env`
+  y `.env`, por lo que los specs E2E desde `apps/nextjs` no encontraban
+  `PRIVATE_KEY`/`NEXT_PUBLIC_ADDRESS` y caían a la Hardhat key (SIWE 401)
+  (https://gitlab.com/pasosdeJesus/m/-/issues/35).
+
+## [0.19.0] - 2026-08-18
+
+### Added
+
+- **`m:create engine <name>`**: scaffolds a new Web3 engine package under
+  `packages/<name>/` (`engine.json`, `package.json`, `tsconfig`, kysely config,
+  `src/` skeleton) (https://gitlab.com/pasosdeJesus/m/-/issues/35).
+- **Engine discovery wired to the CLI**: `eng:list` now lists engines discovered
+  from `packages/*/engine.json`; `eng:check` verifies each engine's migration
+  directory (https://gitlab.com/pasosdeJesus/m/-/issues/35).
+- **`db:migrate` runs engine migrations**: core migrations run first, then each
+  engine's `db/migrations` (via `kysely --cwd <engine>`)
+  (https://gitlab.com/pasosdeJesus/m/-/issues/35).
+- Unit tests for `createRegistry` namespace isolation and engine discovery
+  (`engine.test.ts`, `util/engines.test.ts`).
+
+### Changed
+
+- **`util/engines.ts`**: added `findPackagesDir()` and `discoverEnginesUpward()`
+  for hierarchical engine discovery (mirrors the .env lookup).
+
+## [0.18.6] - 2026-08-17
+
+### Added
+
+- **`@pasosdejesus/m/engine`**: primitiva de registro genérica
+  `createRegistry<T>(namespace)` (globalThis-backeada) + `EngineManifest`
+  (REQ/35, REQ/44). `registerCommands`/`registerHook` ahora son wrappers sobre
+  esta primitiva.
+- **`mpdj@0.2.5`**: `next` como `peerDependency` + `devDependency`; ejemplo
+  `next-server-probe.ts` que demuestra el mecanismo de peer dep para paquetes
+  externos (REQ/35 §11 D1).
+
+### Changed
+
+- **`util/engines.ts`**: `discoverEngines(rootDir)`, `loadEnginePackages(pkgFile)`,
+  `isEnginePackage`, `resolveEngineEntry` — generalizan el auto-descubrimiento de
+  plugins (antes `loadPlugins()` interno de `m.ts`).
+
+## [0.18.5] - 2026-08-17
+
+### Changed
+
+- **test-utils**: `setupFsMocks()` (fs-mocks) y `setupMocks()` (rainbowkit-mocks)
+  deprecados como no-ops. `vi.mock()` dentro de una función de un módulo
+  importado ya no se hoistea en Vitest 3 (REQ/207 en learn.tg): los mocks de
+  `fs/promises`/`node:fs/promises` y de auth deben declararse a module scope en
+  `vitest.setup.ts`, usando las funciones exportadas (`mockReadFile`,
+  `mockNodeReadFile`, `mocks`). Ver `test-utils/README.md` §8.
+
+## [0.18.4] - 2026-08-16
+
+### Fixed
+
+- **Dual package hazard** (REQ/42): el registro de comandos/hooks ahora vive en
+  `globalThis`, de modo que todas las copias de `@pasosdejesus/m` comparten el
+  mismo estado. Antes, si un plugin resolvía una copia distinta de `m` (p.ej. la
+  `.pnpm` vs. el `link:` al workspace), los comandos se registraban en una
+  instancia y se leían en otra.
+
+- **Auto-descubrimiento de plugins** (REQ/34): `loadPlugins()` resuelve el entry
+  point de cada plugin desde el `node_modules` del proyecto consumidor (no desde
+  la ubicación de `m`). Antes `await import('@pasosdejesus/mpdj')` fallaba en
+  silencio.
+
+### Changed
+
+- **`contract-test@0.1.3`**: se auto-descubre vía `mEngine: true` (mismo
+  mecanismo que `mpdj`); se eliminó el hardcode de `contract:test` en `m.ts`.
+
+## [0.18.3] - 2026-08-16
+
+### Security
+
+- **Dependencias vulnerables actualizadas** (REQ/42, `pnpm audit` 0 críticas):
+  - Template: `next` `15.5.12` → `15.5.22` (SSRF, DoS, Middleware/Proxy bypass).
+  - `next-auth` → `4.24.15` (homoglyph `@` bypass, crítica).
+  - `kysely` → `0.28.17` (SQL injection, alta).
+  - `vitest` → `3.2.6` (lectura/ejecución arbitraria vía UI server, crítica).
+
+### Changed
+
+- **`mpdj@0.2.3`**: `peerDependencies.vitest` → `>=2.1.9` (compatible con vitest 3).
+
+## [0.18.2] - 2026-08-15
+
+### Fixed
+
+- **`req:list`/`req:cross` sin `REQ/`:** antes crasheaban con `ENOENT` al
+  ejecutarse fuera de un proyecto con `REQ/`. Ahora `loadAllReqs` devuelve
+  `[]` si el directorio no existe y se muestra un mensaje informativo.
+
+## [0.18.1] - 2026-08-15
+
+### Fixed
+
+- **Modo interactivo**: las órdenes que leen `process.argv.slice(3)` (p.ej.
+  `m:create`) ahora reciben los argumentos escritos en el REPL (se emula
+  `process.argv`). También se corrigió la lectura del argumento requerido con
+  stdin en tubería (se usa el async iterator de `readline` en vez de `question`).
+
+### Added
+
+- **Órdenes `req:*` movidas de `mpdj` a `m`**: `req:list`, `req:show`,
+  `req:cross`, `req:compare`, `req:sync-from-repo`, `req:sync-to-repo`,
+  `req:list-repo`, `req:create`, `req:close` ahora son parte de `m` (no de
+  `mpdj`), de modo que `npx @pasosdejesus/m req:list` funciona sin `mpdj`.
+
+### Changed
+
+- **`mpdj@0.2.2`**: se eliminaron las órdenes `req:*` (ahora en `m`).
+  `mpdj` conserva `ai:*` y `eng:credentials:*`.
+
+## [0.18.0] - 2026-08-14
+
+### Added
+
+- **Modo interactivo (`m` sin parámetros):** en lugar de solo imprimir ayuda y
+  salir, ahora entra en un REPL con `node:readline`: pide una orden (`m> `), y
+  si la orden exige argumento, pide el argumento. Soporta `help`, `--version`,
+  `exit`/`quit` y línea vacía.
+
+## [0.17.3] - 2026-08-14
+
+### Changed
+
+- **Template `tests/helpers.ts`:** propaga la carga jerárquica de `.env.test`
+  (dotenv) que ya tenía `tests/test-project/`, para que el scaffold standalone
+  cargue las variables de entorno de test igual que el harness del monorepo.
+
+## [0.17.2] - 2026-08-13
+
+### Fixed
+
+- **`setupMocks()` deprecado:** `createMockKysely().setupMocks()` ya no
+  ejecuta `vi.mock('kysely'|'pg'|...)` internamente (no funcionaba por
+  hoisting de Vitest → `ReferenceError: mockSql is not defined`). Ahora es
+  un no-op; los mocks de `kysely`/`pg` deben declararse a module scope en
+  el `vitest.setup.ts` del proyecto consumidor (ver README §8).
+- **`make publish PKGS=...`:** el filtro `$(filter ...)` es específico de
+  GNU Make; en OpenBSD `make` (BSD make) devolvía vacío y publicaba los 4
+  paquetes ignorando `PKGS`. Ahora usa `$(PKGS)` directamente.
+- **`mpdj@0.2.1` dep de `@pasosdejesus/m`:** cambiado de `workspace:*` a
+  `workspace:^`. `workspace:*` publica la versión exacta de `m` (p.ej.
+  `0.17.0`), lo que hacía que un consumidor con `m@0.17.2` instalara una
+  segunda copia de `m` y el registro de comandos (`req:*`, `ai:*`) quedara
+  dividido — `bin/m req:list` fallaba con "Orden no encontrada".
+
+## [0.17.1] - 2026-08-13
+
+### Changed
+
+- **`db:super:createuser`:** grants `SUPERUSER` to the created role via
+  `ALTER USER ... WITH SUPERUSER` (after password setup).
+
+### Fixed
+
+- **`MockKysely` wiring:** `createMockKysely` now returns a subclass wired
+  to the shared `mockExecute`/`mockExecuteTakeFirst`/`mockSqlExecute`
+  spies, so `libDbMocks.mockExecute` reflects actual DB calls.
+- **Monorepo build race:** `pnpm run build` now uses
+  `--workspace-concurrency=1` to prevent packages from clobbering each
+  other's `dist/` during parallel builds.
+- **Makefile `_link`:** also symlinks `@pasosdejesus/edr`,
+  `@pasosdejesus/contract-test`, and `@radix-ui/*` for the test project.
+
+### Documentation
+
+- `doc/version-bump.md`: clarified unit vs integration test layers, and
+  the commit → tag → publish order.
+- `ia/adJ.md` + `ia/construir_en_adJ_y_celo.md`: `adJ.md` is now the single
+  source of truth for OpenBSD quirks; the build guide links to it.
+
+## [0.17.0] - 2026-08-12
+
+### Added
+
+- **Hook system:** `registerHook`/`runHooks` in `@pasosdejesus/m/plugin`
+  for lightweight, project-specific extension points.
+- **`m-extensions/` loader:** `@pasosdejesus/m` auto-discovers and loads
+  `.ts`/`.js` files from a `m-extensions/` directory (searched upward).
+- **Auto plugin discovery:** `m` reads `package.json` and auto-imports
+  dependencies matching `@pasosdejesus/m-*`. `bin/m` no longer needs
+  manual plugin imports.
+- **Credential hooks:** `credentials:post-register-type` and
+  `credentials:post-sync-cache` hooks emitted by mpdj, enabling projects
+  like learn.tg to persist project-specific fields (e.g. `course_id`).
+- **`MockKysely` export:** now a standalone class from
+  `@pasosdejesus/m/test-utils/kysely-mocks`.
+
+### Changed
+
+- **mpdj `credentials:sync-cache`:** reads `tokenIdToCourseId` from the
+  contract and passes it to the `post-sync-cache` hook.
+- **hre-mock `getAddress()`:** returns checksummed addresses (matches
+  ethers.js v6 behavior) instead of lowercase.
+
+### Fixed
+
+- **`@pasosdejesus/m` vitest config:** excludes `templates/` and `dist/`
+  to avoid recursive test discovery across the scaffolding templates.
+
+### Documentation
+
+- `doc/m-extensions.md`: guide for consumer projects to register hooks.
+
+## [0.16.0] - 2026-08-07
+
+### Fixed
+
+- **Storage persistence after `restore()` + `runBlock`:** Replaced
+  `MerkleStateManager` (MPT + CheckpointDB) with `SimpleStateManager`
+  (plain JS Maps) in `@pasosdejesus/edr`. Eliminates the caching bug
+  where `setStateRoot()` left stale data in CheckpointDB layers.
+  sivel3: `assignDonation` now passes (6/6).
+- **`ai:adJ` from monorepo root:** `findIaDir` now searches
+  `packages/mpdj/ia/` in addition to previous paths.
+- **`MockKysely` export:** Now exported as standalone class from
+  `@pasosdejesus/m/test-utils/kysely-mocks`, not only as internal type
+  of `createMockKysely`.
+- **Publish as public:** Added `publishConfig.access: public` to all
+  four packages (`m`, `mpdj`, `edr`, `contract-test`).
+
+### Changed
+
+- **hre-mock `loadFixture`:** Re-takes snapshot after restore to match
+  Hardhat 2.x behavior. Exports `clearFixtureCache` for cross-file
+  cache isolation.
+- **contract:test runner:** Restores original `Module._load` after each
+  test file to avoid override chain across files.
+- **Chai `revertedWith` polyfill:** Returns real Promise instead of
+  `Object.assign(this, { then })` which was blocked by chai v4 Proxy.
+- **Chai `revertedWithCustomError`:** Decodes ABI selectors for known
+  OpenZeppelin custom errors (OwnableUnauthorizedAccount, etc.).
+- **Chai `emit` + `.withArgs`:** Returns thenable object `{then, catch, withArgs}`
+  for proper chaining in node:test.
+- **Chai `reverted` + `.not`:** Handles `__flags.negate` explicitly for
+  `.to.not.be.reverted` assertions.
+- **Chai `equal` address normalization:** Compares 0x-addresses
+  case-insensitively.
+- **`readFunction` tuple destructuring:** Added `Symbol.iterator` to
+  support `const [val, addr] = result` for multi-output functions.
+- **`@nomicfoundation/solidity-analyzer`:** Added OpenBSD binary via
+  `prepadJ.sh` (compiles Rust crate for openbsd-x64).
+- **`req:close`:** Now accepts multiple numbers (`req:close 18 21 24`).
+- **`req:sync-to-repo` and `req:close`:** Send issue title with
+  `R-#N:`/`F-#N:`/`I-#N:`/`P-#N:`/`E-#N:` prefix to remote.
+- **`req:compare`:** Prefers local REQ type and marks local as more
+  recent when it has proper prefix format and remote doesn't.
+  Valid prefixes: `R` (Requerimiento), `F` (Falla), `I` (Investigación),
+  `P` (Prueba), `E` (Experimento).
+- **`parseReqFile`:** Strips embedded old prefixes from extracted titles.
+
+### Added
+
+- **`evm_increaseTime` + `evm_mine`:** EdrProvider now tracks
+  `timestampOffset` across blocks and snapshots. `evm_mine` creates
+  real empty blocks instead of just incrementing block number.
+- **`network.provider.send()`:** hre-mock exposes `send(method, params)`
+  for Hardhat-compatible JSON-RPC calls (evm_increaseTime, evm_mine, etc.).
+- **`time.increase`/`time.increaseTo`:** hardhat3 shims now delegate
+  to `EdrProvider.evm_increaseTime` + `evm_mine`.
+- **hardhat3 test suite:** `tests/test-project/apps/hardhat3/` with
+  node:test + shim, zero mocking (61/65 tests pass).
+
+### Documentation
+
+- `doc/edr.md`: Updated architecture to `SimpleStateManager`, revised
+  design decisions.
+- `doc/edr-ethereumjs10.md`: Added resolution note and analysis of the
+  MPT/CheckpointDB bug.
+- `doc/edr-debugging.md`: Updated with resolution details.
+- `doc/edr-remix.md`: Analysis of how Remix avoids the `setStateRoot` bug.
+
+## [0.15.0] - 2026-08-06
+
+### Changed — Monorepo split (BREAKING)
+
+- **Split into two packages**: `@pasosdejesus/m` (general CLI) and
+  `@pasosdejesus/mpdj` (Pasos de Jesús extension).
+- **Plugin system**: `m` exposes `registerCommands()` via `@pasosdejesus/m/plugin`.
+  `mpdj` registers PdJ commands (ai:framework, req:*, eng:credentials:*) as a plugin.
+- **New directory structure**: source lives in `packages/m/src/` and `packages/mpdj/src/`.
+- **Template changes**: base scaffolding no longer includes `ia/`, `SKILL.md`,
+  or PdJ-specific blockchain modules. Use `@pasosdejesus/mpdj` for those.
+- **`bin/m` must load `mpdj`** to enable PdJ commands. See `doc/monorepo-migration.md`.
+
+### Added
+- `@pasosdejesus/mpdj` package with 24 PdJ commands
+- i18n (en/es) to 11 task files: `principles`, `skill`, `glob`, `grep`,
+  `writefile`, `readfile`, `context`, `edit`, `e2e`, `engine`, `wallet`
+- `--help` flag to `env:diff`
+- Tests for `eng:check`, `wallet:call`, `wallet:balance`
+
+### Fixed
+- `ai:edit` regex now accepts `_` and `T` as timestamp separator
+- `env:diff` documented in README, API, SKILL, tasks/README
+
+### Removed
+- Dead code: `packages/m/src/tasks/hardhat.ts`, `packages/m/src/scripts/postinstall.ts`,
+  unused exports from `cli-parser.ts`
+- Old `contract:compile`, `contract:node`, `contract:deploy` entries (unused)
+
+### Dependencies
+- pnpm 10.34.1 → 10.34.5
+- vitest 1.6.1 → 2.1.9 (pool `forks` por defecto, mejor isolación en OpenBSD)
+- React ^19.2.6 → 19.2.7 pineado en templates y test-project
+
+### Fixed — Cross-package test resolution (REQ/19)
+- **Vitest config**: aliases explícitos para React, Radix UI (~40 paquetes), lucide-react,
+  react-hook-form, CVA, clsx, tailwind-merge y viem en `vitest.config.ts`. Fuerzan
+  resolución desde el `node_modules` del test project, eliminando doble instancia de React.
+- **Test fixes**: `slearn-info` (text matchers), `credentials` (mock viem + alias),
+  `minimal-erc1155-repro` (fixture local), DB tests (`rolsuper` → `rolcreatedb`)
+- **CI**: `.gitlab-ci.yml` actualizado para monorepo (build ambos paquetes,
+  symlinks a `packages/m` y `packages/mpdj`, `SUPERUSER` → `CREATEDB`)
+- **Docs**: `API.md` refleja split m/mpdj, `ARCHITECTURE.md` actualizado,
+  `CONTRIBUTING.md` paths corregidos, `monorepo-migration.md` paths corregidos
+
+## [0.14.1] - 2026-07-22
+
+### Fixed
+- `db:migrate`: infinite loop when `stdio` sends stdout to terminal instead of
+  capturing it. The "Migration skipped" message from kysely goes to stdout, but
+  the check only looked at stderr, so the `while(true)` loop never broke.
+  Reverted to `stdio: 'pipe'` with combined stdout+stderr check.
+
+## [0.14.0] - 2026-07-17
+
+### Added
+- `setupSIWEMock` in `@pasosdejesus/m/e2e`: Puppeteer wallet mock with real
+  ECDSA signing via `exposeFunction` + viem. Survives page reloads. Handles
+  `eth_call` (fake balances), `eth_getBalance` (1 CELO), `eth_sendTransaction`
+  (fake hash + receipt), `eth_blockNumber`, `eth_gasPrice`, `eth_estimateGas`.
+  Configurable balances via `SIWEMockOptions`.
+- `e2e/specs/full-flow.spec.mjs` in test-project: 10-step full user flow test
+  (Connect → Courses → Donate → Profile → Guide → Crossword → UBI → Disconnect).
+- `e2e/smoke/full-journey.spec.mjs` in test-project: HTTP-only endpoint smoke test.
+- 11 unit tests for `AddSlearnButton` component.
+
+### Changed
+- `AddSlearnButton`: removed `wagmi` dependency. Uses `window.ethereum` directly
+  via `typeof window !== 'undefined' && !!window.ethereum` instead of `useWalletClient()`.
+- `edr-provider`: `eth_call` now uses `vm.evm.runCall()` directly instead of
+  `_executeWithRunBlock` + `runBlock`. Fixes `returnValue` being empty on dry-run
+  with `@ethereumjs/vm@10`.
+- Block gas limit in `_executeWithRunBlock` raised to min 30M (was equal to tx
+  gas limit). Fixes VM compatibility with `@ethereumjs/vm@10`.
+
+### Fixed
+- Contract tests: `struct/tuple decoding` tests now pass — init code CODECOPY
+  had missing `destOffset`, runtime used `PUSH0` (invalid on Chainstart).
+  28/28 contract tests pass (3 skipped = fork).
+- `edr-provider`: `eth_call` with empty calldata now correctly returns contract
+  output instead of `0x`.
+
+## [0.13.0] - 2026-07-12
+
+### Fixed
+- `hre-mock`: struct/tuple decoding — `readFunction` now converts viem arrays to
+  named objects using ABI `outputs[i].name`. Fixes `preAlerts(id).eventHash` returning
+  `undefined` in SIVeL3PreAlertMarket tests (+4 passing in sivel3).
+- `edr-provider`: eth_sendTransaction default gas raised from 3M to 5M (was
+  inconsistent with `_executeWithRunBlock`'s 5M default). Fixes `VM Exception: revert`
+  on OZ ERC1155 `registerCredentialType` calls via hre-mock.
+- `wallet:keccak`: throws Error instead of silent return.
+- `db:migmake` tests: use absolute path to `bin/m`.
+
+### Changed
+- `req:compare`: content fingerprint comparison (ignores timestamp if content
+  identical). Fixes false `rem+` after `sync-to-repo`.
+- `req:list`/`req:cross`: i18n headers (EN when `LANG=en`), status translations,
+  aligned column headers.
+- `SlearnInfo`: link labels use translated full text.
+
+### Added
+- `wallet:derive`: HD derivation from parent wallet mnemonic.
+- `wallet:generate`: stores mnemonic for downstream derivation.
+- `doc/edr-remix.md`: full analysis of Remix VM config vs EdrProvider.
+- `scripts/repro-call-dataload-sstore-remix-provider.js`: Remix-style VM + Solidity deploy [OK].
+- 3 contract-test regression tests: address case, eth_call uint256, OZ deploy.
+- 2 bytecode fixtures: `MockUSDT.bytecode.txt`, `Storage.bytecode.txt`.
+
+### Fixed in sivel3 (test corrections)
+- `MockUSDT.test.ts`: constructor args `deploy(owner.address)`, supply corrected.
+- `PasosDeJesusCredentials.test.ts`: +2 args in `registerCredentialType`,
+  `mintCourseCompletion` with 2 args (not 4).
+
+## [0.12.0] - 2026-07-10
+
+### Changed
+- `contract:test` — Remix-style VM configuration:
+  - State manager: `MerkleStateManager` + `createMPT({ useKeyHashing: true, useRootPersistence: true })`
+  - Explicit blockchain: `createBlockchain` with genesis block
+  - Explicit EVM: `createEVM({ allowUnlimitedContractSize: true })`
+  - `activatePrecompiles: true`
+  - `runBlock` replaces `runCall` for all transaction execution (matches Remix IDE pattern)
+  - `eth_call`/`eth_estimateGas`: runBlock + stateRoot save/restore (dry-run semantics)
+  - Gas default raised from 3M to 5M (OpenZeppelin contracts need more gas)
+- `wallet:derive` implemented — HD derivation from parent wallet mnemonic
+- `wallet:generate` now stores mnemonic for downstream derivation
+- `SlearnInfo`: link labels use translated full text (Take courses on learn.tg, etc.)
+- `req:list`/`req:cross`: column headers aligned with data, i18n (English when LANG=en), status translations
+- `req:list`: cross-project indicator moved to `req:cross` (no overflow)
+
+### Added
+- `ethereumjs-bridge.cjs`: +6 exports (`MerkleStateManager`, `createBlock`, `createBlockchain`, `createEVM`, `createMPT`, `runBlock`)
+- `@ethereumjs/block`, `@ethereumjs/blockchain`, `@ethereumjs/mpt` — new devDependencies
+- `doc/edr-remix.md` — full analysis of Remix VM config vs EdrProvider
+- `scripts/repro-call-dataload-sstore-runblock.js` — runBlock-based reproduction
+- `scripts/repro-call-dataload-sstore-remix-provider.js` — Remix-style VM config + Solidity contract deploy [OK]
+- `tests/fixtures/MockUSDT.bytecode.txt`, `tests/fixtures/Storage.bytecode.txt`
+- 3 new contract-test regression tests (address case, eth_call uint256, OZ deploy)
+
+### Fixed
+- `wallet:keccak` — now throws Error (was silent return)
+- `db:migmake` tests — use absolute path to `bin/m`
+- `contract:test` — 29 tests passing (up from 26)
+- `sivel3-repro`: all 7 tests passing
+
+### Removed
+- CALLDATALOAD+SSTORE as "known bug" — resolved by Remix-style VM config. Upstream issue closed.
+- `runCall` + `checkpoint/commit` pattern — replaced by `runBlock`
+
+## [0.11.0] - 2026-07-10
+
+### Added
+- `contract:test` Phase 4 — Full EVM compatibility:
+  - 17 hardforks (chainstart→cancun) with unique block numbers in inline Mainnet config
+  - PUSH0 (EIP-3855), MCOPY (EIP-5656), and all intermediate EIPs (berlin, london, paris)
+  - `decodeRevertReason()` — human-readable revert messages from `Error(string)` ABI
+  - `eth_call` empty data fix — minimal calldata byte triggers contract execution
+- Chai polyfills for Mocha test runner:
+  - `.reverted`, `.revertedWith(reason)`, `.revertedWithCustomError(contract, name)`
+  - `.emit(contract, event)`, `.changeEtherBalance()`, `.changeTokenBalance()`, `.withArgs()`
+  - BigInt-aware `equal` and `eql` (handles BigInt vs Number/String comparisons)
+- 10 Hardhat accounts prefunded in `EdrProvider` (was only 2)
+- `doc/edr-debugging.md` — practical guide for diagnosing hard EVM bugs
+- Minimal repro test suite: `tests/sivel3-repro.test.ts` (7/7 passing)
+- `scripts/repro-call-dataload-sstore.js` — standalone VM bug reproduction
+- `scripts/repro-call-dataload-sstore-issue.md` — upstream issue proposal for `@ethereumjs/vm`
+
+### Fixed
+- **Solidity ≥0.8.20 contracts:** `VM Exception: invalid opcode` on deploy
+- **Contract code storage:** runtime bytecode not persisted after deploy (PUSH32 padding)
+- **`eth_getStorageAt`:** returning unpadded hex instead of 32-byte padded
+- **Address case mismatch:** EIP-55 mixed case vs lowercase in receipts and `getAddress()`
+- **`getAddress()`** not exposed on `HardhatContract`
+- **ABI encoding mismatch:** `encodeFunctionData` receiving wrong arg count
+- **`_chai.Promise is not a constructor`** in chai polyfills
+- **BigInt vs Number/String:** comparison failures in Mocha test assertions
+
+### Changed
+- `src/tasks/contract-test/edr-provider.ts` — inline Mainnet config with full hardfork list
+- `src/tasks/contract-test/ethereumjs-bridge.cjs` — exports `Chain`, `getPresetChainConfig`
+- `src/tasks/contract-test/index.ts` — chai polyfills + BigInt-aware assertions
+- `src/tasks/contract-test/hre-mock.ts` — `getAddress()`, ABI default args
+- `REQ/13.md` — closed (5/5 resolved)
+- `REQ/15.md` — 9/12 resolved, CALLDATALOAD bug reported upstream
+- `doc/edr.md` — roadmap updated, REQ links to GitLab work items
+
+### Known Issues
+- **CALLDATALOAD+SSTORE in init code** does not persist in `@ethereumjs/vm@10`.
+  Constructor args stored via `SSTORE` during deployment are lost.
+  Reported upstream: https://github.com/ethereumjs/ethereumjs-monorepo/issues/4340
+
+### Added
+- `contract:test` Phase 3 — Test Runner Integration:
+  - `hre-mock.ts` — Hardhat Runtime Environment with ethers (`getSigners`, `getContractFactory`, `getContractAt`) + viem (`getWalletClient`, `getPublicClient`)
+  - Mocha programmatic runner loads and executes Solidity test files with hre injected
+  - `waitForTransactionReceipt` on `EdrProvider`
+  - `require('hardhat')` via require.cache for CJS compatibility
+- `req:compare` without arguments — overview table comparing all local REQs vs remote issues
+- `req:create "<título>" [tipo]` — second optional argument for type (R/F/I/P), defaults to R
+- REQ file format: `# TYPE-#N: Title` markdown header instead of YAML frontmatter
+- `SlearnInfo` props: `steps`, `description`, `links` for project-specific customization
+- `AddSlearnButton` component — wallet_watchAsset for SLEARN token (bilingual)
+- `doc/edr.md` — architecture, usage, and design decisions for contract:test
+- `IDEAS/sesiones-crush.md` — multiple session management via data_directory
+- `Makefile` — per-module test targets (`test-req`, `test-ai`, `test-quick`, etc.)
+
+### Changed
+- `src/blockchain/index.ts` barrel — also excludes `deployments` (uses `fs`)
+- `REQ/7.md` — Phase 3 [OK], Phase 4 partial, references updated to issue #7
+- `contract-test` smoke test replaced with full Mocha test runner
+- `src/tasks/contract-test/README.md` reduced to directory index → points to `doc/edr.md`
+
+### Removed
+- `HANDOFF-edr.md` — absorbed into `REQ/7.md` + `doc/edr.md`
+- `SlearnInfoLocal.tsx`, `AddSlearnButton.tsx` from learn.tg-admin (now in shared package)
+
+## [0.9.0] - 2026-06-28
+
+### Added
+- `req:*` commands — 9 commands to manage requirements locally and sync with GitLab/GitHub:
+  `req:list`, `req:show`, `req:cross`, `req:compare`, `req:sync-from-repo`,
+  `req:sync-to-repo`, `req:list-repo`, `req:create`, `req:close`
+- `req:sync-from-repo N` now creates `REQ/N.md` from remote issue if missing locally
+- `wallet:keccak <string>` — computes Keccak-256 hash, replaces `cast keccak` on OpenBSD
+- `--no-owner` flag in `db:restore` for cross-platform compatibility
+- GitHub token support for req commands (`~/.config/m/github-token` or `GITHUB_TOKEN`)
+- Auto-detect repo config from `git remote get-url origin` as fallback when `req-repos.json` absent
+- Makefile: per-module test targets (`make test-req`, `make test-ai`, `make test-quick`, etc.)
+- `REQ/README.md` — configuration docs for requirement management
+
+### Changed
+- `req:list-repo`, `req:compare`, `req:sync-from-repo` allow public (token-less) read access
+- Server-only modules removed from `src/blockchain/index.ts` barrel:
+  `credential-images`, `admin-credentials`, `deployments` — import directly instead
+- `fetchRepoIssues` fixed to not send empty auth headers to GitHub API
+- `req:compare` shows API diagnostic URL for debugging
+- Tests updated: `req.test.ts` (17 tests), test expectations for token-less access
+
+## [0.8.0] - 2026-06-26
+
+### Added
+- `contract:test` — EDR fallback para OpenBSD/adJ usando `@ethereumjs/vm` v10
+- `EdrProvider` en `src/tasks/contract-test/edr-provider.ts` con métodos `eth_*` JSON-RPC
+- Soporte para fork (`--fork-url`, `--fork-block`) con `RPCStateManager`
+- Auto-detección de `chainId` desde RPC en modo fork
+- `src/tasks/contract-test/README.md` — documentación de arquitectura y uso
+- `tests/test-project/apps/nextjs/tests/contract-test.test.ts` — 20 unit + 3 fork tests
+- Dependencias `@ethereumjs/*` v10 como devDependencies
+- `ecosystem-addresses.ts` — shared contract addresses (`SLEARN_ADDRESSES`, `USDT_ADDRESSES`) and EIP-191 signers (`SIGNERS`) with `resolveNetwork()` and `CeloNetwork` type
+- `SlearnInfo.tsx` — bilingual (en/es) React component explaining SLEARN cashback flow in 4 steps
+- Entry points `./blockchain/ecosystem-addresses` and `./blockchain/slearn-info` in `package.json`
+- Tests for `ecosystem-addresses` (14 tests) and `SlearnInfo` (13 tests)
+- `REQ/7.md`, `REQ/8.md`, `REQ/9.md` — nuevos requerimientos cross-project
+
+### Changed
+- `contract:test` ahora usa import dinámico para cargar dependencias pesadas bajo demanda
+- `"test": "vitest"` → `"vitest run"` en `package.json` y template (evita watch mode)
+- `src/tasks/README.md` actualizado con entrada `contract-test`
+- `REQ/` directory included in `package.json` `files` and build (`cp -R REQ/* dist/REQ/`)
+
+## [0.7.1] - 2026-06-07
+
+### Added
+- `prepadJ.sh` en template para Hardhat en OpenBSD/adJ
+- `{{m_version}}` placeholder en README.hbs
+
+### Fixed
+- `create.ts` `getTemplateDir()` busca `dist/templates/` (ruta correcta en paquete npm)
+- `page.tsx`, `layout.tsx`, `apps/nextjs/README.md` renombrados a `.hbs` para reemplazo de `{{name}}`/`{{description}}`
+- `{{m_version}}` placeholder en README.hbs reemplazado por versión actual
+- `wallet:approve --amount max` usa `uint256 max`; `decimals()` con fallback a 6
+- `wallet:call` acepta `(returnType)` en signature (`learnTgReserve()(address)`)
+- `wallet:*` usa `NEXT_PUBLIC_RPC_URL` o `RPC_URL` de `.env`
+- RPC Celo Sepolia corregido: `forno.celo-sepolia.celo-testnet.org`
+- README orientado a OpenBSD/adJ (pnpm, mg, doas pkg_add)
+- `wallet:*` visible solo si `viem` en `package.json`
+- `packageManager: pnpm@10.34.1` en template para fijar versión
+
+## [0.7.0] - 2026-06-06
+
+### Added
+- `bin/m wallet:*` — 10 commands replacing `cast` on OpenBSD (generate, import, list, balance, send, approve, call, sign, broadcast)
+- `bin/m eng:*` — engine management: `eng:wba:setup`, `eng:credentials:setup`, `eng:list`, `eng:check`
+- `bin/m eng:credentials:*` — credential commands under engine namespace (list-types, mint, register-type, recompose-image, sync-cache, revoke-credential, grant-minter, revoke-minter, set-site-uri)
+- `bin/m db:check` — verifies expected DB schemas against actual database
+- `verifyWebEventSchema()`, `verifyCredentialMetadataSchema()` — schema verification functions
+- `mintCourseWithRetry()` — mint course completion SBTs with Celo L2 nonce retry
+- `ai:skill` ahora muestra siempre el SKILL.md de `@pasosdejesus/m` (no busca local)
+- `doc/wallet.md`, `doc/engines.md`, `doc/pnpm.md` — new documentation
+
+### Changed
+- `mintCredentialWithRetry()` extrae lógica genérica a `mintWithRetry(functionName, args)`; wrapper preserva API
+- `getTemplateDir()` busca `dist/templates/` (ruta correcta en paquete npm instalado)
+- `credentials:*` → `eng:credentials:*` (comandos condicionados a `deploymentsExist()`)
+- `bin/m --help` adapta categorías visibles según capacidades del proyecto (kysely, hardhat, deployments)
+- `wallet:send --function` + `--args` computa calldata automáticamente (sin `cast calldata`)
+- `wallet:*` usa `NEXT_PUBLIC_RPC_URL` de `.env` como RPC por defecto
+- RPC Celo Sepolia corregido: `forno.celo-sepolia.celo-testnet.org`
+- `cantidad` → `amount` en queries de summary (alineado con migración a inglés)
+- Removidos queries `donationsByRegion` y `totalLearningPoints` (específicos de sivel3)
+- `package.json`: `pnpm` field movido a `pnpm-workspace.yaml` (compatible pnpm 10+11)
+- pnpm v10 fijado con `packageManagerStrict: true` (v11 rompe tests React 19)
+- `xmlEscape()` en composición de imágenes para `&` y otros caracteres XML
+
+### Fixed
+- `SKILL.md` incluido en `dist/` y `package.json` `files`
+- Candado de credencial movido a esquina superior derecha
+- Nombre de credencial >20 chars usa fuente más pequeña
+- `credentials-cli.test.ts` actualizado a namespace `eng:credentials:*`
+
+## [0.6.2] - 2026-05-28
+
+### Changed
+- Raíz migra a npm: `packageManager` removido, `pnpm.overrides` → `overrides` raíz, `pnpm-workspace.yaml` y `pnpm-lock.yaml` eliminados, `package-lock.json` agregado
+- `mintCredentialWithRetry()`: parámetro `privateKey` → `account: Account` (el caller crea la cuenta)
+
+### Fixed
+- React 18→19 en `templates/apps/nextjs/package.json.hbs` (pineado a `react@19.2.7`, arregla renderizado de shadcn con `react-dom@19`)
+- Vitest 1.6.1→2.1.9 en templates y proyecto (pool `forks` por defecto, mejor isolación en OpenBSD/adJ)
+- `Makefile` `npm --dir` → `cd && pnpm install` (npm 11 en OpenBSD no soporta `--dir`)
+
+## [0.6.1] - 2026-05-23
+
+### Added
+- `mintCredentialWithRetry()` for Celo L2 nonce handling with retry logic
+- `doc/wallet-normalization.md` — wallet address normalization cross-project pattern
+- `doc/celo-nonce-handling.md` — Celo L2 nonce handling scoped to SBTs
+- `kysely-ctl` and `kysely-codegen` as root devDependencies (needed for test environment)
+- `--step N` support for `db:rollback` (runs `migrate down` N times)
+- `db:rollback [--step N]` syntax visible in help display
+- Auto-publish on GitLab commit documented in `ARCHITECTURE.md`, `CONTRIBUTING.md`, `version-bump.md`
+
+### Changed
+- `src/blockchain/README.md` long sections lifted to `doc/` with cross-reference links
+- `chain_id` in credentials commands now uses `net` directly (celoSepolia/baseSepolia — migration pending)
+- `Makefile` node_modules recreation after `refresh-scaffold` uses `rm -rf` + fresh symlinks
+- `Makefile` preserves `apps/hardhat/deployments/` during `refresh-scaffold`
+
+### Fixed
+- `kysely` and `kysely-codegen` binaries available in test project after `refresh-scaffold`
+- `@pasosdejesus/m` symlink recreated correctly after `refresh-scaffold`
+- `db:rollback --step N` works with `kysely-ctl` 0.21.0 (loops instead of `--steps` flag)
+- `CHANGELOG.md` added to `package.json` `files` for npm publication
+
+## [0.6.0] - 2026-05-22
+
+### Added
+- `db:dump` and `db:restore` commands (pg_dump -Fd)
+- `credentials:*` blockchain admin commands (list-types, mint, register-type, recompose-image, set-max-supply, set-site-uri, sync-cache, revoke-credential, grant-minter, revoke-minter)
+- `getCredentialMetadata()` cache function
+- `setCustomTokenURI()` admin function
+- `src/blockchain/img/` with site logos (learntg, sivel, stablesl)
+- `doc/migraciones-db-blockchain.md` — DB+Blockchain migration pattern
+- `doc/version-bump.md` — release checklist
+- `.gitlab-ci.yml` — CI pipeline (build, typecheck, unit, integration)
+- `db:super:createuser` test (OpenBSD only)
+- `db:super:createuser` early diagnostic when PG_SUPERUSER* missing
+- `db:rollback --step N` to revert multiple migrations
+
+### Changed
+- `db:migrate` runs all pending migrations (was: one at a time via `kysely migrate up`)
+- `hasAdminKey()` requires `CREDENTIALS_PRIVATE_KEY` (no fallback to `PRIVATE_KEY`)
+- `set-site-uri` moved to admin-only commands
+- `mintCourseSBT` simplified: 4 params (was 6)
+- `hasCredentialOnChain` uses `balanceOf` instead of `hasCredential`
+- `registerCredentialType` adds `customURI` and `maxSupply_` params
+- Documentation converted to English per policy
+- `SKILL.md` restructured by audience (chat.deepseek.com / CLI agents)
+- `list-types` and `sync-cache` use `NEXT_PUBLIC_NETWORK` as default
+- `package.json` `files` includes all `src/*/README.md` and `doc/`
+
+### Removed
+- Plop.js dependency (replaced with direct recursive copy)
+- `node-plop` and `plop` from dependencies
+
+### Fixed
+- Rollup WASM override for OpenBSD compatibility (`pnpm.overrides` in `package.json`)
+- `.env.test` preserved during `make refresh-scaffold`
+- `credentials:*` commands in `src/m.ts` properly registered with conditional display
+- `db:super:createuser` diagnostic when PG_SUPERUSER* missing
+- `make refresh-scaffold` now recreates node_modules from root
+- `kysely-ctl` and `kysely-codegen` added to root devDependencies for test environment