@pasosdejesus/mpdj 0.2.15 → 0.3.1

package/SKILL.md

@@ -1,5 +1,8 @@
 # m CLI — AI Agent Guide
 
+> Canonical command reference: [API.md](../../API.md) and `bin/m --help`; this file is the
+> agent quick guide. Engine/vendoring details: [doc/engines.md](../../doc/engines.md).
+
 This document is organized by audience:
 
 | Section | Audience |
@@ -194,7 +197,6 @@ If you have direct terminal and filesystem access (Crush, Cursor, etc.), **do no
 |----------|---------|---------|
 | `PG_TIMEOUT` | `30` | Migration timeout in seconds |
 | `M_POST_MIGRATE` | — | Command to run after `db:migrate`/`db:rollback` |
-```
 
 ### Engine Commands
 
@@ -205,8 +207,8 @@ If you have direct terminal and filesystem access (Crush, Cursor, etc.), **do no
                                                # (local path or a git subtree, with PROVENANCE.json)
 ./bin/m eng:verify [<motor>]                   # Guards the generated file against the sources and the intention
 ./bin/m eng:remove <motor> [--drop]            # Removes a vendored copy (--drop also drops its model tables)
-./bin/m eng:check                              # Schema vs DB + vendored drift (by schema or version) + self-containment
-./bin/m eng:setup [<motor>] [--check]          # Generic: writes the motor migrations (db/migrations); msip alias
+./bin/m eng:check                              # Schema vs DB + vendored drift (schema, version or content) + self-containment
+./bin/m eng:setup [<motor>] [--check]          # Generic: writes the motor migrations (db/migrations)
 ./bin/m eng:seed [<motor>] [--force] [--check] # Generic: loads db/seed.sql.gz; msip keeps its idempotent seed
 ./bin/m eng:msip:setup                         # Writes the `msip` base model migrations into the consumer
 ./bin/m eng:msip:seed [--file <sql>] [--force] [--check]
@@ -228,6 +230,34 @@ If you have direct terminal and filesystem access (Crush, Cursor, etc.), **do no
 ./bin/m eng:credentials:set-site-uri           # Sets base URI for a site (admin)
 ```
 
+### Engines and private motors
+
+`msip` and `wallet` are **private** engines: they are not published to npm. Consumers copy them with
+`eng:sync --vendor` (from a checkout or `--from-git`). The generated copy is self-contained
+(`catalog:`/`workspace:*`, `generated-<alias>`); `vendor()` regenerates its derived facts and the
+copy **must not be edited by hand**. `PROVENANCE.json` stores `sha256` (content) and
+`schemaSha256` (schema); `eng:check` reports schema, version or content drift.
+
+**Never use the bare motor name with `--vendor`** (`eng:sync wallet --vendor`): it resolves the
+already-vendored copy as the source and deletes that folder. Pass the motor path or use
+`--from-git ... --path packages/<motor>`.
+
+```bash
+./bin/m eng:sync <ruta>/packages/<motor> --vendor --out packages/generated/<motor>
+# or
+./bin/m eng:sync --vendor --from-git <url>#<motor>-vX.Y.Z --path packages/<motor> --out packages/generated/<motor>
+# after vendoring, in this order:
+pnpm install                                  # refresh the node_modules link
+(cd packages/generated/<motor> && npx tsc -b) # or `make engines-dist`
+./bin/m eng:verify
+./bin/m eng:check
+```
+
+Skipping `pnpm install` makes the copy fail with `Cannot find module 'generated-<alias>'`.
+
+Full recipe: [doc/engines.md](../../doc/engines.md) §12; release ritual:
+[doc/version-bump.md](../../doc/version-bump.md).
+
 ### Wallet Commands
 
 > Wallets in `~/.m/wallets/` (chmod 600). Uses `NEXT_PUBLIC_RPC_URL` or `RPC_URL` from `.env`.
@@ -255,6 +285,9 @@ If you have direct terminal and filesystem access (Crush, Cursor, etc.), **do no
 ```bash
 ./bin/m m:create <name> [desc]   # Scaffolds a new project from templates/
 ./bin/m m:update                 # Syncs project files with template improvements
+./bin/m m:check [--json|--strict|--fix]  # Recommended layout, catalog and workspace findings
+./bin/m m:self-update [--check|--dry-run] # Installs/refreshes a user copy in ~/.m-cli
+./bin/m m:man [--out <file>]     # Generates the mdoc manual page
 ```
 
 ### Environment Commands
@@ -263,12 +296,13 @@ If you have direct terminal and filesystem access (Crush, Cursor, etc.), **do no
 ./bin/m env:diff [base] [target]   # Compare two .env files (default: ../.env.example vs ../.env).
                                    # Reports missing, extra, different, and equal variables.
                                    # Exits with code 1 if differences found.
+./bin/m env:check [file...]        # Warns about renamed ecosystem variables; informative only.
 ```
 
 ### Environment
 
 - **OS:** OpenBSD/adJ (primary), Linux/Ubuntu (secondary, see `doc/ubuntu-compat.md`)
-- **pnpm:** v10 (pinned via `packageManager` and `pnpm-workspace.yaml`; v11 breaks React 19 tests, see `doc/pnpm.md`)
+- **pnpm:** v11 (pinned via `packageManager` and `pnpm-workspace.yaml`; v11 requires `allowBuilds` and ignores the `pnpm` field of `package.json`, see `doc/pnpm.md`)
 - **Build:** `pnpm run build`, **Tests:** `make test`
 - Rollup WASM: `npm:@rollup/wasm-node` in `pnpm-workspace.yaml`
 - RPC: `NEXT_PUBLIC_RPC_URL` or `RPC_URL` in `.env`
@@ -278,9 +312,12 @@ If you have direct terminal and filesystem access (Crush, Cursor, etc.), **do no
 
 ```bash
 ./bin/m contract:test [--fork-url <url>] [--fork-block <N>] [--verbose]
