@pasosdejesus/m 0.33.0 → 0.34.1

package/man/man1/m.1

@@ -0,0 +1,212 @@
+.\" $OpenBSD$
+.Dd $Mdocdate: October 20 2026 $
+.Dt M 1
+.Os
+.Sh NAME
+.Nm m
+.Nd CLI for Next.js and Hardhat projects
+.Sh SYNOPSIS
+.Nm
+.Op Fl Vh
+.Ar command
+.Op Ar args ...
+.Sh DESCRIPTION
+The
+.Nm
+command scaffolds and manages integrated Next.js and Hardhat
+applications: projects (m:create, m:update, m:check), databases,
+engines, wallets, end-to-end tests and environment checks.
+.Sh COMMANDS
+.Ss AI
+.Bl -tag -width Ds
+.It Cm ai:context Op Ar flags
+Genera contexto del proyecto para chat IA (compatible con DeepSeek)
+.It Cm ai:edit Op Ar flags
+Aplica cambios desde el portapapeles (formato diff de DeepSeek)
+.It Cm ai:readfile Op Ar file
+Muestra contenido de archivos (como read_file de Claude Code)
+.It Cm ai:writefile Op Ar file
+Crea o reemplaza un archivo con el contenido del portapapeles
+.It Cm ai:grep Op Ar pattern
+Busca texto en archivos (grep)
+.It Cm ai:glob Op Ar pattern
+Busca archivos por patrón (glob)
+.El
+.Ss ENV
+.Bl -tag -width Ds
+.It Cm env:diff Op Ar base [target]
+Compara .env.example vs .env mostrando variables faltantes, sobrantes y
+diferentes
+.It Cm env:check Op Ar [file...]
+Avisa de variables de entorno renombradas en el ecosistema (informativo)
+.El
+.Ss Project
+.Bl -tag -width Ds
+.It Cm m:create Ar name
+Crea un nuevo proyecto
+.It Cm m:update
+Sincroniza el proyecto actual con las mejoras de las plantillas
+(interactivo)
+.It Cm m:check Op Ar --json|--strict|--fix
+Verifica la estructura del proyecto (workspace, apps/web,
+apps/contracts, catalog) y reporta hallazgos (--json, --strict, --fix)
+.El
+.Ss Help
+.Bl -tag -width Ds
+.It Cm m:man Op Ar --out <file>
+Genera la página de manual en mdoc desde el registro de comandos (--out
+<archivo>)
+.El
+.Ss Test
+.Bl -tag -width Ds
+.It Cm test:e2e:summary Op Ar output
+Muestra el resultado por spec de uno o más logs de test:e2e y los
+compara (marca las filas que difieren)
+.It Cm warmup Op Ar output
+Calienta un sitio (compila rutas en secuencial y verifica en paralelo)
+leyendo e2e/warmup-paths.json o package.json:e2e.warmupPaths.
+Opcional: filtro, --sequential
+.El
+.Ss Database
+.Bl -tag -width Ds
+.It Cm db:create
+Crea la base de datos
+.It Cm db:drop
+Elimina la base de datos
+.It Cm db:super:createuser
+Crea un superusuario para la base de datos
+.It Cm db:structure:dump
+Vuelca la estructura de la base de datos
+.It Cm db:structure:load
+Carga la estructura de la base de datos
+.It Cm db:migrate
+Ejecuta las migraciones de la base de datos
+.It Cm db:mig:make Ar name
+Crea un nuevo archivo de migración
+.It Cm db:rollback Op Ar --step N
+Revierte la última migración (--step N para revertir N)
+.It Cm db:seed
+Siembra la base de datos
+.It Cm db:console Op Ar query
+Abre una consola de base de datos
+.It Cm db:test
+Prueba la conexión a la base de datos de forma no interactiva
+.It Cm db:dump Op Ar name
+Respaldar la base de datos (datos + esquema) en db/backups/
+.It Cm db:restore Op Ar name
+Restaurar la base de datos desde un respaldo en db/backups/
+.El
+.Ss Engine
+.Bl -tag -width Ds
+.It Cm eng:list
+Lista motores disponibles
+.It Cm eng:sync
+Regenera el m-engine.generated.ts de un motor desde sus fuentes (--check
+no escribe; --vendor lo copia)
+.It Cm eng:remove
+Quita una copia vendorizada de un motor de packages/generated (--drop
+borra además sus tablas)
+.It Cm eng:verify
+Guarda el m-engine.generated.ts de un motor contra sus fuentes y su
+intención
+.It Cm eng:check
+Verifica esquemas de motores
+.It Cm eng:setup
+Escribe en el consumidor las migraciones de los motores (db/migrations);
+--check falla en CI si está atrasado
+.It Cm eng:seed
+Carga el seed de un motor (db/seed.sql.gz); msip conserva su seed
+idempotente (--force recarga, --check reporta)
+.It Cm eng:wba:setup
+Crea archivos de migración WBA
+.It Cm eng:credentials:setup
+Crea archivos de migración credentials
+.It Cm eng:msip:setup Op Ar flags
+Escribe en el consumidor las migraciones del modelo msip que faltan
+(db/migrations); --check falla en CI si está atrasado
+.It Cm eng:msip:seed Op Ar flags
+Carga los datos iniciales de msip (catálogos + geografía); --file
+<sql> para el dataset completo, --force recarga, --check reporta
+.It Cm eng:msip:baseline Op Ar flags
+Imprime el baseline publicado del modelo msip (--out <archivo> para
+guardarlo)
+.It Cm eng:msip:dump Op Ar flags
+Genera el baseline del modelo msip desde una base de referencia
+.It Cm eng:msip:verify Op Ar flags
+Verifica el baseline publicado de msip contra una estructura de
+referencia (guard de derivación + D12)
+.El
+.Ss Engine/Opwallet
+.Bl -tag -width Ds
+.It Cm eng:opwallet:generate
+Genera una nueva billetera con mnemotécnico
+.It Cm eng:opwallet:approve
+Aprueba gasto de token ERC20
+.It Cm eng:opwallet:list
+Lista billeteras almacenadas
+.It Cm eng:opwallet:import
+Importa una billetera desde mnemotécnico o clave privada
+.It Cm eng:opwallet:send
+Envía tokens nativos o ERC20
+.It Cm eng:opwallet:balance
+Consulta saldo de billetera
+.It Cm eng:opwallet:sign
+Firma una transacción offline (airgapped)
+.It Cm eng:opwallet:broadcast
+Transmite una transacción firmada
+.It Cm eng:opwallet:call
+Lee datos de un contrato inteligente
+.It Cm eng:opwallet:derive
+Deriva billetera hija desde mnemotécnico
+.It Cm eng:opwallet:keccak
+Calcula hash Keccak-256 de un texto
+.El
+.Ss Requirements
+.Bl -tag -width Ds
+.It Cm req:list
+Lista requerimientos de REQ/ con estado y cross-project
+.It Cm req:show Ar N
+Muestra un requerimiento de REQ/
+.It Cm req:cross
+Lista requerimientos con impacto cross-project
+.It Cm req:compare Op Ar N
+Compara REQ local con issue remoto (GitLab/GitHub)
+.It Cm req:sync-from-repo Ar N
+Actualiza REQ local desde issue remoto
+.It Cm req:sync-to-repo Ar N
+Actualiza issue remoto desde REQ local
+.It Cm req:list-repo
+Lista issues abiertos del repositorio remoto
+.It Cm req:create Ar title
+Crea nuevo issue remoto y REQ local (repo asigna IID)
+.It Cm req:close Ar N
+Cierra un requerimiento: sync→repo, cierra issue, elimina local
+.El
+.Sh ENVIRONMENT
+.Bl -tag -width Ds
+.It Ev PGUSER , Ev PGPASSWORD , Ev PGDATABASE
+PostgreSQL connection for the database commands and the test project.
+.It Ev E2E_RETRIES
+Default retry count for
+.Cm test:e2e .
+.It Ev E2E_LOG_DIR
+Directory for the E2E logs (default
+.Pa /tmp ) .
+.It Ev E2E_SPEC_DELAY_MS
+Delay between specs during an E2E run.
+.El
+.Sh FILES
+.Bl -tag -width Ds
+.It Pa .env
+Project environment (consumers keep it in
+.Pa apps/.env ) .
+.It Pa ~/.m/wallets/
+Encrypted operator wallets written by
+.Cm eng:opwallet:* .
+.It Pa m-extensions/
+Project-specific hooks loaded by the CLI.
+.El
+.Sh EXIT STATUS
+.Ex -std
+.Sh SEE ALSO
+.Xr sh 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pasosdejesus/m",
-  "version": "0.33.0",
+  "version": "0.34.1",
   "description": "Motor para crear y gestionar proyectos al estilo Pasos de Jesus.",
   "author": "",
   "license": "ISC",
