@pasosdejesus/m 0.24.0 → 0.26.0

package/src/e2e/README.md

@@ -123,6 +123,30 @@ await setupFullWalletMock(page, { privateKey: process.env.PRIVATE_KEY })
 await setupFullWalletMock(page, { privateKey: process.env.PRIVATE_KEY, rpcUrl: process.env.RPC_URL })
 ```
 
+**Mock parity (`m/REQ/49` 14).** Without `rpcUrl`, `eth_getTransactionReceipt` used to return
+`null`, so a spec that sends and awaits confirmation hung. Now `setupFullWalletMock` (and
+`fullWalletMockCode`) accept `fakeReceipt` (`{status, blockNumber, transactionHash, logs}`),
+`fakeCelo`, `fakeCallResult` and `fakeTxHash`:
+
+```js
+await setupFullWalletMock(page, {
+  privateKey: process.env.PRIVATE_KEY,
+  fakeReceipt: { status: '0x1', blockNumber: '0x1312D01', logs: [] },
+})
+```
+
+### In-app wallet driver (`m/REQ/49` 15)
+
+Drives the `m/wallet/next` components by their testids, so consumers do not rewrite selectors:
+
+```ts
+setupInAppWallet(page, { password, mnemonic?, privateKey?, timeoutMs? }): Promise<void>
+unlockInAppWallet(page, { password, timeoutMs? }): Promise<void>
+```
+
+With `mnemonic`/`privateKey` it switches to import mode; otherwise it creates a new wallet. It
+selects by testid/`type` (not by localized text), so it works with any `lang`.
+
 ### Local EVM node (`m/REQ/14`)
 
 ```ts