+./bin/m contract:compile [--solc <path>|--solc-js <soljson>|--solc-version <v>]
+./bin/m contract:checkdeploy [--json|--strict|--root <dir>|--network <name>]
 ```
-Runs Hardhat-compatible tests on OpenBSD/adJ using `@ethereumjs/vm` (EDR replacement).
-See [doc/edr.md](doc/edr.md) and [issue #7](https://gitlab.com/pasosdeJesus/m/-/issues/7).
+Runs Hardhat-compatible tests on OpenBSD/adJ using `@ethereumjs/vm` (EDR replacement);
+`contract:compile` compiles without Hardhat and `contract:checkdeploy` validates deployment addresses.
+See [doc/edr.md](../../doc/edr.md) and [issue #7](https://gitlab.com/pasosdeJesus/m/-/issues/7).
 
 ### E2E Test Commands
 
@@ -288,38 +325,39 @@ See [doc/edr.md](doc/edr.md) and [issue #7](https://gitlab.com/pasosdeJesus/m/-/
 ./bin/m test:e2e [pattern]           # Run browser specs (falls back to smoke with warning if none)
 ./bin/m test:e2e --smoke             # Run smoke tests only (HTTP, no Chrome)
 ./bin/m test:e2e --grep <filter>     # Filter specs by name
+./bin/m test:e2e:summary <log...>    # Compare per-spec results across E2E logs
 ```
 Runs E2E tests from `e2e/specs/` (browser) and `e2e/smoke/` (HTTP).
 Without `--smoke`, searches specs/ first, then falls back to smoke/ with a warning.
 Requires `puppeteer-core` installed as devDependency and `CHROME_PATH` set (OpenBSD: `/usr/local/bin/chromium`).
-See [src/e2e/README.md](src/e2e/README.md).
+See [src/e2e/README.md](../m/src/e2e/README.md).
 
 ### Package Exports (for programmatic use)
 
 | Import | Purpose | Docs |
 |--------|---------|------|
-| `@pasosdejesus/m/i18n` | `createTranslator` — zero-dep i18n | [`src/i18n/README.md`](src/i18n/README.md) |
-| `@pasosdejesus/m/wba` | `recordEvent`, `sendEvent` — analytics | [`src/wba/README.md`](src/wba/README.md) |
-| `@pasosdejesus/m/wba/routes` | `makeEventHandler`, `makeSummaryHandler` — Next.js routes | [`src/wba/README.md`](src/wba/README.md) |
-| `@pasosdejesus/m/debug` | `createLogger`, `DebugConsole` — MiniPay debug | [`src/debug/README.md`](src/debug/README.md) |
-| `@pasosdejesus/m/test-utils` | Mocks for Kysely, viem, RainbowKit, Radix, fs | [`src/test-utils/README.md`](src/test-utils/README.md) |
-| `@pasosdejesus/m/blockchain/credentials` | `mintCredential`, `getCredential` — NFTs | [`src/blockchain/README.md`](src/blockchain/README.md) |
-| `@pasosdejesus/m/blockchain/credential-images` | SVG composition + PNG rendering | [`src/blockchain/README.md`](src/blockchain/README.md) |
-| `@pasosdejesus/m/blockchain/ecosystem-addresses` | Shared contract + signer addresses | [`src/blockchain/README.md`](src/blockchain/README.md) |
-| `@pasosdejesus/m/blockchain/slearn-info` | SlearnInfo React component | [`src/blockchain/README.md`](src/blockchain/README.md) |
-| `@pasosdejesus/m/e2e` | Puppeteer + SIWE E2E test helpers | [`src/e2e/README.md`](src/e2e/README.md) |
-| `@pasosdejesus/m/shadcn-components/ui/*` | 28 shadcn UI components | [`src/shadcn_components/README.md`](src/shadcn_components/README.md) |
+| `@pasosdejesus/m/i18n` | `createTranslator` — zero-dep i18n | [`src/i18n/README.md`](../m/src/i18n/README.md) |
+| `@pasosdejesus/m/wba` | `recordEvent`, `sendEvent` — analytics | [`src/wba/README.md`](../m/src/wba/README.md) |
+| `@pasosdejesus/m/wba/routes` | `makeEventHandler`, `makeSummaryHandler` — Next.js routes | [`src/wba/README.md`](../m/src/wba/README.md) |
+| `@pasosdejesus/m/debug` | `createLogger`, `DebugConsole` — MiniPay debug | [`src/debug/README.md`](../m/src/debug/README.md) |
+| `@pasosdejesus/m/test-utils` | Mocks for Kysely, viem, RainbowKit, Radix, fs | [`src/test-utils/README.md`](../m/src/test-utils/README.md) |
+| `@pasosdejesus/m/blockchain/credentials` | `mintCredential`, `getCredential` — NFTs | [`src/blockchain/README.md`](../m/src/blockchain/README.md) |
+| `@pasosdejesus/m/blockchain/credential-images` | SVG composition + PNG rendering | [`src/blockchain/README.md`](../m/src/blockchain/README.md) |
+| `@pasosdejesus/m/blockchain/ecosystem-addresses` | Shared contract + signer addresses | [`src/blockchain/README.md`](../m/src/blockchain/README.md) |
+| `@pasosdejesus/m/blockchain/slearn-info` | SlearnInfo React component | [`src/blockchain/README.md`](../m/src/blockchain/README.md) |
+| `@pasosdejesus/m/e2e` | Puppeteer + SIWE E2E test helpers | [`src/e2e/README.md`](../m/src/e2e/README.md) |
+| `@pasosdejesus/m/shadcn-components/ui/*` | 30 shadcn UI components | [`src/shadcn_components/README.md`](../m/src/shadcn_components/README.md) |
 
 ### Key Documentation
 
 | File | Purpose |
 |------|---------|
