@pasosdejesus/m 0.27.2 → 0.28.0

package/README.md

@@ -31,12 +31,12 @@ credentials). The `usdt` payment engine lives in `@pasosdejesus/usdt`.
 | Area | Commands |
 |------|----------|
 | Scaffolding | `m:create`, `m:update` |
-| Database (PostgreSQL + Kysely) | `db:create`, `db:migrate`, `db:rollback`, `db:dump`, `db:restore`, `db:structure:dump/load`, `db:check`, `db:console`, `db:test` |
+| Database (PostgreSQL + Kysely) | `db:create`, `db:migrate`, `db:rollback`, `db:dump`, `db:restore`, `db:structure:dump/load`, `db:console`, `db:test`, `db:seed` |
 | Wallet (replaces `cast` on OpenBSD) | `wallet:generate`, `wallet:import`, `wallet:list`, `wallet:balance`, `wallet:send`, `wallet:approve`, `wallet:call`, `wallet:sign`, `wallet:broadcast`, `wallet:keccak`, `wallet:derive` — keys in `~/.m/wallets/` with `chmod 600` |
 | Contracts | `contract:test` (EVM via `@pasosdejesus/edr`, no native binaries) |
 | AI tooling | `ai:context`, `ai:readfile`, `ai:writefile`, `ai:edit`, `ai:grep`, `ai:glob` |
 | Requirements | `req:list`, `req:show`, `req:cross`, `req:compare`, `req:sync-from-repo`, `req:sync-to-repo`, `req:list-repo`, `req:create`, `req:close` |
-| Engines | `m:create engine`, `eng:list`, `eng:check`, `eng:wba:setup`, `eng:credentials:setup` |
+| Engines | `m:create engine`, `eng:list`, `eng:sync`, `eng:verify`, `eng:check`, `eng:setup`, `eng:wba:setup`, `eng:credentials:setup`, `eng:msip:setup`, `eng:msip:seed` |
 | Environment | `env:diff` |
 
 Subpath exports for programmatic use: `@pasosdejesus/m/i18n`,

package/dist/CHANGELOG.md

@@ -2,6 +2,132 @@
 
 All notable changes to `@pasosdejesus/m` are documented in this file.
 
