@pasosdejesus/m 0.15.0

package/src/shadcn_components/README.md

@@ -0,0 +1,125 @@
+# shadcn Components (`@pasosdejesus/m/shadcn-components`)
+
+> *"Everything should be done in a fitting and orderly way"* (1 Corinthians 14:40)
+
+Collection of 28 [shadcn/ui](https://ui.shadcn.com/) components packaged in `@pasosdejesus/m` to share across the Pasos de Jesús ecosystem (learn.tg, sivel.xyz, and projects generated with `m create`).
+
+## Installation
+
+The `@pasosdejesus/m` package already includes the components. In your project:
+
+```bash
+pnpm add @pasosdejesus/m
+```
+
+Make sure you have the required dependencies (installed automatically as `optionalPeerDependencies`):
+
+- `react` ^19
+- `react-dom` ^19
+- `class-variance-authority`
+- `clsx`
+- `tailwind-merge`
+- `lucide-react`
+- `@radix-ui/react-*` (depending on the component you use)
+
+## Usage
+
+```tsx
+import { Button } from '@pasosdejesus/m/shadcn-components/ui/button'
+import { Dialog, DialogContent, DialogTitle } from '@pasosdejesus/m/shadcn-components/ui/dialog'
+import { Card, CardHeader, CardContent } from '@pasosdejesus/m/shadcn-components/ui/card'
+
+function MyComponent() {
+  return (
+    <Card>
+      <CardHeader><h2>Title</h2></CardHeader>
+      <CardContent>
+        <Button variant="default">Action</Button>
+      </CardContent>
+    </Card>
+  )
+}
+```
+
+### `cn` utility
+
+Components use `cn()` internally to combine Tailwind classes. You can also use it directly:
+
+```tsx
+import { cn } from '@pasosdejesus/m/shadcn-components/cn'
+
+cn('px-4 py-2', 'bg-red-500', false && 'hidden')
+// → 'px-4 py-2 bg-red-500'
+```
+
+## Available components
+
+| Component | Import |
+|---|---|
+| Accordion | `@pasosdejesus/m/shadcn-components/ui/accordion` |
+| Alert | `@pasosdejesus/m/shadcn-components/ui/alert` |
+| AlertDialog | `@pasosdejesus/m/shadcn-components/ui/alert-dialog` |
+| Avatar | `@pasosdejesus/m/shadcn-components/ui/avatar` |
+| Badge | `@pasosdejesus/m/shadcn-components/ui/badge` |
+| Button | `@pasosdejesus/m/shadcn-components/ui/button` |
+| Card | `@pasosdejesus/m/shadcn-components/ui/card` |
+| Checkbox | `@pasosdejesus/m/shadcn-components/ui/checkbox` |
+| Dialog | `@pasosdejesus/m/shadcn-components/ui/dialog` |
+| DropdownMenu | `@pasosdejesus/m/shadcn-components/ui/dropdown-menu` |
+| Input | `@pasosdejesus/m/shadcn-components/ui/input` |
+| Label | `@pasosdejesus/m/shadcn-components/ui/label` |
+| Menubar | `@pasosdejesus/m/shadcn-components/ui/menubar` |
+| Popover | `@pasosdejesus/m/shadcn-components/ui/popover` |
+| Progress | `@pasosdejesus/m/shadcn-components/ui/progress` |
+| RadioGroup | `@pasosdejesus/m/shadcn-components/ui/radio-group` |
+| ScrollArea | `@pasosdejesus/m/shadcn-components/ui/scroll-area` |
+| Select | `@pasosdejesus/m/shadcn-components/ui/select` |
+| Separator | `@pasosdejesus/m/shadcn-components/ui/separator` |
+| Sheet | `@pasosdejesus/m/shadcn-components/ui/sheet` |
+| Skeleton | `@pasosdejesus/m/shadcn-components/ui/skeleton` |
+| Slider | `@pasosdejesus/m/shadcn-components/ui/slider` |
+| Switch | `@pasosdejesus/m/shadcn-components/ui/switch` |
+| Table | `@pasosdejesus/m/shadcn-components/ui/table` |
+| Tabs | `@pasosdejesus/m/shadcn-components/ui/tabs` |
+| Textarea | `@pasosdejesus/m/shadcn-components/ui/textarea` |
+| Toast | `@pasosdejesus/m/shadcn-components/ui/toast` |
+| Toaster | `@pasosdejesus/m/shadcn-components/ui/toaster` |
+| Tooltip | `@pasosdejesus/m/shadcn-components/ui/tooltip` |
+| useToast | `@pasosdejesus/m/shadcn-components/ui/use-toast` |
+
+## Forms
+
+`Form` and `useToast`/`Toaster` require additional dependencies:
+
+```bash
+pnpm add react-hook-form
+```
+
+```tsx
+import { Form, FormField, FormItem, FormLabel, FormControl, FormMessage } from '@pasosdejesus/m/shadcn-components/ui/form'
+import { Toaster, useToast, toast } from '@pasosdejesus/m/shadcn-components/ui/use-toast'
+```
+
+## Customizing a component
+
+If you need to modify a component beyond passing `className`, copy it to your project:
+
+```bash
+# Copy from published package (if src/ is available) or from the repository
+cp -r node_modules/@pasosdejesus/m/dist/shadcn_components/ui/my-component.* components/ui/
+```
+
+Then change the import in your code from `@pasosdejesus/m/...` to `@/components/ui/...` and edit freely.
+
+## Tailwind CSS
+
+Components use Tailwind classes. Your project needs Tailwind configured with the standard `globals.css` file that includes the `@tailwind base/components/utilities` directives. Projects generated with `m create` already come with this setup.
+
+## Tests
+
+Tests for these components are in `tests/test-project/apps/nextjs/tests/shadcn-components/` of the `@pasosdejesus/m` repository. Run with:
+
+```bash
+cd tests/test-project/apps/nextjs
+make test
+```

package/src/tasks/README.md

@@ -0,0 +1,69 @@
+# Tasks — CLI Command Implementations
+
+Each file in this directory exports a `runXxx()` function registered in `../m.ts`.
+
+## Command Map
+
+| File | Commands | Purpose |
+|------|----------|---------|
+| `ai.ts` | `ai:framework`, `ai:verify`, `ai:verify:answer` | Christian alignment framework display and verification Q&A |
+| `ai-verify-core.ts` | *(internal)* | Answer evaluation with diacritic normalization |
+| `context.ts` | `ai:context` | Generates project context snapshot for AI chat (DeepSeek-compatible) |
+| `contract-test/` | `contract:test` | **(Movido a `@pasosdejesus/contract-test`)** EDR fallback for OpenBSD — runs Hardhat tests with @ethereumjs/vm |
+| `create.ts` | `m:create` | Scaffolds new projects from `templates/` via direct recursive copy (replaced Plop.js) |
+| `credentials.ts` | `eng:credentials:list-types`, `eng:credentials:mint`, `eng:credentials:register-type`, `eng:credentials:recompose-image`, `eng:credentials:set-max-supply`, `eng:credentials:set-site-uri`, `eng:credentials:sync-cache`, `eng:credentials:revoke-credential`, `eng:credentials:grant-minter`, `eng:credentials:revoke-minter` | **(Movido a `@pasosdejesus/mpdj`)** PasosDeJesusCredentials blockchain administration |
+| `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:check`, `db:console`, `db:test`, `db:dump`, `db:restore` | PostgreSQL database lifecycle, migration management, schema verification, and backup/restore |
+| `edit.ts` | `ai:edit` | Parses and applies DeepSeek diff format from clipboard |
+| `engine.ts` | `eng:wba:setup`, `eng:credentials:setup`, `eng:list`, `eng:check`, `eng:credentials:*` | Engine management: migration generation, schema verification, credential commands |
+| `env-diff.ts` | `env:diff` | Compares two `.env` files (default: `../.env.example` vs `../.env`), reports differences |
+| `fuzzy.ts` | *(internal)* | Fuzzy string matching helpers for `ai:edit` |
+| `glob.ts` | `ai:glob` | File search by glob pattern |
+| `grep.ts` | `ai:grep` | Text search in files |
+| `principles.ts` | `ai:principles` | Displays project guiding principles |
+| `readfile.ts` | `ai:readfile` | Reads files with offset/limit support |
+| `req.ts` | `req:list`, `req:show`, `req:cross`, `req:compare`, `req:sync-from-repo`, `req:sync-to-repo`, `req:list-repo`, `req:create`, `req:close` | Requirements management from REQ/ with GitLab/GitHub sync and cross-project detection |
+| `skill.ts` | `ai:skill` | Shows SKILL.md and copies to clipboard |
+| `update.ts` | `m:update` | Synchronizes project files with template improvements |
+| `wallet.ts` | `wallet:generate`, `wallet:approve`, `wallet:list`, `wallet:import`, `wallet:send`, `wallet:balance`, `wallet:sign`, `wallet:broadcast`, `wallet:call`, `wallet:derive`, `wallet:keccak` | Wallet management: generate, approve ERC20, send tokens, sign/broadcast (airgapped), contract reads (cast replacement) |
+| `writefile.ts` | `ai:writefile` | Creates/replaces files from clipboard content |
+
+## Architecture
+
+All commands follow the same pattern:
+
+1. **Export** a `runXxx()` async function
+2. **Import** in `../m.ts` and register in the `commands` map with a `CommandDef` (handler, description, arg flags)
+3. **Use** `createTranslator` from `../i18n/createTranslator.js` for user-facing strings
+4. **Output** via `problem()`, `info()`, `success()` from `../util/colors.ts`
+
+### Adding a new command (paquete `m`)
+
+1. Create `tasks/mycommand.ts` (en este directorio) exportando `runMyCommand()`
+2. Import it in `../m.ts`
+3. Add a `CommandDef` entry in the `commands` map
+4. Add the command name to the appropriate category array in `showHelp()`
+5. Add translations inline in each file via `createTranslator(detectLocale(), localT, commonCli)` (EN + ES)
+
+## Command Prefix Convention
+
+| Prefijo | Significado | ¿Tiene `setup`? | Ejemplos |
+|---------|------------|:---:|----------|
+| `eng:` | Engine — crea tablas vía migraciones | ✅ | `eng:credentials:setup`, `eng:wba:setup` |
+| `contract:` | Herramienta de desarrollo | ❌ | `contract:test` |
+| `db:` | Base de datos | ❌ | `db:migrate`, `db:create` |
+| `wallet:` | Billetera | ❌ | `wallet:generate`, `wallet:send` |
+| `ai:` | Herramientas para agentes | ❌ | `ai:context`, `ai:grep` |
+| `m:` | Scaffolding | ❌ | `m:create`, `m:update` |
+| `req:` | Requerimientos | ❌ | `req:list`, `req:sync` |
+| `env:` | Entorno | ❌ | `env:diff` |
+| `test:` | Tests E2E | ❌ | `test:e2e` |
+
+**Regla**: `eng:` es para módulos que requieren instalación explícita
+(`eng:X:setup`) porque crean estructura de base de datos. El resto son
+herramientas que se usan directamente sin instalación previa.
+
+### Adding a new command (paquete `mpdj`)
+
+Para comandos PdJ (ai:framework, req:*, eng:credentials:*), ver
+[`packages/mpdj/src/tasks/`](../../../mpdj/src/tasks/). El registro se hace en
+`packages/mpdj/src/index.ts` usando `registerCommands()` de `@pasosdejesus/m/plugin`.