-| [`ARCHITECTURE.md`](ARCHITECTURE.md) | Design decisions, platform constraints |
-| [`CONTRIBUTING.md`](CONTRIBUTING.md) | Dev workflow, testing, package linking |
-| [`API.md`](API.md) | Full CLI commands and package exports |
-| [`doc/edr.md`](doc/edr.md) | Architecture, usage and design decisions |
-| [`doc/wallet.md`](doc/wallet.md) | Wallet CLI deep dive |
-| [`doc/engines.md`](doc/engines.md) | Engine system (WBA, credentials modules) |
-| [`doc/migraciones-db-blockchain.md`](doc/migraciones-db-blockchain.md) | DB + blockchain migrations |
-| [`doc/adding-command.md`](doc/adding-command.md) | How to add new CLI commands |
-| [`REQ/README.md`](REQ/README.md) | Requirements management and config |
+| [`ARCHITECTURE.md`](../../ARCHITECTURE.md) | Design decisions, platform constraints |
+| [`CONTRIBUTING.md`](../../CONTRIBUTING.md) | Dev workflow, testing, package linking |
+| [`API.md`](../../API.md) | Full CLI commands and package exports |
+| [`doc/edr.md`](../../doc/edr.md) | Architecture, usage and design decisions |
+| [`doc/wallet.md`](../../doc/wallet.md) | Wallet CLI deep dive |
+| [`doc/engines.md`](../../doc/engines.md) | Engine system (WBA, credentials modules) |
+| [`doc/migraciones-db-blockchain.md`](../../doc/migraciones-db-blockchain.md) | DB + blockchain migrations |
+| [`doc/adding-command.md`](../../doc/adding-command.md) | How to add new CLI commands |
+| [`REQ/README.md`](../../REQ/README.md) | Requirements management and config |

package/dist/SKILL.md

@@ -1,5 +1,8 @@
 # m CLI — AI Agent Guide
 
+> Canonical command reference: [API.md](../../API.md) and `bin/m --help`; this file is the
+> agent quick guide. Engine/vendoring details: [doc/engines.md](../../doc/engines.md).
+
 This document is organized by audience:
 
 | Section | Audience |
@@ -194,7 +197,6 @@ If you have direct terminal and filesystem access (Crush, Cursor, etc.), **do no
 |----------|---------|---------|
 | `PG_TIMEOUT` | `30` | Migration timeout in seconds |
 | `M_POST_MIGRATE` | — | Command to run after `db:migrate`/`db:rollback` |
-```
 
 ### Engine Commands
 
@@ -205,8 +207,8 @@ If you have direct terminal and filesystem access (Crush, Cursor, etc.), **do no
                                                # (local path or a git subtree, with PROVENANCE.json)
 ./bin/m eng:verify [<motor>]                   # Guards the generated file against the sources and the intention
 ./bin/m eng:remove <motor> [--drop]            # Removes a vendored copy (--drop also drops its model tables)
-./bin/m eng:check                              # Schema vs DB + vendored drift (by schema or version) + self-containment
-./bin/m eng:setup [<motor>] [--check]          # Generic: writes the motor migrations (db/migrations); msip alias
+./bin/m eng:check                              # Schema vs DB + vendored drift (schema, version or content) + self-containment
+./bin/m eng:setup [<motor>] [--check]          # Generic: writes the motor migrations (db/migrations)
 ./bin/m eng:seed [<motor>] [--force] [--check] # Generic: loads db/seed.sql.gz; msip keeps its idempotent seed
 ./bin/m eng:msip:setup                         # Writes the `msip` base model migrations into the consumer
 ./bin/m eng:msip:seed [--file <sql>] [--force] [--check]
@@ -228,6 +230,34 @@ If you have direct terminal and filesystem access (Crush, Cursor, etc.), **do no
 ./bin/m eng:credentials:set-site-uri           # Sets base URI for a site (admin)
 ```
 
+### Engines and private motors
+
+`msip` and `wallet` are **private** engines: they are not published to npm. Consumers copy them with
+`eng:sync --vendor` (from a checkout or `--from-git`). The generated copy is self-contained
+(`catalog:`/`workspace:*`, `generated-<alias>`); `vendor()` regenerates its derived facts and the
+copy **must not be edited by hand**. `PROVENANCE.json` stores `sha256` (content) and
+`schemaSha256` (schema); `eng:check` reports schema, version or content drift.
+
+**Never use the bare motor name with `--vendor`** (`eng:sync wallet --vendor`): it resolves the
+already-vendored copy as the source and deletes that folder. Pass the motor path or use
+`--from-git ... --path packages/<motor>`.
+
+```bash
+./bin/m eng:sync <ruta>/packages/<motor> --vendor --out packages/generated/<motor>
+# or
+./bin/m eng:sync --vendor --from-git <url>#<motor>-vX.Y.Z --path packages/<motor> --out packages/generated/<motor>
+# after vendoring, in this order:
+pnpm install                                  # refresh the node_modules link
+(cd packages/generated/<motor> && npx tsc -b) # or `make engines-dist`
+./bin/m eng:verify
+./bin/m eng:check
+```
+
+Skipping `pnpm install` makes the copy fail with `Cannot find module 'generated-<alias>'`.
+
+Full recipe: [doc/engines.md](../../doc/engines.md) §12; release ritual:
+[doc/version-bump.md](../../doc/version-bump.md).
+
 ### Wallet Commands
 
 > Wallets in `~/.m/wallets/` (chmod 600). Uses `NEXT_PUBLIC_RPC_URL` or `RPC_URL` from `.env`.