+## [0.28.0] - 2026-10-12
+
+### Changed (breaking) — Fase 1 de `m/REQ/39`
+
+- **`base-model` → `msip`, y el modelo sale de `m`:** ya no hay subpath `@pasosdejesus/m/base-model`
+  **ni `@pasosdejesus/m/msip`**: el modelo base es el motor **`@pasosdejesus/msip`** (paquete aparte,
+  versión propia) y `m` **lo resuelve al ejecutar** donde el consumidor lo tenga (vendorizado en
+  `packages/generated/msip`, o instalado). Actualizar imports (`@pasosdejesus/m/base-model` →
+  `@pasosdejesus/msip`, o a la copia vendorizada).
+- **Comandos:** la familia `base-model:*` se retira; ahora **`eng:msip:setup` / `eng:msip:baseline` /
+  `eng:msip:dump` / `eng:msip:verify`**, y **`db:check` se fusiona en `eng:check`**.
+- **`engine.json` → `m-engine.json`**: el manifiesto de un motor se descubre **si y sólo si** el
+  paquete tiene `m-engine.json` (sin `"mEngine": true` ni convención de nombre). `name`/`version`
+  salen del `package.json`; el montaje va en `mount`.
+- **Sin material específico de consumidores** en `m`: se eliminan
+  `packages/m/src/msip/references/` (`msip.ts`, `learn-tg.ts`) y el export `LEARN_TG_EXTENSIONS`; lo
+  específico se aporta en tiempo de ejecución (`--additions`/`--extensions`).
+- **Docs:** `doc/base-model-*` → `doc/engines-*`.
+
+### Added — Fase 2 de `m/REQ/39` (composición de motores)
+
+- **Dos archivos por motor:** `m-engine.json` (intención, a mano) y `m-engine.generated.ts` (hechos
+  derivados, generado por `eng:sync`). Regla de oro: lo que se deriva no se escribe a mano.
+- **`eng:sync [<motor>] [--check]`:** regenera `m-engine.generated.ts` desde las fuentes (idempotente;
+  `--check` no escribe y sale ≠ 0 si está desactualizado). Sin `<motor>`, opera sobre toda la composición.
+- **`eng:verify [<motor>]`:** guarda el generado contra las fuentes y la intención (`GENERATED_MISSING` /
+  `GENERATED_STALE`) y comprueba la propiedad de `engines.<motor>.tables` (`MISSING_ENGINE` /
+  `UNKNOWN_TABLE` / `BROKEN_REFERENCE`). El guard del baseline `msip` pasa a **`eng:msip:verify`**.
+- **Descubrimiento:** un paquete es motor **si y sólo si** tiene `m-engine.json`; `eng:list` lo halla
+  entre las dependencias y sigue el closure de `engines`.
+
+### Changed (breaking) — Fase 3 de `m/REQ/39` (el modelo `msip` sale a un motor propio)
+
+- **Nuevo paquete `@pasosdejesus/msip`** (`packages/msip`): el modelo de msip sale de `m` (`db/structure.sql`
+  con su **esquema real de 40 tablas**: `usuario` + `msip_*`), más el baseline, los pasos `forward/*`,
+  `wallet-link` y la capa de datos. Expone la forma genérica `model` (`{ version, tables, migrations }`)
+  en `@pasosdejesus/msip/model`; `model.tables` se **deriva** de `src/m-engine.generated.ts` (no de una
+  lista a mano). Un motor exporta **todo** su esquema; el recorte es del consumidor (`engines.<motor>.tables`).
+- **`eng:sync`** escribe el generado en **`src/m-engine.generated.ts`** (compilable/importable) y crea
+  el directorio si falta.
+- **Baseline derivado del esquema:** `eng:msip:dump` regenera `baseline.generated.ts` para **todas** las
+  tablas del esquema (40), y `BASE_MODEL_TABLES`/`BASE_MODEL_VERSION` se **derivan** de él.
+  `eng:msip:setup` + `db:migrate` ahora crean las **40** (antes 5). Corregido de paso: una secuencia se
+  emitía una vez por cada tabla que la prefijaba (`msip_pais` ⊂ `msip_pais_histvigencia`).
+- **Datos iniciales (`eng:msip:seed`)**: carga el seed del motor —subconjunto empaquetado
+  `db/seed.sql.gz` (catálogos + `msip_pais`/`msip_departamento`/`msip_municipio`)—; `--file <sql|gz>`
+  para el dataset completo (~104 MB, con centros poblados/veredas), `--force` recarga y `--check`
+  reporta. Atómico (`psql -1`) e idempotente.
+- **`m` ya no depende del motor `msip`:** sólo figura en sus `devDependencies` (para el monorepo), así que
+  el manifiesto **publicado** de `m` no lo menciona; sus comandos lo resuelven al ejecutar con `import()`:
+  **primero** la copia vendorizada del consumidor (`packages/generated/msip/dist`, hay que compilarla con
+  `tsc -b`) y si no el paquete instalado; si no hay ninguno, error con instrucciones. Con eso publicar `m`
+  **no obliga a publicar el motor**: `msip` queda **`private`** (su `version` sirve para **trazar
+  procedencia** —`PROVENANCE.json`, drift—, no para el registro de npm) y los consumidores lo vendorizan
+  con `eng:sync --vendor`.
+
+### Added — Fases 4–6 de `m/REQ/39`
+
+- **Vendorización `eng:sync <motor> --vendor [--out <dir>]`:** copia trazable de un motor a
+  `packages/generated/<motor>` con `PROVENANCE.json` (motor, versión, origen, `sha256`); `eng:check`
+  mide el **drift** de las copias vendorizadas (`ok`/`drift`/`absent`). El descubrimiento incluye
+  `packages/generated/*`.
+- **`eng:remove <motor> [--drop]`:** quita una copia vendorizada (simétrico de `--vendor`); `--drop`
+  borra además las tablas del modelo. Test de ciclo completo (`agregar → poblar → consultar → quitar`)
+  en `tests/test-project/apps/nextjs/tests/msip-motor-lifecycle.test.ts`.
+- **Autocontención en `eng:check`:** deriva "lo usado" del código (`src/**`, `app/**`; parser de `tsc`
+  con fallback) y lo compara con lo declarado (`engines.<motor>.tables`), reportando `missing`/`extra`.
+- **Limpieza/documentación (Fase 6):** test que impide listas específicas de consumidores en `m`
+  (`src/consumers.test.ts`); docs del modelo renombrados de `base-model-*`/`engines-*` a **`doc/msip-*`**
+  (`msip-tutorial.md`, `msip-tutorial-contabilidad.md`, `msip-demo.mjs`); `doc/engines.md`, `API.md`,
+  `README.md` y `ARCHITECTURE.md` al día.
+
+### Changed — citas de requisitos y guía de agentes
+
+- **Citas `REQ/<n>` → URL del work item** en código, docs y comentarios (política en `AGENTS.md` §10):
+  los requisitos de `m` apuntan a `https://gitlab.com/pasosdeJesus/m/-/work_items/<n>`, los de learn.tg
+  a `https://github.com/pasosdeJesus/learn.tg/issues/<n>` y los de sivel3 a
+  `https://github.com/pasosdeJesus/sivel3/issues/<n>`; los enlaces de GitLab `/-/issues/<n>` pasan a
+  `/-/work_items/<n>`. El `CHANGELOG` histórico y los bloques de código con diagramas o ejemplos quedan
+  como estaban.
+- **`AGENTS.md`**: se añaden los comandos `ai:*` de asimilación (§1, con `ai:adJ` para OpenBSD/adJ), las
+  trampas estructurales (§4b), la restricción financiera (§8), el trabajo en segundo plano (§9), las
+  citas por URL de work item (§10) y las herramientas de búsqueda del proyecto (§11).
+- **Restos de `base-model` retirados del motor `msip`**: la cabecera de las migraciones generadas cita
+  `m eng:msip:setup`, la ruta pasa a `msip/forward/` y las guías hablan de la versión de `msip`.
+
+### Added — vendorización (etapa 0) verificada
+
+- **`eng:sync <motor> --vendor` emite un paquete compilable aparte**: `package.json` (con `exports` y
+  `build`/`typecheck`) y `tsconfig.json` **autónomos** en `packages/generated/<motor>`, más las
+  `dependencies`/`peerDependencies` declaradas por el motor. Así el consumidor compila el motor por
+  separado (`tsc -b`) y su app no carga ese build.
+- **`eng:check --from <dir>`**: mide el drift de las copias vendorizadas contra un **checkout** del motor
+  (carpeta del motor o `packages/<motor>`); sin original alcanzable sólo avisa. Por defecto sigue usando
+  el `source` de `PROVENANCE.json`.
+- Guía y lineamientos en `doc/engines.md` §12.1 (copia derivada, paquete aparte, drift, dependencias) y
+  nota de **fuentes futuras** (npm o subárboles git, de terceros incluidos) en `doc/diseno/engines.md`.
+  Verificado por `tests/test-project/apps/nextjs/tests/msip-motor-lifecycle.test.ts` (vendorizar →
+  compilar la copia → `eng:check --from` → quitar).
+- **Guardia "el motor declara lo que usa"** en `eng:verify`: falla con `UNDECLARED_IMPORT` si el `src/`
+  de un motor importa un paquete que no está en sus `dependencies`/`peerDependencies`/
+  `optionalDependencies` (en pruebas vale `devDependencies`). Analiza el AST (`import`/`export … from`/
+  `require`), así que **no** cuenta el texto que el motor emite dentro de plantillas (el caso de `msip`,
+  cuya migración generada importa `kysely` para el consumidor).
+
+### Fixed
+
+- **La suite de `tests/test-project` ya no ensucia el árbol**: los tests de BD (`db:migrate`,
+  `db:rollback`, `db:structure:dump`) regeneran derivados del esquema y dejaban `db/db.d.ts` (que está
+  versionado y usa `.config/kysely.config.ts`) convertido en un stub de 4 líneas, y `db/structure.sql`
+  como archivo suelto. Un `globalSetup` de vitest (`tests/test-project/apps/nextjs/tests/global-setup.ts`)
+  los fotografía al inicio de la corrida y los restaura al final (se propagó a la plantilla).
+- **Los paquetes publicados ya no incluyen pruebas**: `files` con negaciones (`!dist/**/*.test.*`,
+  `!src/**/*.test.*`, `!contracts/**/*.test.*`) en `m`, `msip` y `usdt`; antes el tarball de `m` llevaba
+  36 `*.test.js` (y `msip`/`usdt` sus fuentes de prueba). Verificado con `npm pack --dry-run`
+  ([REQ/40](https://gitlab.com/pasosdeJesus/m/-/work_items/40)).
+- **Los tipos publicados ya no mencionan el motor `msip`**: `dist/util/msip.d.ts` decía
+  `typeof import('@pasosdejesus/msip')` y un consumidor sin el motor (con `skipLibCheck: false`) no podía
+  resolverlo; ahora el tipo es local a `tasks/msip.ts` (no se emite) y `util/msip.ts` valida en ejecución
+  los símbolos que necesita (`MSIP_SYMBOLS`), descartando versiones incompatibles.
+
+- **Plantilla `bin/m` y `tests/test-project`**: el `bin/m` ahora importa `@pasosdejesus/mpdj` (como
+  documenta `ARCHITECTURE.md` §5.2). Desde la Fase 1 el plugin ya no se descubre por nombre (`@pasosdejesus/m*`)
+  y `mpdj` no trae `m-engine.json`, así que un proyecto generado perdía `ai:*`, `req:*` y
+  `eng:credentials:*`; la suite de integración lo detectó (10 fallos que ahora pasan).
+
 ## [0.27.2] - 2026-10-10
 
 ### Fixed

package/dist/compose/derive.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Motor derivation (https://gitlab.com/pasosdeJesus/m/-/work_items/39, §3.4): the facts `eng:sync` reads from a package's
+ * sources and writes into `m-engine.generated.ts`.
+ *
+ * Derivable  → generated:  `name`/`version` (package.json), `model.migrations`
+ *                          (convention), `model.tables` (the motor's reference
+ *                          structure), `contracts` (`contracts/contracts/*.sol`),
+ *                          `views` (`src/components`, `assets`).
+ * Intention  → `m-engine.json`: `mount`, `engines`, `provides`/`requires`.
+ *
+ * "Porque ¿quién de vosotros, queriendo edificar una torre, no se sienta primero y calcula los gastos…?" (Lucas 14:28)
+ */
+import type { Derived } from './manifest.js';
+/** Header of a generated file; `eng:sync` writes it verbatim. */
+export declare const GENERATED_HEADER = "// m-engine.generated.ts \u2014 generado por `eng:sync`; no editar a mano.";
+/** Name of the generated file. */
+export declare const GENERATED_FILENAME = "m-engine.generated.ts";
+/**
+ * Generated facts live under `src/` (like `baseline.generated.ts`) so they
+ * compile and can be imported by the motor's `model` subpath. `eng:sync` writes
+ * them there and `eng:verify` reads them from there.
+ */
+export declare const GENERATED_RELATIVE = "src/m-engine.generated.ts";
+/**
+ * Tablas de una estructura de referencia (`pg_dump`): `CREATE TABLE [ONLY] public.<tabla> (`.
+ * Mismo patrón que `msip/src/parse-structure.ts`; aquí sólo se derivan los **nombres** para
+ * `m-engine.generated.ts` (el inventario completo de columnas/restricciones vive en el motor).
+ */
+export declare function structureTables(sql: string): string[];
+/**
+ * Tables of a motor's own model, derived from its **reference structure**
+ * (`db/structure.sql`), never from scanning all migrations (which have
+ * `DROP`/`RENAME`). A motor with no structure has no model tables (`[]`).
+ */
+export declare function deriveTables(dir: string): string[];
+/** Migrations directory, by convention `db/migrations` when it exists. */
+export declare function deriveMigrations(dir: string): string | undefined;
+/** Solidity contract names, from `contracts/contracts/*.sol` (skipping `_`-prefixed mocks). */
+export declare function deriveContracts(dir: string): string[];
+/** Views: React components under `src/components` and an `assets` directory. */
+export declare function deriveViews(dir: string): Derived['views'];
+/** Commands the motor declares on `package.json` (`m.commands`); empty if none. */
+export declare function deriveCommands(pkg: unknown): string[];
+/**
+ * Build the derived facts of a motor. Key order is fixed so the generated file
+ * is byte-identical across runs (idempotent, diffable).
+ */
+export declare function deriveFrom(dir: string, name: string, version: string, pkg?: unknown): Derived;
+/** Render `m-engine.generated.ts` from the derived facts (pure JSON body + `as const`). */
+export declare function renderGenerated(derived: Derived): string;
+/** Read and parse the generated facts, or `null` when absent/unreadable. */
+export declare function readGenerated(dir: string): Derived | null;
+//# sourceMappingURL=derive.d.ts.map

package/dist/compose/derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../src/compose/derive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAE5C,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,+EAA0E,CAAA;AAEvG,kCAAkC;AAClC,eAAO,MAAM,kBAAkB,0BAA0B,CAAA;AAEzD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,8BAA8B,CAAA;AAK7D;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAIrD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAOlD;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEhE;AAED,+FAA+F;AAC/F,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAOrD;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYzD;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAGrD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAc7F;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAExD;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAWzD"}

package/dist/compose/derive.js

@@ -0,0 +1,128 @@
+/**
+ * Motor derivation (https://gitlab.com/pasosdeJesus/m/-/work_items/39, §3.4): the facts `eng:sync` reads from a package's
+ * sources and writes into `m-engine.generated.ts`.
+ *
+ * Derivable  → generated:  `name`/`version` (package.json), `model.migrations`
+ *                          (convention), `model.tables` (the motor's reference
+ *                          structure), `contracts` (`contracts/contracts/*.sol`),
+ *                          `views` (`src/components`, `assets`).
+ * Intention  → `m-engine.json`: `mount`, `engines`, `provides`/`requires`.
+ *
+ * "Porque ¿quién de vosotros, queriendo edificar una torre, no se sienta primero y calcula los gastos…?" (Lucas 14:28)
+ */
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+/** Header of a generated file; `eng:sync` writes it verbatim. */
+export const GENERATED_HEADER = '// m-engine.generated.ts — generado por `eng:sync`; no editar a mano.';
+/** Name of the generated file. */
+export const GENERATED_FILENAME = 'm-engine.generated.ts';
+/**
+ * Generated facts live under `src/` (like `baseline.generated.ts`) so they
+ * compile and can be imported by the motor's `model` subpath. `eng:sync` writes
+ * them there and `eng:verify` reads them from there.
+ */
+export const GENERATED_RELATIVE = `src/${GENERATED_FILENAME}`;
+/** Reference structures a motor may ship (the "current inventory", like the baseline). */
+const STRUCTURE_CANDIDATES = ['db/structure.sql', 'db/schema.sql'];
+/**
+ * Tablas de una estructura de referencia (`pg_dump`): `CREATE TABLE [ONLY] public.<tabla> (`.
+ * Mismo patrón que `msip/src/parse-structure.ts`; aquí sólo se derivan los **nombres** para
+ * `m-engine.generated.ts` (el inventario completo de columnas/restricciones vive en el motor).
+ */
+export function structureTables(sql) {
+    const found = new Set();
+    for (const match of sql.matchAll(/^CREATE TABLE (?:ONLY )?public\.(\w+) \(\r?\n/gm))
+        found.add(match[1]);
+    return [...found].sort();
+}
+/**
+ * Tables of a motor's own model, derived from its **reference structure**
+ * (`db/structure.sql`), never from scanning all migrations (which have
+ * `DROP`/`RENAME`). A motor with no structure has no model tables (`[]`).
+ */
+export function deriveTables(dir) {
+    for (const candidate of STRUCTURE_CANDIDATES) {
+        const file = join(dir, candidate);
+        if (!existsSync(file))
+            continue;
+        return structureTables(readFileSync(file, 'utf-8'));
+    }
+    return [];
+}
+/** Migrations directory, by convention `db/migrations` when it exists. */
+export function deriveMigrations(dir) {
+    return existsSync(join(dir, 'db', 'migrations')) ? 'db/migrations' : undefined;
+}
+/** Solidity contract names, from `contracts/contracts/*.sol` (skipping `_`-prefixed mocks). */
+export function deriveContracts(dir) {
+    const contractsDir = join(dir, 'contracts', 'contracts');
+    if (!existsSync(contractsDir))
+        return [];
+    return readdirSync(contractsDir)
+        .filter((file) => file.endsWith('.sol') && !file.startsWith('_'))
+        .map((file) => file.replace(/\.sol$/, ''))
+        .sort();
+}
+/** Views: React components under `src/components` and an `assets` directory. */
+export function deriveViews(dir) {
+    const componentsDir = join(dir, 'src', 'components');
+    const components = existsSync(componentsDir)
+        ? readdirSync(componentsDir)
+            .filter((file) => /\.tsx?$/.test(file) && !/\.test\./.test(file))
+            .map((file) => file.replace(/\.tsx?$/, ''))
+            .filter((name) => name !== 'index')
+            .sort()
+        : [];
+    const assets = existsSync(join(dir, 'assets')) ? 'assets' : undefined;
+    if (components.length === 0 && !assets)
+        return undefined;
+    return { components, ...(assets ? { assets } : {}) };
+}
+/** Commands the motor declares on `package.json` (`m.commands`); empty if none. */
+export function deriveCommands(pkg) {
+    const declared = pkg?.m?.commands;
+    return Array.isArray(declared) ? declared.filter((c) => typeof c === 'string') : [];
+}
+/**
+ * Build the derived facts of a motor. Key order is fixed so the generated file
+ * is byte-identical across runs (idempotent, diffable).
+ */
+export function deriveFrom(dir, name, version, pkg) {
+    const migrations = deriveMigrations(dir);
+    const derived = {
+        name,
+        version,
+        model: { tables: deriveTables(dir), ...(migrations ? { migrations } : {}) },
+    };
+    const contracts = deriveContracts(dir);
+    if (contracts.length > 0)
+        derived.contracts = contracts;
+    const commands = deriveCommands(pkg);
+    if (commands.length > 0)
+        derived.commands = commands;
+    const views = deriveViews(dir);
+    if (views)
+        derived.views = views;
+    return derived;
+}
+/** Render `m-engine.generated.ts` from the derived facts (pure JSON body + `as const`). */
+export function renderGenerated(derived) {
+    return `${GENERATED_HEADER}\nexport const engine = ${JSON.stringify(derived, null, 2)} as const;\n`;
+}
+/** Read and parse the generated facts, or `null` when absent/unreadable. */
+export function readGenerated(dir) {
+    const file = join(dir, GENERATED_RELATIVE);
+    if (!existsSync(file))
+        return null;
+    const text = readFileSync(file, 'utf-8');
+    const match = text.match(/export const engine = (\{[\s\S]*\}) as const/);
+    if (!match)
+        return null;
+    try {
+        return JSON.parse(match[1]);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=derive.js.map

package/dist/compose/derive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.js","sourceRoot":"","sources":["../../src/compose/derive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAIhC,iEAAiE;AACjE,MAAM,CAAC,MAAM,gBAAgB,GAAG,uEAAuE,CAAA;AAEvG,kCAAkC;AAClC,MAAM,CAAC,MAAM,kBAAkB,GAAG,uBAAuB,CAAA;AAEzD;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,EAAE,CAAA;AAE7D,0FAA0F;AAC1F,MAAM,oBAAoB,GAAG,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAA;AAElE;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAA;IAC/B,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,QAAQ,CAAC,iDAAiD,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IACxG,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAA;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,KAAK,MAAM,SAAS,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;QACjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAQ;QAC/B,OAAO,eAAe,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;IACrD,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAA;AAChF,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,WAAW,CAAC,CAAA;IACxD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,EAAE,CAAA;IACxC,OAAO,WAAW,CAAC,YAAY,CAAC;SAC7B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;SAChE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;SACzC,IAAI,EAAE,CAAA;AACX,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,YAAY,CAAC,CAAA;IACpD,MAAM,UAAU,GAAG,UAAU,CAAC,aAAa,CAAC;QAC1C,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC;aACvB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aAChE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;aAC1C,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,OAAO,CAAC;aAClC,IAAI,EAAE;QACX,CAAC,CAAC,EAAE,CAAA;IACN,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAA;IACrE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAA;IACxD,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;AACtD,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,MAAM,QAAQ,GAAI,GAA6C,EAAE,CAAC,EAAE,QAAQ,CAAA;IAC5E,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAClG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,IAAY,EAAE,OAAe,EAAE,GAAa;IAClF,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAA;IACxC,MAAM,OAAO,GAAY;QACvB,IAAI;QACJ,OAAO;QACP,KAAK,EAAE,EAAE,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;KAC5E,CAAA;IACD,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,CAAA;IACtC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,SAAS,GAAG,SAAS,CAAA;IACvD,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,CAAA;IACpC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAA;IACpD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;IAC9B,IAAI,KAAK;QAAE,OAAO,CAAC,KAAK,GAAG,KAAK,CAAA;IAChC,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,OAAO,GAAG,gBAAgB,2BAA2B,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,cAAc,CAAA;AACrG,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAA;IAC1C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAClC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IACxC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAA;IACxE,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IACvB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAY,CAAA;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC"}

package/dist/compose/discover.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Engine discovery (https://gitlab.com/pasosdeJesus/m/-/work_items/39, D5): a package is a motor **iff** it ships an
+ * `m-engine.json` (the file is the marker; no `mEngine` flag nor naming). `m`
+ * finds the motors among the dependencies (`packages/*`) and follows the
+ * **closure** of what each motor declares in `engines`.
+ *
+ * "Y todo lo que hagáis, hacedlo de corazón, como para el Señor y no para los hombres" (Colosenses 3:23)
+ */
+import type { EngineManifest, Intention } from './manifest.js';
+export interface PackageJson {
+    name?: string;
+    version?: string;
+    dependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+    optionalDependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+}
+/** Read `m-engine.json` (the intention), or `null` when the package is not a motor. */
+export declare function readIntention(dir: string): Intention | null;
+/** Read `package.json` (name/version), or `null` when absent/unreadable. */
+export declare function readPackageJson(dir: string): PackageJson | null;
+/** Resolve a single motor directory into a manifest (intention + derived facts). */
+export declare function readEngineManifest(dir: string, fallbackName?: string): EngineManifest | null;
+/** Discover the motors of a monorepo by reading the marker under `packages/`. */
+export declare function discoverEngines(rootDir: string): Promise<EngineManifest[]>;
+/**
+ * Closure of a set of motors: the requested motors **plus** everything they
+ * declare in `engines`, transitively. Deterministic order (roots first, then
+ * declared dependencies, depth-first).
+ */
+export declare function engineClosure(roots: readonly string[], byName: ReadonlyMap<string, EngineManifest>): EngineManifest[];
+//# sourceMappingURL=discover.d.ts.map

package/dist/compose/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/compose/discover.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9D,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACzC,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACzC;AAED,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAQ3D;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAQ/D;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAQ5F;AAED,iFAAiF;AACjF,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAoBhF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,GAC1C,cAAc,EAAE,CAalB"}

package/dist/compose/discover.js

@@ -0,0 +1,96 @@
+/**
+ * Engine discovery (https://gitlab.com/pasosdeJesus/m/-/work_items/39, D5): a package is a motor **iff** it ships an
+ * `m-engine.json` (the file is the marker; no `mEngine` flag nor naming). `m`
+ * finds the motors among the dependencies (`packages/*`) and follows the
+ * **closure** of what each motor declares in `engines`.
+ *
+ * "Y todo lo que hagáis, hacedlo de corazón, como para el Señor y no para los hombres" (Colosenses 3:23)
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { readdir } from 'node:fs/promises';
+import { basename, join } from 'node:path';
+import { deriveFrom, readGenerated } from './derive.js';
+/** Read `m-engine.json` (the intention), or `null` when the package is not a motor. */
+export function readIntention(dir) {
+    const file = join(dir, 'm-engine.json');
+    if (!existsSync(file))
+        return null;
+    try {
+        return JSON.parse(readFileSync(file, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** Read `package.json` (name/version), or `null` when absent/unreadable. */
+export function readPackageJson(dir) {
+    const file = join(dir, 'package.json');
+    if (!existsSync(file))
+        return null;
+    try {
+        return JSON.parse(readFileSync(file, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** Resolve a single motor directory into a manifest (intention + derived facts). */
+export function readEngineManifest(dir, fallbackName) {
+    const intention = readIntention(dir);
+    if (!intention)
+        return null;
+    const pkg = readPackageJson(dir);
+    const name = pkg?.name ?? fallbackName ?? basename(dir);
+    const version = pkg?.version ?? '0.0.0';
+    const derived = readGenerated(dir) ?? deriveFrom(dir, name, version, pkg);
+    return { ...derived, ...intention, name, version, dir };
+}
+/** Discover the motors of a monorepo by reading the marker under `packages/`. */
+export async function discoverEngines(rootDir) {
+    const packagesDir = join(rootDir, 'packages');
+    const manifests = [];
+    const scan = async (dir) => {
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const manifest = readEngineManifest(join(dir, entry.name), entry.name);
+            if (manifest)
+                manifests.push(manifest);
+        }
+    };
+    await scan(packagesDir);
+    // Copias vendorizadas (https://gitlab.com/pasosdeJesus/m/-/work_items/39 D17): `packages/generated/<motor>`.
+    await scan(join(packagesDir, 'generated'));
+    return manifests;
+}
+/**
+ * Closure of a set of motors: the requested motors **plus** everything they
+ * declare in `engines`, transitively. Deterministic order (roots first, then
+ * declared dependencies, depth-first).
+ */
+export function engineClosure(roots, byName) {
+    const seen = new Set();
+    const out = [];
+    const visit = (name) => {
+        if (seen.has(name))
+            return;
+        seen.add(name);
+        const manifest = byName.get(name);
+        if (!manifest)
+            return;
+        out.push(manifest);
+        for (const dep of Object.keys(manifest.engines ?? {}))
+            visit(dep);
+    };
+    for (const name of roots)
+        visit(name);
+    return out;
+}
+//# sourceMappingURL=discover.js.map

package/dist/compose/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../src/compose/discover.ts"],"names":[],"mappings":"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"}

package/dist/compose/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Composición de motores (https://gitlab.com/pasosdeJesus/m/-/work_items/39) — módulo puro.
+ *
+ * `m` es un orquestador de motores: los **descubre** (por `m-engine.json`),
+ * compone, verifica y aplica. Este módulo reúne las funciones puras; el CLI
+ * (`src/tasks/engine.ts`) es sólo *glue*.
+ *
+ * "Y todo lo que hagáis, hacedlo de corazón, como para el Señor y no para los hombres" (Colosenses 3:23)
+ */
+export type { Intention, Derived, DerivedModel, DerivedViews, EngineManifest, EngineMount, EngineRef, Finding, FindingCode, SyncResult, VerifyResult, } from './manifest.js';
+export { deriveFrom, deriveTables, deriveMigrations, deriveContracts, deriveViews, deriveCommands, structureTables, renderGenerated, readGenerated, GENERATED_FILENAME, GENERATED_RELATIVE, GENERATED_HEADER, } from './derive.js';
+export { discoverEngines, readEngineManifest, readIntention, readPackageJson, engineClosure, } from './discover.js';
+export { sync } from './sync.js';
+export { verify } from './verify.js';
+export { vendor, unvendor, drift, readProvenance, structureSha, type Provenance, type DriftFinding, type DriftCode, } from './vendor.js';
+export { tablesUsed, declaredUsage, usageReport, projectSources, type DeclaredUsage, type UsageReport, } from './usage.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/compose/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/compose/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EACV,SAAS,EACT,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,WAAW,EACX,SAAS,EACT,OAAO,EACP,WAAW,EACX,UAAU,EACV,YAAY,GACb,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,cAAc,EACd,eAAe,EACf,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,aAAa,GACd,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EACL,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,YAAY,EACrD,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,GACnD,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EACtD,KAAK,aAAa,EAAE,KAAK,WAAW,GACrC,MAAM,YAAY,CAAA"}

package/dist/compose/index.js

@@ -0,0 +1,16 @@
+/**
+ * Composición de motores (https://gitlab.com/pasosdeJesus/m/-/work_items/39) — módulo puro.
+ *
+ * `m` es un orquestador de motores: los **descubre** (por `m-engine.json`),
+ * compone, verifica y aplica. Este módulo reúne las funciones puras; el CLI
+ * (`src/tasks/engine.ts`) es sólo *glue*.
+ *
+ * "Y todo lo que hagáis, hacedlo de corazón, como para el Señor y no para los hombres" (Colosenses 3:23)
+ */
+export { deriveFrom, deriveTables, deriveMigrations, deriveContracts, deriveViews, deriveCommands, structureTables, renderGenerated, readGenerated, GENERATED_FILENAME, GENERATED_RELATIVE, GENERATED_HEADER, } from './derive.js';
+export { discoverEngines, readEngineManifest, readIntention, readPackageJson, engineClosure, } from './discover.js';
+export { sync } from './sync.js';
+export { verify } from './verify.js';
+export { vendor, unvendor, drift, readProvenance, structureSha, } from './vendor.js';
+export { tablesUsed, declaredUsage, usageReport, projectSources, } from './usage.js';
+//# sourceMappingURL=index.js.map

package/dist/compose/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/compose/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,OAAO,EACL,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,cAAc,EACd,eAAe,EACf,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,aAAa,CAAA;AAEpB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,aAAa,GACd,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EACL,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,YAAY,GAEtD,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,GAEvD,MAAM,YAAY,CAAA"}

package/dist/compose/manifest.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Composición de motores (https://gitlab.com/pasosdeJesus/m/-/work_items/39) — tipos puros.
+ *
+ * Un motor se describe con **dos archivos**:
+ *   - `m-engine.json`          → **intención** (a mano): montaje, motores/tablas
+ *                                que usa, capacidades, futuros renombres.
+ *   - `m-engine.generated.ts`  → **hechos derivados** (generado por `eng:sync`):
+ *                                nombre/versión, modelo, contratos, vistas, comandos.
+ *
+ * Regla de oro: lo que se **deriva** no se escribe a mano; lo que es **intención**
+ * (y no se puede derivar) va en `m-engine.json`.
+ *
+ * "Y todo lo que hagáis, hacedlo de corazón, como para el Señor y no para los hombres" (Colosenses 3:23)
+ */
+/** Puntos de montaje del motor: prefijos de API y de rutas. Intención pura. */
+export interface EngineMount {
+    api?: string;
+    route?: string;
+}
+/** Referencia de un motor a otro: qué tablas (y columnas) usa de él. Intención pura. */
+export interface EngineRef {
+    /** Paquete que provee el motor (si difiere del alias). */
+    package?: string;
+    /** Subpath del modelo dentro del paquete (por defecto `model`). */
+    subpath?: string;
+    /** Subconjunto de tablas propias del motor que se usan (si se omite, todas). */
+    tables?: string[];
+    /** Subconjunto de columnas por tabla (si falta, todas). */
+    columns?: Record<string, string[]>;
+}
+/**
+ * `m-engine.json` — intención del motor (a mano, mínima). No repite lo derivable
+ * (`name`/`version` salen del `package.json`).
+ */
+export interface Intention {
+    mount?: EngineMount;
+    /** Capacidades que ofrece el motor (reemplazabilidad, D12 de https://gitlab.com/pasosdeJesus/m/-/work_items/39). */
+    provides?: string[];
+    /** Capacidades que necesita de otros motores. */
+    requires?: string[];
+    /** Motores de los que depende y qué tablas/columnas usa de cada uno. */
+    engines?: Record<string, EngineRef>;
+}
+/** Modelo del motor: sus tablas propias, migraciones y (a futuro) prefijo. */
+export interface DerivedModel {
+    tablePrefix?: string;
+    tables: string[];
+    migrations?: string;
+}
+/** Vistas del motor: componentes y directorio de assets. */
+export interface DerivedViews {
+    components?: string[];
+    assets?: string;
+}
+/**
+ * `m-engine.generated.ts` — hechos **derivados** de las fuentes del paquete
+ * (generado por `eng:sync`; verificado por `eng:verify`). Nunca se edita a mano.
+ */
+export interface Derived {
+    name: string;
+    version: string;
+    model: DerivedModel;
+    contracts?: string[];
+    commands?: string[];
+    views?: DerivedViews;
+}
+/** Manifiesto resuelto de un motor: intención + hechos + su directorio. */
+export interface EngineManifest extends Intention, Derived {
+    dir: string;
+}
+/** Grado de un hallazgo de verificación (análogo a los grados D6 de conformidad). */
+export type FindingCode = 'GENERATED_MISSING' | 'GENERATED_STALE' | 'MISSING_ENGINE' | 'UNKNOWN_TABLE' | 'BROKEN_REFERENCE';
+export interface Finding {
+    code: FindingCode;
+    message: string;
+    motor?: string;
+    table?: string;
+}
+/** Resultado de `eng:sync`. */
+export interface SyncResult {
+    path: string;
+    changed: boolean;
+}
+/** Resultado de `eng:verify`. */
+export interface VerifyResult {
+    ok: boolean;
+    findings: Finding[];
+}
+//# sourceMappingURL=manifest.d.ts.map

package/dist/compose/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/compose/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wFAAwF;AACxF,MAAM,WAAW,SAAS;IACxB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,oHAAoH;IACpH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CACpC;AAED,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,4DAA4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,YAAY,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,KAAK,CAAC,EAAE,YAAY,CAAA;CACrB;AAED,2EAA2E;AAC3E,MAAM,WAAW,cAAe,SAAQ,SAAS,EAAE,OAAO;IACxD,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,qFAAqF;AACrF,MAAM,MAAM,WAAW,GACnB,mBAAmB,GACnB,iBAAiB,GACjB,gBAAgB,GAChB,eAAe,GACf,kBAAkB,CAAA;AAEtB,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,+BAA+B;AAC/B,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,iCAAiC;AACjC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAA;IACX,QAAQ,EAAE,OAAO,EAAE,CAAA;CACpB"}