@@ -122,6 +122,7 @@
   },
   "files": [
     "dist",
+    "man",
     "!dist/**/*.test.*",
     "src/tasks/README.md",
     "src/util/README.md",
@@ -141,7 +142,7 @@
     "picocolors": "^1.1.1"
   },
   "optionalDependencies": {
-    "@pasosdejesus/contract-test": "0.1.5",
+    "@pasosdejesus/contract-test": "0.1.7",
     "@pasosdejesus/edr": "0.1.2"
   },
   "devDependencies": {
@@ -233,7 +234,7 @@
   },
   "scripts": {
     "clean": "rm -rf dist tsconfig.tsbuildinfo",
-    "build": "rm -rf dist tsconfig.tsbuildinfo && npx tsc -b && perl -pi -e 'print \"#!/usr/bin/env node\\n\" if $. == 1 && $_ ne \"#!/usr/bin/env node\\n\"' dist/m.js && mkdir -p dist/templates dist/blockchain && cp -R templates/* dist/templates/ && cp ../../CHANGELOG.md dist/CHANGELOG.md",
+    "build": "rm -rf dist tsconfig.tsbuildinfo && npx tsc -b && perl -pi -e 'print \"#!/usr/bin/env node\\n\" if $. == 1 && $_ ne \"#!/usr/bin/env node\\n\"' dist/m.js && mkdir -p dist/templates dist/blockchain && cp -R templates/* dist/templates/ && cp ../../CHANGELOG.md dist/CHANGELOG.md && cd ../.. && node packages/m/dist/m.js m:man --out packages/m/man/man1/m.1",
     "start": "node dist/m.js m:create",
     "test": "npx vitest run",
     "typecheck": "npx tsc -b --pretty false",

package/src/tasks/README.md

@@ -21,6 +21,7 @@ Each file in this directory exports a `runXxx()` function registered in `../m.ts
 | `context-reqs.ts` | *(internal)* | Parses `REQ/*.md` and keeps only open requirements |
 | `context-render.ts` | *(internal)* | Structure and document rendering with a hard size budget |
 | `check.ts` | `m:check` | Verifies the recommended project layout (root workspace, `apps/web`, `apps/contracts`, `catalog:`) and reports findings; `--fix` applies only reversible fixes |
+| `man.ts` | `m:man` | Generates the mdoc manual page from the live command registry (`--out <file>`) |
 | `create.ts` | `m:create` | Scaffolds new projects from `templates/` via direct recursive copy (replaced Plop.js) |
 | `db.ts` | `db:create`, `db:drop`, `db:super:createuser`, `db:structure:dump`, `db:structure:load`, `db:migrate`, `db:rollback`, `db:mig:make`, `db:seed`, `db:console`, `db:test`, `db:dump`, `db:restore` | PostgreSQL database lifecycle, migration management, schema verification, and backup/restore |
 | `e2e.ts` | `test:e2e` | E2E tests (Puppeteer specs, axios smoke) |