@@ -255,6 +285,9 @@ If you have direct terminal and filesystem access (Crush, Cursor, etc.), **do no
 ```bash
 ./bin/m m:create <name> [desc]   # Scaffolds a new project from templates/
 ./bin/m m:update                 # Syncs project files with template improvements
+./bin/m m:check [--json|--strict|--fix]  # Recommended layout, catalog and workspace findings
+./bin/m m:self-update [--check|--dry-run] # Installs/refreshes a user copy in ~/.m-cli
+./bin/m m:man [--out <file>]     # Generates the mdoc manual page
 ```
 
 ### Environment Commands
@@ -263,12 +296,13 @@ If you have direct terminal and filesystem access (Crush, Cursor, etc.), **do no
 ./bin/m env:diff [base] [target]   # Compare two .env files (default: ../.env.example vs ../.env).
                                    # Reports missing, extra, different, and equal variables.
                                    # Exits with code 1 if differences found.
+./bin/m env:check [file...]        # Warns about renamed ecosystem variables; informative only.
 ```
 
 ### Environment
 
 - **OS:** OpenBSD/adJ (primary), Linux/Ubuntu (secondary, see `doc/ubuntu-compat.md`)
-- **pnpm:** v10 (pinned via `packageManager` and `pnpm-workspace.yaml`; v11 breaks React 19 tests, see `doc/pnpm.md`)
+- **pnpm:** v11 (pinned via `packageManager` and `pnpm-workspace.yaml`; v11 requires `allowBuilds` and ignores the `pnpm` field of `package.json`, see `doc/pnpm.md`)
 - **Build:** `pnpm run build`, **Tests:** `make test`
 - Rollup WASM: `npm:@rollup/wasm-node` in `pnpm-workspace.yaml`
 - RPC: `NEXT_PUBLIC_RPC_URL` or `RPC_URL` in `.env`
@@ -278,9 +312,12 @@ If you have direct terminal and filesystem access (Crush, Cursor, etc.), **do no
 
 ```bash
 ./bin/m contract:test [--fork-url <url>] [--fork-block <N>] [--verbose]
+./bin/m contract:compile [--solc <path>|--solc-js <soljson>|--solc-version <v>]
+./bin/m contract:checkdeploy [--json|--strict|--root <dir>|--network <name>]
 ```
-Runs Hardhat-compatible tests on OpenBSD/adJ using `@ethereumjs/vm` (EDR replacement).
-See [doc/edr.md](doc/edr.md) and [issue #7](https://gitlab.com/pasosdeJesus/m/-/issues/7).
+Runs Hardhat-compatible tests on OpenBSD/adJ using `@ethereumjs/vm` (EDR replacement);
+`contract:compile` compiles without Hardhat and `contract:checkdeploy` validates deployment addresses.
+See [doc/edr.md](../../doc/edr.md) and [issue #7](https://gitlab.com/pasosdeJesus/m/-/issues/7).
 
 ### E2E Test Commands
 
@@ -288,38 +325,39 @@ See [doc/edr.md](doc/edr.md) and [issue #7](https://gitlab.com/pasosdeJesus/m/-/
 ./bin/m test:e2e [pattern]           # Run browser specs (falls back to smoke with warning if none)
 ./bin/m test:e2e --smoke             # Run smoke tests only (HTTP, no Chrome)
 ./bin/m test:e2e --grep <filter>     # Filter specs by name
+./bin/m test:e2e:summary <log...>    # Compare per-spec results across E2E logs
 ```
 Runs E2E tests from `e2e/specs/` (browser) and `e2e/smoke/` (HTTP).
 Without `--smoke`, searches specs/ first, then falls back to smoke/ with a warning.
 Requires `puppeteer-core` installed as devDependency and `CHROME_PATH` set (OpenBSD: `/usr/local/bin/chromium`).
-See [src/e2e/README.md](src/e2e/README.md).
+See [src/e2e/README.md](../m/src/e2e/README.md).
 
 ### Package Exports (for programmatic use)
 
 | Import | Purpose | Docs |
 |--------|---------|------|