@@ -151,6 +175,40 @@ Lessons that cost time here (see also learn.tg's `doc/e2e-testing.md`):
 - **Receipt hashes**: the local node re-signs, so `setupFullWalletMock` re-keys the receipt
   under `keccak256(rawTransaction)` (the hash viem waits for).
 
+### Runner: retry and summary (`m/REQ/49` P3/P4)
+
+```sh
+./bin/m test:e2e --retry 2 --retry-delay 15000   # re-run failed specs (fresh WALLET_INDEX each)
+./bin/m test:e2e:summary /tmp/site.log /tmp/local.log   # compare two runs
+```
+
+- `--retry <N>` (default 0, or `E2E_RETRIES`): after the first pass, each failed spec is re-run
+  on its own up to N times; a spec is green **only by exit code**.
+- `--retry-delay <ms>` (default 15000): pause before each retry round.
+- `E2E_LOG_DIR` (default `/tmp`): the run writes `<dir>/e2e-<timestamp>.log` with one
+  `[e2e-result] <file> <ok|fail|skip>` line per spec per attempt (the machine-readable format).
+- `test:e2e:summary <log…>` reads those lines (or the human format for older logs) and prints a
+  row per spec, one column per log, marking `<-- difiere` when a spec's state changes between
+  runs (environmental vs product failure).
+
+### Site warmup (`m/REQ/49` P5)
+
+```ts
+warmup(baseUrl, { paths, mode?, filter?, sequentialTimeoutMs?, parallelTimeoutMs?,
+  rejectUnauthorized?, slowMs?, logger?, request? }): Promise<WarmupOutcome>
+```
+
+Two passes: compile sequentially (a cold `next dev` dies under parallel load), then verify in
+parallel. Reports routes that stay slow (>`slowMs`, default 15 s) and **does not fail on 4xx**
+(only informs). `mode: 'sequential'` runs a single pass (the learn.tg local case).
+
+```sh
+./bin/m warmup [filter] [--sequential]   # SITE_URL from env; paths from the consumer
+```
+
+The route list lives in the consumer: `e2e/warmup-paths.json` (`["/en", "/api/x"]` or
+`{"paths": […]}`) or `package.json:e2e.warmupPaths`.
+
 ## Environment Variables
 
 See [doc/e2e.md](../../../../doc/e2e.md) for full reference.

package/src/tasks/README.md

@@ -13,6 +13,7 @@ Each file in this directory exports a `runXxx()` function registered in `../m.ts
 | File | Commands | Purpose |
 |------|----------|---------|
 | `context.ts` | `ai:context` | Orchestrates the project context document (schema 1): detection, profiles, filters, budget and output |
+| `base-model.ts` | `base-model:dump`, `base-model:verify` | Generates the base-model baseline from a reference and guards its derivation |
 | `context-workspaces.ts` | *(internal)* | Detects project types and workspace roots (`rails`, `nextjs`, `hardhat`, `monorepo`, `node`) |
 | `context-profiles.ts` | *(internal)* | Built-in task profiles plus JSON config loading, merging and validation |
 | `context-ignore.ts` | *(internal)* | Default exclusions, absolute secrets deny list and filter precedence |

package/src/test-utils/README.md

@@ -284,6 +284,16 @@ beforeEach(() => {
 - Mock for `pg.Pool` of PostgreSQL
 - **Lesson learned:** The `sql.val()` method is crucial for queries using template tags
 
+**Builder coverage (`m/REQ/49` U1):** `MockKysely`/`apiDbMocks` ahora cubren lo que usan las
+rutas reales, así que puedes **borrar tu `GlobalMockKysely` escrito a mano**:
+- `eb.or`/`eb.and`/`eb.not`/`eb.exists` y el callback `eb('col', 'in', cb => …)`. Si tienes el mock
+  de `kysely` a module scope, pásale `eb: apiDbMocks.mockEb` o importa `createExpressionBuilder()`.
+- `where(sql`…`)`, `having`, `groupBy` y subconsulta-como-tabla (`db.selectFrom(base.as('lb'))`).
+- `onConflict(b => b.column('id').doNothing())`, `transaction().execute(cb)` y `getExecutor()`.
+- `fn.countAll/sum/avg/max/min` (`db.select(cb)` recibe `{ fn, eb, sql }`).
+- `mockSql` (de `createMockSql()`) trae `raw`/`ref`/`val`/`literal`/`join`; `apiDbMocks.mockEb`
+  expone el `eb`. `GlobalMockKysely` se exporta como alias de `MockKysely`.
+
 ### 3. `radix-mocks.tsx` – UI Components
 
 **Purpose:** Mock Radix UI components for React component tests.
@@ -377,6 +387,24 @@ viemMocks.createPublicClient.mockReturnValue({ ... })
 - Mock chains are extensible; add new chains as needed
 - **Lesson learned:** Some functions like `privateKeyToAccount` and `formatUnits` are necessary for transaction tests
 
+### 6. `console.ts` – Silenciar ruido esperado de consola
+
+**Purpose:** Ocultar ruido esperado en las pruebas (reintentos, navegaciones canceladas,
+warnings de una dependencia simulada). Graduado de `NOISY_PATTERNS` de learn.tg (`m/REQ/49` U2).
+
+```typescript
+import { silenceConsole } from '@pasosdejesus/m/test-utils/console'
+
+const silence = silenceConsole(['[retry]', 'AbortError'])
+// … ejercita el código …
+silence.restore()
+```
+
+- `silenceConsole(patterns, opts?)`: envuelve `console.log/warn/error` (configurable con
+  `opts.methods`) y suprime la llamada cuando algún argumento contiene un patrón; el resto pasa.
+- Los argumentos no-cadena se comparan por su `message` (Error) o `String()`.
+- Devuelve `{ restore(), suppressed }`; `suppressed` guarda los argumentos suprimidos.
+
 ## Complete Usage Examples
 
 ### Configuration for API Route Tests

package/src/wallet/README.md

@@ -68,6 +68,29 @@ setDestinationsPrefix('learn.tg.pdj-wallet.')      // localStorage
 setRpName('learn.tg')                              // nombre de la credencial WebAuthn
 ```
 
+## React (`./wallet/next`)
+
+Capa React de la billetera in-app (`m/REQ/37`, graduada de `learn.tg/packages/pdj-wallet-next`):
+
+```tsx
+import {
+  useInAppWallet, InAppWalletSetup, InAppWalletUnlock, configureInAppWallet,
+} from '@pasosdejesus/m/wallet/next'
+
+// Conserva tu namespace si ya tienes billeteras creadas:
+configureInAppWallet({
+  dbName: 'learn-tg-pdj-wallet',
+  destinationsPrefix: 'learn.tg.pdj-wallet.',
+  rpName: 'learn.tg',
+})
+
+// Textos: por defecto en/es; el host puede inyectar los suyos:
+<InAppWalletSetup lang="es" messages={{ createTitle: 'Abrir cartera' }} onDone={(a) => {}} />
+```
+
+`react` es un *optional peer*: el subpath está fuera del barrel, así que importar
+`@pasosdejesus/m/wallet` no arrastra React.
+
 ## Pruebas
 
 Mocks en `@pasosdejesus/m/test-utils` (`installLocalStorage`, `installIndexedDB`,
@@ -91,6 +114,6 @@ O a mano: `import { setupWalletTests } from '@pasosdejesus/m/test-utils'; setupW
 ## Notas
 
 - Fase 1/2 de `m/REQ/14`: primitivas, estado, storage, provider, WebAuthn (L1/L2),
-  destinos y resolutor EIP-6963. La billetera integrada (hook/UI React) vive en el
-  consumidor o en un futuro `@pasosdejesus/m/wallet-react`.
+  destinos y resolutor EIP-6963. La capa React (hook + `InAppWalletSetup`/`InAppWalletUnlock`)
+  vive en el subpath `./wallet/next` (`m/REQ/37`).
 - E2E con firma real: `@pasosdejesus/m/e2e` (`injectEIP6963`, `setupFullWalletMock`).