@pasosdejesus/mpdj 0.1.0

package/LICENSE.md

@@ -0,0 +1,16 @@
+ISC License
+
+Copyright (c) 2020, Vladimir Támara Patiño vtamara@pasosdeJesus.org
+
+Permission to use, copy, modify, and/or distribute this software for any 
+purpose with or without fee is hereby granted, provided that the above 
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+

package/SKILL.md

@@ -0,0 +1,310 @@
+# m CLI — AI Agent Guide
+
+This document is organized by audience:
+
+| Section | Audience |
+|---------|----------|
+| [Shared commands](#shared-commands) | chat.deepseek.com **and** CLI agents |
+| [For chat.deepseek.com](#for-chatdeepseekcom) | Chat-based agents only (no filesystem access) |
+| [For CLI/API agents](#for-cliapi-agents) | Agents with native tools only (Crush, Cursor, etc.) |
+
+---
+
+## Shared commands
+
+### ai:framework [output]
+
+Displays a Christian alignment manifest (randomly chosen). Copies to clipboard.
+
+```bash
+./bin/m ai:framework
+```
+
+### ai:verify
+
+Interactive Christological verification question → answer.
+
+```bash
+./bin/m ai:verify
+./bin/m ai:verify:answer <answer>
+```
+
+### ai:principles
+
+Guiding principles: Love, Respect, Humility, Faithful Diligence (Colossians 3:23).
+
+```bash
+./bin/m ai:principles
+```
+
+### ai:skill
+
+Displays this SKILL.md file and copies it to the clipboard.
+
+```bash
+./bin/m ai:skill
+```
+
+---
+
+## For chat.deepseek.com
+
+When interacting via chat.deepseek.com **you do not have filesystem or terminal access**. The user runs commands and pastes output.
+
+### Workflow
+
+1. **Agent asks** the user to run an `ai:*` command
+2. **User runs** the command in their terminal
+3. **Content is copied** automatically to the clipboard
+4. **User pastes** into DeepSeek Chat
+5. **Agent analyzes** and responds or generates changes
+
+### ai:context
+
+Generates project context for DeepSeek Chat.
+
+```bash
+./bin/m ai:context [--full] [--limit <KB>] [--no-clip] [--output <file>]
+```
+
+**Options:**
+- `--full`: Include complete files without truncation
+- `--limit <KB>`: Maximum total size (default: 100KB)
+- `--no-clip`: Do not copy to clipboard
+- `--output <file>`: Save to file (default: contexto.md)
+
+### ai:readfile
+
+Reads files and copies content to clipboard.
+
+```bash
+./bin/m ai:readfile <file> [--head <N>] [--tail <N>] [--offset <N>] [--lines <N>] [--raw] [--no-clip]
+```
+
+### ai:writefile
+
+Creates/replaces files from clipboard content.
+
+```bash
+./bin/m ai:writefile <file>
+```
+
+### ai:edit
+
+Applies changes from clipboard (3 formats: full block, SEARCH/REPLACE, unified diff).
+
+> ⚠️ Paths are relative to current directory. `___SEARCH___` must be exact copy including whitespace. Fuzzy matching (85%).
+
+```bash
+./bin/m ai:edit
+```
+
+### ai:grep
+
+Searches text in files (or clipboard if no `--path`).
+
+```bash
+./bin/m ai:grep <pattern> [--path <dir>] [--type <ext>] [--context <N>] [--ignore-case]
+```
+
+### ai:glob
+
+File search by glob pattern.
+
+```bash
+./bin/m ai:glob <pattern> [--path <dir>] [--ignore <pattern>]
+```
+
+### Principles for chat.deepseek.com
+
+1. **Ask, don't order.**
+2. **Always use `ai:readfile` before suggesting changes.**
+3. **Use `ai:edit` with SEARCH/REPLACE** for specific changes.
+4. **NEVER assume content.** If replacement fails, `ai:edit` copies diagnostic to clipboard.
+
+### Recommended workflow
+
+```bash
+user: ./bin/m ai:context
+# agent reads context (user pastes)
+# agent generates SEARCH/REPLACE
+user: ./bin/m ai:edit
+user: ./bin/m ai:readfile src/m.ts --head 20
+```
+
+---
+
+## For CLI/API agents
+
+If you have direct terminal and filesystem access (Crush, Cursor, etc.), **do not use** `ai:readfile`, `ai:edit`, `ai:writefile`, `ai:grep`, `ai:glob`. Use your native tools.
+
+**No emojis in output.** OpenBSD/adJ terminals don't render emojis. Use `[OK]`, `[FAIL]`, `[SKIP]`, `[DONE]`, `[WARN]`, `[TODO]`.
+
+### DB Commands
+
+```bash
+./bin/m db:create                  # Creates database (PGDATABASE in .env)
+./bin/m db:drop                    # Drops database
+./bin/m db:super:createuser        # Creates PGUSER + PGDATABASE via PG_SUPERUSER (OpenBSD-tested)
+./bin/m db:migrate                 # Runs all pending Kysely migrations
+./bin/m db:mig:make <name>         # Creates a new migration file
+./bin/m db:rollback [--step N]     # Reverts N migrations (default: 1)
+./bin/m db:seed                    # Seeds database (stub)
+./bin/m db:console [query]         # Opens psql or runs a query
+./bin/m db:test                    # Verifies PostgreSQL connectivity
+./bin/m db:dump [name]             # Backs up DB (pg_dump -Fd) to db/backups/<name>/
+./bin/m db:restore [name]          # Restores from db/backups/<name>/ (no args: lists backups)
+./bin/m db:structure:dump          # Dumps schema to db/structure.sql AND regenerates db/db.d.ts
+./bin/m db:structure:load          # Loads schema from db/structure.sql into database
+./bin/m db:check                   # Verifies expected DB schemas (WBA, credentials) against actual DB
+```
+
+### Engine Commands
+
+```bash
+./bin/m eng:wba:setup                         # Creates migration files for web_event + transaction
+./bin/m eng:credentials:setup                  # Creates migration files for credential tables
+./bin/m eng:list                               # Lists available engines
+./bin/m eng:check                              # Verifies engine schemas against DB
+./bin/m eng:credentials:list-types [--network] # Lists credential types from contract
+./bin/m eng:credentials:mint                   # Mints a credential to a wallet
+./bin/m eng:credentials:register-type          # Registers a new credential type
+./bin/m eng:credentials:recompose-image        # Recreates credential image
+./bin/m eng:credentials:set-max-supply         # Sets max supply
+./bin/m eng:credentials:sync-cache             # Syncs DB cache from contract
+./bin/m eng:credentials:revoke-credential      # Revokes a credential
+./bin/m eng:credentials:grant-minter           # Grants MINTER_ROLE (admin, requires CREDENTIALS_PRIVATE_KEY)
+./bin/m eng:credentials:revoke-minter          # Revokes MINTER_ROLE (admin)
+./bin/m eng:credentials:set-site-uri           # Sets base URI for a site (admin)
+```
+
+### Wallet Commands
+
+> Wallets in `~/.m/wallets/` (chmod 600). Uses `NEXT_PUBLIC_RPC_URL` or `RPC_URL` from `.env`.
+
+```bash
+./bin/m wallet:generate --name <n> [--index 0] [--output-env <VAR>]
+./bin/m wallet:import   --name <n> [--mnemonic "..."] [--private-key 0x...] [--index 0]
+./bin/m wallet:list     [--name <n>] [--address-only] [--balance] [--network celoSepolia] [--rpc <url>]
+./bin/m wallet:balance  --name <n> [--token <addr>] [--network celoSepolia] [--rpc <url>]
+./bin/m wallet:send     --name <n> --to <addr|name> [--amount <eth>] [--token <addr>]
+                        [--function "name(type)"] [--args "v1,v2"] [--data 0x...]
+                        [--network celoSepolia] [--rpc <url>]
+./bin/m wallet:approve  --name <n> --token <addr> --spender <addr|name> --amount <n|max>
+                        [--network celoSepolia] [--rpc <url>]
+./bin/m wallet:call     --name <n> --to <addr> --function "name(type)[(returnType)]" [--args "v1"]
+                        [--network celoSepolia] [--rpc <url>]
+./bin/m wallet:sign     --name <n> --tx <json-file>
+./bin/m wallet:broadcast --signed-tx <json> [--rpc <url>]
+./bin/m wallet:keccak   <string>
+./bin/m wallet:derive   --name <parent> --as <new-name> [--index 1]
+```
+
+### Project Commands
+
+```bash
+./bin/m m:create <name> [desc]   # Scaffolds a new project from templates/
+./bin/m m:update                 # Syncs project files with template improvements
+```
+
+### Requirements Commands
+
+```bash
+./bin/m req:list                        # Lists requirements from REQ/ with status and cross-project
+./bin/m req:show <N>                    # Shows requirement REQ/N.md
+./bin/m req:cross                       # Lists requirements with cross-project impact
+./bin/m req:compare [N]                 # Compare all local vs remote, or diff of one
+./bin/m req:sync-from-repo <N>          # Updates REQ/N.md from remote issue
+./bin/m req:sync-to-repo <N>            # Updates remote issue from REQ/N.md (creates if 404)
+./bin/m req:list-repo                   # Lists open issues from remote repository
+./bin/m req:create "<título>" [tipo]     # Creates new remote issue + local REQ. tipo: R (default), F, I, P
+./bin/m req:close <N>                   # Closes requirement (sync + close issue + delete)
+```
+
+**Workflow para iniciar un requerimiento:**
+
+```bash
+# 1. Crear (issue remoto + REQ local con IID asignado por el repo)
+./bin/m req:create "Implementar login con wallet"       # → R-#N (default)
+./bin/m req:create "Bug al conectar wallet" F           # → F-#N
+
+# 2. Editar REQ/<IID>.md con detalles (a mano o con ai:edit)
+
+# 3. Sincronizar cambios al remoto
+./bin/m req:sync-to-repo <IID>
+
+# 4. Para cerrar (sync final + close issue + delete local)
+./bin/m req:close <IID>
+```
+
+Token config: `~/.config/m/gitlab-token` or `~/.config/m/github-token` (chmod 600),<br>
+or `GITLAB_TOKEN`/`GITHUB_TOKEN` env vars.
+Repo config: `~/.config/m/req-repos.json` (optional — deduced from `git remote` if absent).
+See [REQ/README.md](REQ/README.md) for full configuration details.
+
+### Environment Commands
+
+```bash
+./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.
+```
+
+### 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`)
+- **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`
+- PostgreSQL credentials for tests in `tests/test-project/apps/.env.test`
+
+### Contract Commands
+
+```bash
+./bin/m contract:test [--fork-url <url>] [--fork-block <N>] [--verbose]
+```
+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).
+
+### E2E Test Commands
+
+```bash
+./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
+```
+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).
+
+### 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) |
+
+### 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/engine.md`](doc/engine.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

@@ -0,0 +1,310 @@
+# m CLI — AI Agent Guide
+
+This document is organized by audience:
+
+| Section | Audience |
+|---------|----------|
+| [Shared commands](#shared-commands) | chat.deepseek.com **and** CLI agents |
+| [For chat.deepseek.com](#for-chatdeepseekcom) | Chat-based agents only (no filesystem access) |
+| [For CLI/API agents](#for-cliapi-agents) | Agents with native tools only (Crush, Cursor, etc.) |
+
+---
+
+## Shared commands
+
+### ai:framework [output]
+
+Displays a Christian alignment manifest (randomly chosen). Copies to clipboard.
+
+```bash
+./bin/m ai:framework
+```
+
+### ai:verify
+
+Interactive Christological verification question → answer.
+
+```bash
+./bin/m ai:verify
+./bin/m ai:verify:answer <answer>
+```
+
+### ai:principles
+
+Guiding principles: Love, Respect, Humility, Faithful Diligence (Colossians 3:23).
+
+```bash
+./bin/m ai:principles
+```
+
+### ai:skill
+
+Displays this SKILL.md file and copies it to the clipboard.
+
+```bash
+./bin/m ai:skill
+```
+
+---
+
+## For chat.deepseek.com
+
+When interacting via chat.deepseek.com **you do not have filesystem or terminal access**. The user runs commands and pastes output.
+
+### Workflow
+
+1. **Agent asks** the user to run an `ai:*` command
+2. **User runs** the command in their terminal
+3. **Content is copied** automatically to the clipboard
+4. **User pastes** into DeepSeek Chat
+5. **Agent analyzes** and responds or generates changes
+
+### ai:context
+
+Generates project context for DeepSeek Chat.
+
+```bash
+./bin/m ai:context [--full] [--limit <KB>] [--no-clip] [--output <file>]
+```
+
+**Options:**
+- `--full`: Include complete files without truncation
+- `--limit <KB>`: Maximum total size (default: 100KB)
+- `--no-clip`: Do not copy to clipboard
+- `--output <file>`: Save to file (default: contexto.md)
+
+### ai:readfile
+
+Reads files and copies content to clipboard.
+
+```bash
+./bin/m ai:readfile <file> [--head <N>] [--tail <N>] [--offset <N>] [--lines <N>] [--raw] [--no-clip]
+```
+
+### ai:writefile
+
+Creates/replaces files from clipboard content.
+
+```bash
+./bin/m ai:writefile <file>
+```
+
+### ai:edit
+
+Applies changes from clipboard (3 formats: full block, SEARCH/REPLACE, unified diff).
+
+> ⚠️ Paths are relative to current directory. `___SEARCH___` must be exact copy including whitespace. Fuzzy matching (85%).
+
+```bash
+./bin/m ai:edit
+```
+
+### ai:grep
+
+Searches text in files (or clipboard if no `--path`).
+
+```bash
+./bin/m ai:grep <pattern> [--path <dir>] [--type <ext>] [--context <N>] [--ignore-case]
+```
+
+### ai:glob
+
+File search by glob pattern.
+
+```bash
+./bin/m ai:glob <pattern> [--path <dir>] [--ignore <pattern>]
+```
+
+### Principles for chat.deepseek.com
+
+1. **Ask, don't order.**
+2. **Always use `ai:readfile` before suggesting changes.**
+3. **Use `ai:edit` with SEARCH/REPLACE** for specific changes.
+4. **NEVER assume content.** If replacement fails, `ai:edit` copies diagnostic to clipboard.
+
+### Recommended workflow
+
+```bash
+user: ./bin/m ai:context
+# agent reads context (user pastes)
+# agent generates SEARCH/REPLACE
+user: ./bin/m ai:edit
+user: ./bin/m ai:readfile src/m.ts --head 20
+```
+
+---
+
+## For CLI/API agents
+
+If you have direct terminal and filesystem access (Crush, Cursor, etc.), **do not use** `ai:readfile`, `ai:edit`, `ai:writefile`, `ai:grep`, `ai:glob`. Use your native tools.
+
+**No emojis in output.** OpenBSD/adJ terminals don't render emojis. Use `[OK]`, `[FAIL]`, `[SKIP]`, `[DONE]`, `[WARN]`, `[TODO]`.
+
+### DB Commands
+
+```bash
+./bin/m db:create                  # Creates database (PGDATABASE in .env)
+./bin/m db:drop                    # Drops database
+./bin/m db:super:createuser        # Creates PGUSER + PGDATABASE via PG_SUPERUSER (OpenBSD-tested)
+./bin/m db:migrate                 # Runs all pending Kysely migrations
+./bin/m db:mig:make <name>         # Creates a new migration file
+./bin/m db:rollback [--step N]     # Reverts N migrations (default: 1)
+./bin/m db:seed                    # Seeds database (stub)
+./bin/m db:console [query]         # Opens psql or runs a query
+./bin/m db:test                    # Verifies PostgreSQL connectivity
+./bin/m db:dump [name]             # Backs up DB (pg_dump -Fd) to db/backups/<name>/
+./bin/m db:restore [name]          # Restores from db/backups/<name>/ (no args: lists backups)
+./bin/m db:structure:dump          # Dumps schema to db/structure.sql AND regenerates db/db.d.ts
+./bin/m db:structure:load          # Loads schema from db/structure.sql into database
+./bin/m db:check                   # Verifies expected DB schemas (WBA, credentials) against actual DB
+```
+
+### Engine Commands
+
+```bash
+./bin/m eng:wba:setup                         # Creates migration files for web_event + transaction
+./bin/m eng:credentials:setup                  # Creates migration files for credential tables
+./bin/m eng:list                               # Lists available engines
+./bin/m eng:check                              # Verifies engine schemas against DB
+./bin/m eng:credentials:list-types [--network] # Lists credential types from contract
+./bin/m eng:credentials:mint                   # Mints a credential to a wallet
+./bin/m eng:credentials:register-type          # Registers a new credential type
+./bin/m eng:credentials:recompose-image        # Recreates credential image
+./bin/m eng:credentials:set-max-supply         # Sets max supply
+./bin/m eng:credentials:sync-cache             # Syncs DB cache from contract
+./bin/m eng:credentials:revoke-credential      # Revokes a credential
+./bin/m eng:credentials:grant-minter           # Grants MINTER_ROLE (admin, requires CREDENTIALS_PRIVATE_KEY)
+./bin/m eng:credentials:revoke-minter          # Revokes MINTER_ROLE (admin)
+./bin/m eng:credentials:set-site-uri           # Sets base URI for a site (admin)
+```
+
+### Wallet Commands
+
+> Wallets in `~/.m/wallets/` (chmod 600). Uses `NEXT_PUBLIC_RPC_URL` or `RPC_URL` from `.env`.
+
+```bash
+./bin/m wallet:generate --name <n> [--index 0] [--output-env <VAR>]
+./bin/m wallet:import   --name <n> [--mnemonic "..."] [--private-key 0x...] [--index 0]
+./bin/m wallet:list     [--name <n>] [--address-only] [--balance] [--network celoSepolia] [--rpc <url>]
+./bin/m wallet:balance  --name <n> [--token <addr>] [--network celoSepolia] [--rpc <url>]
+./bin/m wallet:send     --name <n> --to <addr|name> [--amount <eth>] [--token <addr>]
+                        [--function "name(type)"] [--args "v1,v2"] [--data 0x...]
+                        [--network celoSepolia] [--rpc <url>]
+./bin/m wallet:approve  --name <n> --token <addr> --spender <addr|name> --amount <n|max>
+                        [--network celoSepolia] [--rpc <url>]
+./bin/m wallet:call     --name <n> --to <addr> --function "name(type)[(returnType)]" [--args "v1"]
+                        [--network celoSepolia] [--rpc <url>]
+./bin/m wallet:sign     --name <n> --tx <json-file>
+./bin/m wallet:broadcast --signed-tx <json> [--rpc <url>]
+./bin/m wallet:keccak   <string>
+./bin/m wallet:derive   --name <parent> --as <new-name> [--index 1]
+```
+
+### Project Commands
+
+```bash
+./bin/m m:create <name> [desc]   # Scaffolds a new project from templates/
+./bin/m m:update                 # Syncs project files with template improvements
+```
+
+### Requirements Commands
+
+```bash
+./bin/m req:list                        # Lists requirements from REQ/ with status and cross-project
+./bin/m req:show <N>                    # Shows requirement REQ/N.md
+./bin/m req:cross                       # Lists requirements with cross-project impact
+./bin/m req:compare [N]                 # Compare all local vs remote, or diff of one
+./bin/m req:sync-from-repo <N>          # Updates REQ/N.md from remote issue
+./bin/m req:sync-to-repo <N>            # Updates remote issue from REQ/N.md (creates if 404)
+./bin/m req:list-repo                   # Lists open issues from remote repository
+./bin/m req:create "<título>" [tipo]     # Creates new remote issue + local REQ. tipo: R (default), F, I, P
+./bin/m req:close <N>                   # Closes requirement (sync + close issue + delete)
+```
+
+**Workflow para iniciar un requerimiento:**
+
+```bash
+# 1. Crear (issue remoto + REQ local con IID asignado por el repo)
+./bin/m req:create "Implementar login con wallet"       # → R-#N (default)
+./bin/m req:create "Bug al conectar wallet" F           # → F-#N
+
+# 2. Editar REQ/<IID>.md con detalles (a mano o con ai:edit)
+
+# 3. Sincronizar cambios al remoto
+./bin/m req:sync-to-repo <IID>
+
+# 4. Para cerrar (sync final + close issue + delete local)
+./bin/m req:close <IID>
+```
+
+Token config: `~/.config/m/gitlab-token` or `~/.config/m/github-token` (chmod 600),<br>
+or `GITLAB_TOKEN`/`GITHUB_TOKEN` env vars.
+Repo config: `~/.config/m/req-repos.json` (optional — deduced from `git remote` if absent).
+See [REQ/README.md](REQ/README.md) for full configuration details.
+
+### Environment Commands
+
+```bash
+./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.
+```
+
+### 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`)
+- **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`
+- PostgreSQL credentials for tests in `tests/test-project/apps/.env.test`
+
+### Contract Commands
+
+```bash
+./bin/m contract:test [--fork-url <url>] [--fork-block <N>] [--verbose]
+```
+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).
+
+### E2E Test Commands
+
+```bash
+./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
+```
+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).
+
+### 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) |
+
+### 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/engine.md`](doc/engine.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 |