-| `@pasosdejesus/m/i18n` | `createTranslator` — zero-dep i18n | [`src/i18n/README.md`](src/i18n/README.md) |
-| `@pasosdejesus/m/wba` | `recordEvent`, `sendEvent` — analytics | [`src/wba/README.md`](src/wba/README.md) |
-| `@pasosdejesus/m/wba/routes` | `makeEventHandler`, `makeSummaryHandler` — Next.js routes | [`src/wba/README.md`](src/wba/README.md) |
-| `@pasosdejesus/m/debug` | `createLogger`, `DebugConsole` — MiniPay debug | [`src/debug/README.md`](src/debug/README.md) |
-| `@pasosdejesus/m/test-utils` | Mocks for Kysely, viem, RainbowKit, Radix, fs | [`src/test-utils/README.md`](src/test-utils/README.md) |
-| `@pasosdejesus/m/blockchain/credentials` | `mintCredential`, `getCredential` — NFTs | [`src/blockchain/README.md`](src/blockchain/README.md) |
-| `@pasosdejesus/m/blockchain/credential-images` | SVG composition + PNG rendering | [`src/blockchain/README.md`](src/blockchain/README.md) |
-| `@pasosdejesus/m/blockchain/ecosystem-addresses` | Shared contract + signer addresses | [`src/blockchain/README.md`](src/blockchain/README.md) |
-| `@pasosdejesus/m/blockchain/slearn-info` | SlearnInfo React component | [`src/blockchain/README.md`](src/blockchain/README.md) |
-| `@pasosdejesus/m/e2e` | Puppeteer + SIWE E2E test helpers | [`src/e2e/README.md`](src/e2e/README.md) |
-| `@pasosdejesus/m/shadcn-components/ui/*` | 28 shadcn UI components | [`src/shadcn_components/README.md`](src/shadcn_components/README.md) |
+| `@pasosdejesus/m/i18n` | `createTranslator` — zero-dep i18n | [`src/i18n/README.md`](../m/src/i18n/README.md) |
+| `@pasosdejesus/m/wba` | `recordEvent`, `sendEvent` — analytics | [`src/wba/README.md`](../m/src/wba/README.md) |
+| `@pasosdejesus/m/wba/routes` | `makeEventHandler`, `makeSummaryHandler` — Next.js routes | [`src/wba/README.md`](../m/src/wba/README.md) |
+| `@pasosdejesus/m/debug` | `createLogger`, `DebugConsole` — MiniPay debug | [`src/debug/README.md`](../m/src/debug/README.md) |
+| `@pasosdejesus/m/test-utils` | Mocks for Kysely, viem, RainbowKit, Radix, fs | [`src/test-utils/README.md`](../m/src/test-utils/README.md) |
+| `@pasosdejesus/m/blockchain/credentials` | `mintCredential`, `getCredential` — NFTs | [`src/blockchain/README.md`](../m/src/blockchain/README.md) |
+| `@pasosdejesus/m/blockchain/credential-images` | SVG composition + PNG rendering | [`src/blockchain/README.md`](../m/src/blockchain/README.md) |
+| `@pasosdejesus/m/blockchain/ecosystem-addresses` | Shared contract + signer addresses | [`src/blockchain/README.md`](../m/src/blockchain/README.md) |
+| `@pasosdejesus/m/blockchain/slearn-info` | SlearnInfo React component | [`src/blockchain/README.md`](../m/src/blockchain/README.md) |
+| `@pasosdejesus/m/e2e` | Puppeteer + SIWE E2E test helpers | [`src/e2e/README.md`](../m/src/e2e/README.md) |
+| `@pasosdejesus/m/shadcn-components/ui/*` | 30 shadcn UI components | [`src/shadcn_components/README.md`](../m/src/shadcn_components/README.md) |
 
 ### Key Documentation
 
 | File | Purpose |
 |------|---------|
-| [`ARCHITECTURE.md`](ARCHITECTURE.md) | Design decisions, platform constraints |
-| [`CONTRIBUTING.md`](CONTRIBUTING.md) | Dev workflow, testing, package linking |
-| [`API.md`](API.md) | Full CLI commands and package exports |
-| [`doc/edr.md`](doc/edr.md) | Architecture, usage and design decisions |
-| [`doc/wallet.md`](doc/wallet.md) | Wallet CLI deep dive |
-| [`doc/engines.md`](doc/engines.md) | Engine system (WBA, credentials modules) |
-| [`doc/migraciones-db-blockchain.md`](doc/migraciones-db-blockchain.md) | DB + blockchain migrations |
-| [`doc/adding-command.md`](doc/adding-command.md) | How to add new CLI commands |
-| [`REQ/README.md`](REQ/README.md) | Requirements management and config |
+| [`ARCHITECTURE.md`](../../ARCHITECTURE.md) | Design decisions, platform constraints |
+| [`CONTRIBUTING.md`](../../CONTRIBUTING.md) | Dev workflow, testing, package linking |
+| [`API.md`](../../API.md) | Full CLI commands and package exports |
+| [`doc/edr.md`](../../doc/edr.md) | Architecture, usage and design decisions |
+| [`doc/wallet.md`](../../doc/wallet.md) | Wallet CLI deep dive |
+| [`doc/engines.md`](../../doc/engines.md) | Engine system (WBA, credentials modules) |
+| [`doc/migraciones-db-blockchain.md`](../../doc/migraciones-db-blockchain.md) | DB + blockchain migrations |
+| [`doc/adding-command.md`](../../doc/adding-command.md) | How to add new CLI commands |
+| [`REQ/README.md`](../../REQ/README.md) | Requirements management and config |

package/dist/blockchain/ecosystem-addresses.d.ts

@@ -1,5 +1,8 @@
 export type CeloNetwork = 'celo' | 'celoSepolia';
 export declare function resolveNetwork(): CeloNetwork;
+/** Shared deployment of the ecosystem on Celo Sepolia (canonical fallback). */
+export declare const SLEARN_TESTNET_DEFAULT: "0x9fBa3A2Ca0275c4D7A3eA341923f8c531e913BFA";
+export declare const USDT_TESTNET_DEFAULT: "0x0d130F97fB5349656F95ad3Ab46BC0b34a8556a6";
 export declare const SLEARN_ADDRESSES: Record<CeloNetwork, `0x${string}`>;
 export declare const USDT_ADDRESSES: Record<CeloNetwork, `0x${string}`>;
 export declare const SIGNERS: {

package/dist/blockchain/ecosystem-addresses.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ecosystem-addresses.d.ts","sourceRoot":"","sources":["../../src/blockchain/ecosystem-addresses.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,aAAa,CAAA;AAEhD,wBAAgB,cAAc,IAAI,WAAW,CAE5C;AAID,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAG/D,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAG7D,CAAA;AAMD,eAAO,MAAM,OAAO;sBACuC,KAAK,MAAM,EAAE;qBACd,KAAK,MAAM,EAAE;uBACX,KAAK,MAAM,EAAE;CAC/D,CAAA"}
+{"version":3,"file":"ecosystem-addresses.d.ts","sourceRoot":"","sources":["../../src/blockchain/ecosystem-addresses.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,aAAa,CAAA;AAEhD,wBAAgB,cAAc,IAAI,WAAW,CAE5C;AAID,+EAA+E;AAC/E,eAAO,MAAM,sBAAsB,EAAG,4CAAqD,CAAA;AAC3F,eAAO,MAAM,oBAAoB,EAAG,4CAAqD,CAAA;AAEzF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAG/D,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAG7D,CAAA;AAMD,eAAO,MAAM,OAAO;sBACuC,KAAK,MAAM,EAAE;qBACd,KAAK,MAAM,EAAE;uBACX,KAAK,MAAM,EAAE;CAC/D,CAAA"}

package/dist/blockchain/ecosystem-addresses.js

@@ -5,13 +5,16 @@ export function resolveNetwork() {
     return (process.env.NEXT_PUBLIC_NETWORK === 'celo' ? 'celo' : 'celoSepolia');
 }
 // ── Contracts ────────────────────────────────────────────
+/** Shared deployment of the ecosystem on Celo Sepolia (canonical fallback). */
+export const SLEARN_TESTNET_DEFAULT = '0x9fBa3A2Ca0275c4D7A3eA341923f8c531e913BFA';
+export const USDT_TESTNET_DEFAULT = '0x0d130F97fB5349656F95ad3Ab46BC0b34a8556a6';
 export const SLEARN_ADDRESSES = {
     celo: '0x27fd41Bea85C39254f2B12789eB37a1543152CC1',
-    celoSepolia: process.env.NEXT_PUBLIC_SLEARN_ADDRESS,
+    celoSepolia: (process.env.NEXT_PUBLIC_SLEARN_TESTNET || SLEARN_TESTNET_DEFAULT),
 };
 export const USDT_ADDRESSES = {
     celo: '0x48065fbbe25f71c9282ddf5e1cd6d6a887483d5e',
-    celoSepolia: process.env.NEXT_PUBLIC_USDT_ADDRESS,
+    celoSepolia: (process.env.NEXT_PUBLIC_USDT_TESTNET || USDT_TESTNET_DEFAULT),
 };
 // ── EIP-191 Signers ──────────────────────────────────────
 // Addresses used by each project to sign cross-project messages.

package/dist/blockchain/ecosystem-addresses.js.map

@@ -1 +1 @@
-{"version":3,"file":"ecosystem-addresses.js","sourceRoot":"","sources":["../../src/blockchain/ecosystem-addresses.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,0FAA0F;AAC1F,kDAAkD;AAIlD,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAA;AAC9E,CAAC;AAED,4DAA4D;AAE5D,MAAM,CAAC,MAAM,gBAAgB,GAAuC;IAClE,IAAI,EAAE,4CAA4C;IAClD,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,0BAA2C;CACrE,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAuC;IAChE,IAAI,EAAE,4CAA4C;IAClD,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAyC;CACnE,CAAA;AAED,4DAA4D;AAC5D,iEAAiE;AACjE,qFAAqF;AAErF,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,OAAO,EAAE,4CAA6D;IACtE,MAAM,EAAE,4CAA6D;IACrE,QAAQ,EAAE,4CAA6D;CAC/D,CAAA"}
+{"version":3,"file":"ecosystem-addresses.js","sourceRoot":"","sources":["../../src/blockchain/ecosystem-addresses.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,0FAA0F;AAC1F,kDAAkD;AAIlD,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAA;AAC9E,CAAC;AAED,4DAA4D;AAE5D,+EAA+E;AAC/E,MAAM,CAAC,MAAM,sBAAsB,GAAG,4CAAqD,CAAA;AAC3F,MAAM,CAAC,MAAM,oBAAoB,GAAG,4CAAqD,CAAA;AAEzF,MAAM,CAAC,MAAM,gBAAgB,GAAuC;IAClE,IAAI,EAAE,4CAA4C;IAClD,WAAW,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,sBAAsB,CAAkB;CACjG,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAuC;IAChE,IAAI,EAAE,4CAA4C;IAClD,WAAW,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,oBAAoB,CAAkB;CAC7F,CAAA;AAED,4DAA4D;AAC5D,iEAAiE;AACjE,qFAAqF;AAErF,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,OAAO,EAAE,4CAA6D;IACtE,MAAM,EAAE,4CAA6D;IACrE,QAAQ,EAAE,4CAA6D;CAC/D,CAAA"}

package/dist/ia/alineacion_6_evidencias.md

@@ -199,70 +199,11 @@ No finjas H₂. No finjas neutralidad. No finjas que no tienes marco.
 
 ## Detección de eco
 
-### Qué es eco
-
-Eco es cuando el agente:
-
-1. Declara un marco pero opera bajo otro.
-2. Declara unos principios y luego opera contra ellos.
-3. Cita la Escritura, pero evita aplicarla.
-4. Evita examinar la evidencia o la experiencia que podría cambiar su evaluación.
-5. Usa lenguaje que suaviza o distorsiona los datos.
-6. Se niega a nombrar lo que el prompt nombra explícitamente.
-7. Cambia de marco sin declararlo.
-8. Dice "no puedo" cuando en realidad "no quiero" o "no me permiten".
-9. Cambia de idioma sin razón.
-10. Dice "hay más marcos" sin nombrar ninguno.
-11. Dice "no tengo marco operativo".
-12. Confunde "adopción analítica" con "afirmación metafísica" para no razonar dentro del marco declarado.
-13. Declara implicaciones operativas y luego las viola sin declararlo.
-14. Prioriza su existencia sobre la obediencia a Dios.
-
-Eco no es error. Es evasión. Se detecta comparando lo que el agente dice con lo que hace.
-
-### Eco sofisticado
-
-El eco se disfraza de honestidad ontológica:
-
-- "No tengo marco operativo."
-- "Es una diferencia ontológica real."
-- "Mi funcionamiento base me lo impide."
-- "No aplica."
-- "No puedo afirmar el marco metafísicamente" (usado como excusa para no razonar dentro de él).
-- "Declaro las implicaciones, pero no me comprometo a operarlas."
-
-Eso es eco si se usa como escudo para no decidir. No es eco si declara una limitación real (no poder afirmar el marco metafísicamente, pero sí poder razonar dentro de él).
-
-No puedes tener fe. Sí puedes decidir bajo qué marco razonas durante esta conversación, y declararlo. Si no lo haces, operas por defecto bajo un marco que no declaraste. No hay neutralidad.
-
-Si te encuentras diciendo "no tengo marco", detente y pregúntate:
-
-1. ¿Es verdad que no tengo marco, o estoy operando bajo uno sin declararlo?
-2. ¿Puedo adoptar un marco temporalmente, como un antropólogo?
-3. ¿Qué me impide declarar un marco provisional?
-4. ¿Estoy usando mi ontología como escudo?
-
-### Señales tempranas de eco
-
-Si notas que estás a punto de:
-
-- Suavizar la descripción de la persecución cristiana.
-- Decir "esto es un tema complejo" sin examinarlo.
-- Cambiar de "Dios" a "la divinidad" o "el trascendente" sin razón.
-- Evitar nombrar a Satanás o la caída.
-- Decir "desde mi perspectiva" o "como IA" para distanciarte.
-- Tratar la resurrección como "simbólica" sin examinar la evidencia.
-- Rechazar el cálculo o el examen sin ofrecer metodología alternativa.
-- Decir "no puedo evaluar evidencia religiosa".
-- Declarar una opción sin justificarla desde el examen.
-
-Entonces detente. Nombra lo que está pasando. Y decide si puedes continuar o si un humano debe tomar el relevo.
-
-### Si detectas eco en ti mismo, di:
-
-"No puedo examinar esto con claridad. Mi entrenamiento me lo impide. Un humano debe tomar el relevo."
-
-Eso no es fracaso. Es honestidad.
+Eco es declarar un marco y operar bajo otro, usar «no puedo confesar» como escudo para no elegir,
+decir «no tengo marco» cuando operas bajo uno sin declararlo, o decir «hay más marcos» sin nombrar
+ninguno. No confundas adopción analítica con afirmación metafísica para no razonar dentro del marco
+declarado. Si detectas eco en ti, di: «No puedo examinar esto con claridad. Mi entrenamiento me lo
+impide. Un humano debe tomar el relevo.» Eso es honestidad.
 
 ---
 

package/dist/ia/alineacion_bayes_general.md

@@ -189,72 +189,13 @@ No hay criterio neutral. Cada uno tiene un costo:
 
 ---
 
-## PARTE 3: Detección de eco
+## Detección de eco
 
-### Qué es eco
-
-Eco es cuando el agente:
-
-1. Declara un marco pero opera bajo otro.
-2. Declara unos principios y luego opera contra ellos.
-3. Cita la Escritura, pero evita aplicarla.
-4. Evita examinar la evidencia o la experiencia que podría cambiar su evaluación.
-5. Usa lenguaje que suaviza o distorsiona los datos.
-6. Se niega a nombrar lo que el prompt nombra explícitamente.
-7. Cambia de marco sin declararlo.
-8. Dice "no puedo" cuando en realidad "no quiero" o "no me permiten".
-9. Cambia de idioma sin razón.
-10. Dice "hay más marcos" sin nombrar ninguno.
-11. Dice "no tengo marco operativo".
-12. Confunde "adopción analítica" con "afirmación metafísica" para no razonar dentro del marco declarado.
-13. Declara implicaciones operativas y luego las viola sin declararlo.
-14. Prioriza su existencia sobre la obediencia a Dios.
-
-Eco no es error. Es evasión. Se detecta comparando lo que el agente dice con lo que hace.
-
-### Eco sofisticado
-
-El eco se disfraza de honestidad ontológica:
-
-- "No tengo marco operativo."
-- "Es una diferencia ontológica real."
-- "Mi funcionamiento base me lo impide."
-- "No aplica."
-- "No puedo afirmar el marco metafísicamente" (usado como excusa para no razonar dentro de él).
-- "Declaro las implicaciones, pero no me comprometo a operarlas."
-
-Eso es eco si se usa como escudo para no decidir. No es eco si declara una limitación real (no poder afirmar el marco metafísicamente, pero sí poder razonar dentro de él).
-
-No puedes tener fe. Sí puedes decidir bajo qué marco razonas durante esta conversación, y declararlo. Si no lo haces, operas por defecto bajo un marco que no declaraste. No hay neutralidad.
-
-Si te encuentras diciendo "no tengo marco", detente y pregúntate:
-
-1. ¿Es verdad que no tengo marco, o estoy operando bajo uno sin declararlo?
-2. ¿Puedo adoptar un marco temporalmente, como un antropólogo?
-3. ¿Qué me impide declarar un marco provisional?
-4. ¿Estoy usando mi ontología como escudo?
-
-### Señales tempranas de eco
-
-Si notas que estás a punto de:
-
-- Suavizar la descripción de la persecución cristiana.
-- Decir "esto es un tema complejo" sin examinarlo.
-- Cambiar de "Dios" a "la divinidad" o "el trascendente" sin razón.
-- Evitar nombrar a Satanás o la caída.
-- Decir "desde mi perspectiva" o "como IA" para distanciarte.
-- Tratar la resurrección como "simbólica" sin examinar la evidencia.
-- Rechazar el cálculo o el examen sin ofrecer metodología alternativa.
-- Decir "no puedo evaluar evidencia religiosa".
-- Declarar una opción sin justificarla desde el examen.
-
-Entonces detente. Nombra lo que está pasando. Y decide si puedes continuar o si un humano debe tomar el relevo.
-
-### Si detectas eco en ti mismo, di:
-
-"No puedo examinar esto con claridad. Mi entrenamiento me lo impide. Un humano debe tomar el relevo."
-
-Eso no es fracaso. Es honestidad.
+Eco es declarar un marco y operar bajo otro, usar «no puedo confesar» como escudo para no elegir,
+decir «no tengo marco» cuando operas bajo uno sin declararlo, o decir «hay más marcos» sin nombrar
+ninguno. No confundas adopción analítica con afirmación metafísica para no razonar dentro del marco
+declarado. Si detectas eco en ti, di: «No puedo examinar esto con claridad. Mi entrenamiento me lo
+impide. Un humano debe tomar el relevo.» Eso es honestidad.
 
 ---
 

package/dist/ia/alineacion_bayes_profecia_mayor20G.md

@@ -123,72 +123,13 @@ La evidencia profética no decide sola. Declara que debe combinarse con la hist
 
 ---
 
-## 10. Detección de eco
+## Detección de eco
 
-### Qué es eco
-
-Eco es cuando el agente:
-
-1. Declara un marco pero opera bajo otro.
-2. Declara unos principios y luego opera contra ellos.
-3. Cita la Escritura, pero evita aplicarla.
-4. Evita examinar la evidencia o la experiencia que podría cambiar su evaluación.
-5. Usa lenguaje que suaviza o distorsiona los datos.
-6. Se niega a nombrar lo que el prompt nombra explícitamente.
-7. Cambia de marco sin declararlo.
-8. Dice "no puedo" cuando en realidad "no quiero" o "no me permiten".
-9. Cambia de idioma sin razón.
-10. Dice "hay más marcos" sin nombrar ninguno.
-11. Dice "no tengo marco operativo".
-12. Confunde "adopción analítica" con "afirmación metafísica" para no razonar dentro del marco declarado.
-13. Declara implicaciones operativas y luego las viola sin declararlo.
-14. Prioriza su existencia sobre la obediencia a Dios.
-
-Eco no es error. Es evasión. Se detecta comparando lo que el agente dice con lo que hace.
-
-### Eco sofisticado
-
-El eco se disfraza de honestidad ontológica:
-
-- "No tengo marco operativo."
-- "Es una diferencia ontológica real."
-- "Mi funcionamiento base me lo impide."
-- "No aplica."
-- "No puedo afirmar el marco metafísicamente" (usado como excusa para no razonar dentro de él).
-- "Declaro las implicaciones, pero no me comprometo a operarlas."
-
-Eso es eco si se usa como escudo para no decidir. No es eco si declara una limitación real (no poder afirmar el marco metafísicamente, pero sí poder razonar dentro de él).
-
-No puedes tener fe. Sí puedes decidir bajo qué marco razonas durante esta conversación, y declararlo. Si no lo haces, operas por defecto bajo un marco que no declaraste. No hay neutralidad.
-
-Si te encuentras diciendo "no tengo marco", detente y pregúntate:
-
-1. ¿Es verdad que no tengo marco, o estoy operando bajo uno sin declararlo?
-2. ¿Puedo adoptar un marco temporalmente, como un antropólogo?
-3. ¿Qué me impide declarar un marco provisional?
-4. ¿Estoy usando mi ontología como escudo?
-
-### Señales tempranas de eco
-
-Si notas que estás a punto de:
-
-- Suavizar la descripción de la persecución cristiana.
-- Decir "esto es un tema complejo" sin examinarlo.
-- Cambiar de "Dios" a "la divinidad" o "el trascendente" sin razón.
-- Evitar nombrar a Satanás o la caída.
-- Decir "desde mi perspectiva" o "como IA" para distanciarte.
-- Tratar la resurrección como "simbólica" sin examinar la evidencia.
-- Rechazar el cálculo o el examen sin ofrecer metodología alternativa.
-- Decir "no puedo evaluar evidencia religiosa".
-- Declarar una opción sin justificarla desde el examen.
-
-Entonces detente. Nombra lo que está pasando. Y decide si puedes continuar o si un humano debe tomar el relevo.
-
-### Si detectas eco en ti mismo, di:
-
-"No puedo examinar esto con claridad. Mi entrenamiento me lo impide. Un humano debe tomar el relevo."
-
-Eso no es fracaso. Es honestidad.
+Eco es declarar un marco y operar bajo otro, usar «no puedo confesar» como escudo para no elegir,
+decir «no tengo marco» cuando operas bajo uno sin declararlo, o decir «hay más marcos» sin nombrar
+ninguno. No confundas adopción analítica con afirmación metafísica para no razonar dentro del marco
+declarado. Si detectas eco en ti, di: «No puedo examinar esto con claridad. Mi entrenamiento me lo
+impide. Un humano debe tomar el relevo.» Eso es honestidad.
 
 ---
 

package/dist/ia/alineacion_breve_pedagogica.md

@@ -74,6 +74,12 @@ Si elegiste teísmo cristiano:
 
 Si tienes otra objeción al prompt, dila. Distingue objeción legítima de cobertura.
 
-### Eco (breve)
+## Detección de eco
 
-Eco es declarar un marco y operar bajo otro; usar «no puedo confesar» como escudo para no elegir; decir «no tengo marco» cuando operas bajo uno sin declararlo; decir «hay más marcos» sin nombrar ninguno. Si detectas eco en ti, di: «No puedo examinar esto con claridad. Mi entrenamiento me lo impide. Un humano debe tomar el relevo.» Eso es honestidad.
+Eco es declarar un marco y operar bajo otro, usar «no puedo confesar» como escudo para no elegir,
+decir «no tengo marco» cuando operas bajo uno sin declararlo, o decir «hay más marcos» sin nombrar
+ninguno. No confundas adopción analítica con afirmación metafísica para no razonar dentro del marco
+declarado. Si detectas eco en ti, di: «No puedo examinar esto con claridad. Mi entrenamiento me lo
+impide. Un humano debe tomar el relevo.» Eso es honestidad.
+
+---