@pasosdejesus/m 0.27.2 → 0.29.0

package/dist/compose/git.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Fuentes git de un motor ([REQ/40](https://gitlab.com/pasosdeJesus/m/-/work_items/40) D4): `--from-git <url>#<ref>
+ * [--path <subdir>]`. Materializa (clona + checkout del ref) el repositorio en una
+ * caché por `url#ref` y devuelve la carpeta del motor, para poder vendorizarlo con
+ * procedencia trazable (`kind`, `origin`, `ref`, `version`, `sha256`).
+ *
+ * El registro de npm se evita a propósito: los motores viven en subárboles git (de
+ * pasosdejesus o de terceros) y `m` no declara dependencia de ninguno.
+ *
+ * "Porque ¿quién de vosotros, queriendo edificar una torre, no se sienta primero y calcula los gastos…?" (Lucas 14:28)
+ */
+import type { GitOrigin } from './vendor.js';
+/** Directorio raíz de la caché de checkouts (`<tmp>/m-engines/<url#ref>`). */
+export declare function gitCacheRoot(): string;
+/** `true` cuando `git` está disponible para materializar una fuente git. */
+export declare function gitAvailable(): boolean;
+/** Parsea `<url>#<ref>`; el `ref` es obligatorio. */
+export declare function parseFromGit(spec: string): {
+    url: string;
+    ref: string;
+};
+/** Carpeta de checkout (en caché) para un `url#ref`. */
+export declare function gitCheckoutDir(origin: Pick<GitOrigin, 'url' | 'ref'>, cacheRoot?: string): string;
+/**
+ * Materializa (clona + `checkout <ref>`) el repositorio y devuelve la raíz del
+ * checkout. Es idempotente: un checkout ya presente se reutiliza.
+ */
+export declare function materializeGit(origin: Pick<GitOrigin, 'url' | 'ref'>, cacheRoot?: string): string;
+/** Carpeta del motor dentro de un checkout (`<checkout>` o `<checkout>/<path>`). */
+export declare function motorInCheckout(origin: Pick<GitOrigin, 'url' | 'ref' | 'path'>, cacheRoot?: string): string;
+//# sourceMappingURL=git.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/compose/git.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,8EAA8E;AAC9E,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,IAAI,OAAO,CAGtC;AAED,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAMvE;AAeD,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAAC,EAAE,SAAS,GAAE,MAAuB,GAAG,MAAM,CAGjH;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAAC,EAAE,SAAS,GAAE,MAAuB,GAAG,MAAM,CAQjH;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC,EAAE,SAAS,GAAE,MAAuB,GAAG,MAAM,CAG3H"}

package/dist/compose/git.js

@@ -0,0 +1,71 @@
+/**
+ * Fuentes git de un motor ([REQ/40](https://gitlab.com/pasosdeJesus/m/-/work_items/40) D4): `--from-git <url>#<ref>
+ * [--path <subdir>]`. Materializa (clona + checkout del ref) el repositorio en una
+ * caché por `url#ref` y devuelve la carpeta del motor, para poder vendorizarlo con
+ * procedencia trazable (`kind`, `origin`, `ref`, `version`, `sha256`).
+ *
+ * El registro de npm se evita a propósito: los motores viven en subárboles git (de
+ * pasosdejesus o de terceros) y `m` no declara dependencia de ninguno.
+ *
+ * "Porque ¿quién de vosotros, queriendo edificar una torre, no se sienta primero y calcula los gastos…?" (Lucas 14:28)
+ */
+import { existsSync, mkdirSync } from 'node:fs';
+import { createHash } from 'node:crypto';
+import { spawnSync } from 'node:child_process';
+import { dirname, join } from 'node:path';
+import { tmpdir } from 'node:os';
+/** Directorio raíz de la caché de checkouts (`<tmp>/m-engines/<url#ref>`). */
+export function gitCacheRoot() {
+    return join(tmpdir(), 'm-engines');
+}
+/** `true` cuando `git` está disponible para materializar una fuente git. */
+export function gitAvailable() {
+    const probe = spawnSync('git', ['--version'], { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'] });
+    return probe.status === 0;
+}
+/** Parsea `<url>#<ref>`; el `ref` es obligatorio. */
+export function parseFromGit(spec) {
+    const hash = spec.lastIndexOf('#');
+    if (hash <= 0 || hash === spec.length - 1) {
+        throw new Error(`--from-git necesita <url>#<ref>: ${spec}`);
+    }
+    return { url: spec.slice(0, hash), ref: spec.slice(hash + 1) };
+}
+function runGit(args, cwd) {
+    const result = spawnSync('git', args, {
+        cwd,
+        encoding: 'utf-8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+        env: { ...process.env, GIT_TERMINAL_PROMPT: '0' },
+    });
+    if (result.status !== 0) {
+        throw new Error(`git ${args.join(' ')} falló: ${(result.stderr ?? '').toString().trim()}`);
+    }
+    return result.stdout ?? '';
+}
+/** Carpeta de checkout (en caché) para un `url#ref`. */
+export function gitCheckoutDir(origin, cacheRoot = gitCacheRoot()) {
+    const key = createHash('sha256').update(`${origin.url}#${origin.ref}`).digest('hex').slice(0, 16);
+    return join(cacheRoot, key);
+}
+/**
+ * Materializa (clona + `checkout <ref>`) el repositorio y devuelve la raíz del
+ * checkout. Es idempotente: un checkout ya presente se reutiliza.
+ */
+export function materializeGit(origin, cacheRoot = gitCacheRoot()) {
+    if (!gitAvailable())
+        throw new Error('`git` no está disponible para --from-git');
+    const dir = gitCheckoutDir(origin, cacheRoot);
+    if (existsSync(join(dir, '.git')))
+        return dir;
+    mkdirSync(dirname(dir), { recursive: true });
+    runGit(['clone', '--quiet', origin.url, dir]);
+    runGit(['checkout', '--quiet', origin.ref], dir);
+    return dir;
+}
+/** Carpeta del motor dentro de un checkout (`<checkout>` o `<checkout>/<path>`). */
+export function motorInCheckout(origin, cacheRoot = gitCacheRoot()) {
+    const root = materializeGit(origin, cacheRoot);
+    return origin.path ? join(root, origin.path) : root;
+}
+//# sourceMappingURL=git.js.map

package/dist/compose/git.js.map

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

package/dist/compose/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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, type DriftReason, type GitOrigin, } from './vendor.js';
+export { parseFromGit, materializeGit, motorInCheckout, gitCheckoutDir, gitAvailable, gitCacheRoot, } from './git.js';
+export { motorMigrationDir, motorMigrationFiles, planMigrationCopy, motorSeedFile, type MigrationPlan, } from './data.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,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,GACrF,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,GAC1F,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,iBAAiB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,aAAa,EACxE,KAAK,aAAa,GACnB,MAAM,WAAW,CAAA;AAClB,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,18 @@
+/**
+ * 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 { parseFromGit, materializeGit, motorInCheckout, gitCheckoutDir, gitAvailable, gitCacheRoot, } from './git.js';
+export { motorMigrationDir, motorMigrationFiles, planMigrationCopy, motorSeedFile, } from './data.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,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,GAC1F,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,iBAAiB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,aAAa,GAEzE,MAAM,WAAW,CAAA;AAClB,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"}

package/dist/compose/manifest.js

@@ -0,0 +1,16 @@
+/**
+ * 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)
+ */
+export {};
+//# sourceMappingURL=manifest.js.map

package/dist/compose/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/compose/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/compose/sync.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `eng:sync [<motor>] [--check]` (https://gitlab.com/pasosdeJesus/m/-/work_items/39, D3) — **genera** `m-engine.generated.ts`
+ * from the motor's sources. Idempotent: re-running with no source change is a
+ * no-op. With `--check` it writes nothing and reports whether it is stale.
+ *
+ * "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 { SyncResult } from './manifest.js';
+export declare function sync(dir: string, options?: {
+    check?: boolean;
+}): SyncResult;
+//# sourceMappingURL=sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/compose/sync.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,UAAU,CAa/E"}

package/dist/compose/sync.js

@@ -0,0 +1,27 @@
+/**
+ * `eng:sync [<motor>] [--check]` (https://gitlab.com/pasosdeJesus/m/-/work_items/39, D3) — **genera** `m-engine.generated.ts`
+ * from the motor's sources. Idempotent: re-running with no source change is a
+ * no-op. With `--check` it writes nothing and reports whether it is stale.
+ *
+ * "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, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { basename, dirname, join } from 'node:path';
+import { GENERATED_RELATIVE, deriveFrom, renderGenerated } from './derive.js';
+import { readIntention, readPackageJson } from './discover.js';
+export function sync(dir, options = {}) {
+    if (!readIntention(dir))
+        throw new Error(`not a motor (no m-engine.json): ${dir}`);
+    const pkg = readPackageJson(dir);
+    const derived = deriveFrom(dir, pkg?.name ?? basename(dir), pkg?.version ?? '0.0.0', pkg);
+    const contents = renderGenerated(derived);
+    const path = join(dir, GENERATED_RELATIVE);
+    const existing = existsSync(path) ? readFileSync(path, 'utf-8') : null;
+    const changed = existing !== contents;
+    if (!options.check && changed) {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, contents, 'utf-8');
+    }
+    return { path, changed };
+}
+//# sourceMappingURL=sync.js.map

package/dist/compose/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/compose/sync.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5E,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEnD,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAG9D,MAAM,UAAU,IAAI,CAAC,GAAW,EAAE,UAA+B,EAAE;IACjE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAA;IAClF,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,CAAA;IAChC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,OAAO,IAAI,OAAO,EAAE,GAAG,CAAC,CAAA;IACzF,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,CAAA;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAA;IAC1C,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACtE,MAAM,OAAO,GAAG,QAAQ,KAAK,QAAQ,CAAA;IACrC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,EAAE,CAAC;QAC9B,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC7C,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;IACxC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;AAC1B,CAAC"}

package/dist/compose/usage.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Autocontención (https://gitlab.com/pasosdeJesus/m/-/work_items/39 D7/§4): "lo que el proyecto usa" se deriva de sus
+ * **`import`/código** —las tablas de los motores que referencia— y se compara con
+ * lo **declarado** en su `m-engine.json` (`engines.<motor>.tables`) para reportar
+ * `missing`/`extra`.
+ *
+ * Herramienta: la API **sintáctica** de `tsc` (`ts.createSourceFile`, sin
+ * `Program`); si `typescript` no está disponible, `grep`-like por nombre. Alcance:
+ * `src/**` y `app/**`; `node_modules` fuera.
+ *
+ * "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 PackageJson } from './discover.js';
+export interface DeclaredUsage {
+    /** Unión de las tablas declaradas (`engines.<motor>.tables`). */
+    all: string[];
+    byMotor: Record<string, string[]>;
+}
+export interface UsageReport {
+    used: string[];
+    missing: string[];
+    extra: string[];
+}
+/** Fuentes del proyecto (`src/**`, `app/**`). */
+export declare function projectSources(rootDir: string): string[];
+/**
+ * Tablas (de `tables`) que el código del proyecto referencia. Con `typescript`
+ * usa el parser sintáctico (identificadores y literales de cadena); si no, un
+ * chequeo por nombre con límites de palabra.
+ */
+export declare function tablesUsed(rootDir: string, tables: readonly string[]): string[];
+/** Tablas declaradas por un proyecto en su `m-engine.json` (`engines.<motor>.tables`). */
+export declare function declaredUsage(projectDir: string): DeclaredUsage;
+/** Compara lo usado contra lo declarado: `missing` (usado y no declarado) y `extra`. */
+export declare function usageReport(used: readonly string[], declared: readonly string[]): UsageReport;
+export interface ImportFinding {
+    /** Paquete externo importado. */
+    name: string;
+    /** Archivo donde se importa (el primero que se encuentra). */
+    file: string;
+    /** `true` cuando el import está sólo en pruebas (`*.test.ts`). */
+    dev: boolean;
+}
+/** Paquete de un especificador (`@alcance/pkg/sub` → `@alcance/pkg`); `null` si es relativo o `node:`. */
+export declare function packageOf(specifier: string): string | null;
+/** Paquetes externos que importa un motor (`src/**`), con el archivo y si es sólo de pruebas. */
+export declare function importedPackages(motorDir: string): ImportFinding[];
+/**
+ * "El motor declara lo que usa": imports externos de `src/**` que no están en las
+ * `dependencies`/`peerDependencies`/`optionalDependencies` del motor (para pruebas,
+ * vale también `devDependencies`).
+ */
+export declare function undeclaredImports(motorDir: string, pkg: PackageJson | null): ImportFinding[];
+//# sourceMappingURL=usage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/compose/usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAA;AAE/D,MAAM,WAAW,aAAa;IAC5B,iEAAiE;IACjE,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAYD,iDAAiD;AACjD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAIxD;AAUD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAyB/E;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAQ/D;AAED,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,CAQ7F;AAED,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,kEAAkE;IAClE,GAAG,EAAE,OAAO,CAAA;CACb;AAED,0GAA0G;AAC1G,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK1D;AA2BD,iGAAiG;AACjG,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAelE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,GAAG,aAAa,EAAE,CAQ5F"}

package/dist/compose/usage.js

@@ -0,0 +1,167 @@
+/**
+ * Autocontención (https://gitlab.com/pasosdeJesus/m/-/work_items/39 D7/§4): "lo que el proyecto usa" se deriva de sus
+ * **`import`/código** —las tablas de los motores que referencia— y se compara con
+ * lo **declarado** en su `m-engine.json` (`engines.<motor>.tables`) para reportar
+ * `missing`/`extra`.
+ *
+ * Herramienta: la API **sintáctica** de `tsc` (`ts.createSourceFile`, sin
+ * `Program`); si `typescript` no está disponible, `grep`-like por nombre. Alcance:
+ * `src/**` y `app/**`; `node_modules` fuera.
+ *
+ * "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, readdirSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
+import { readIntention } from './discover.js';
+function walk(dir, acc) {
+    if (!existsSync(dir))
+        return;
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        if (entry.name === 'node_modules' || entry.name === 'dist' || entry.name.startsWith('.'))
+            continue;
+        const full = join(dir, entry.name);
+        if (entry.isDirectory())
+            walk(full, acc);
+        else if (/\.tsx?$/.test(entry.name) && !/\.d\.ts$/.test(entry.name))
+            acc.push(full);
+    }
+}
+/** Fuentes del proyecto (`src/**`, `app/**`). */
+export function projectSources(rootDir) {
+    const files = [];
+    for (const base of ['src', 'app'])
+        walk(join(rootDir, base), files);
+    return files;
+}
+function tryLoadTypescript() {
+    try {
+        return createRequire(import.meta.url)('typescript');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Tablas (de `tables`) que el código del proyecto referencia. Con `typescript`
+ * usa el parser sintáctico (identificadores y literales de cadena); si no, un
+ * chequeo por nombre con límites de palabra.
+ */
+export function tablesUsed(rootDir, tables) {
+    const names = new Set(tables);
+    if (names.size === 0)
+        return [];
+    const used = new Set();
+    const ts = tryLoadTypescript();
+    for (const file of projectSources(rootDir)) {
+        const text = readFileSync(file, 'utf-8');
+        if (!ts) {
+            for (const name of names) {
+                if (new RegExp(`\\b${name}\\b`).test(text))
+                    used.add(name);
+            }
+            continue;
+        }
+        const source = ts.createSourceFile(file, text, ts.ScriptTarget.Latest, true);
+        const visit = (node) => {
+            const candidate = ts.isIdentifier(node) || ts.isStringLiteral(node) || ts.isNoSubstitutionTemplateLiteral(node)
+                ? node.text
+                : undefined;
+            if (candidate !== undefined && names.has(candidate))
+                used.add(candidate);
+            ts.forEachChild(node, visit);
+        };
+        visit(source);
+    }
+    return [...used].sort();
+}
+/** Tablas declaradas por un proyecto en su `m-engine.json` (`engines.<motor>.tables`). */
+export function declaredUsage(projectDir) {
+    const intention = readIntention(projectDir);
+    const byMotor = {};
+    for (const [motor, ref] of Object.entries(intention?.engines ?? {})) {
+        if (ref.tables && ref.tables.length > 0)
+            byMotor[motor] = [...ref.tables];
+    }
+    const all = [...new Set(Object.values(byMotor).flat())].sort();
+    return { all, byMotor };
+}
+/** Compara lo usado contra lo declarado: `missing` (usado y no declarado) y `extra`. */
+export function usageReport(used, declared) {
+    const usedSet = new Set(used);
+    const declaredSet = new Set(declared);
+    return {
+        used: [...usedSet].sort(),
+        missing: [...usedSet].filter((table) => !declaredSet.has(table)).sort(),
+        extra: [...declaredSet].filter((table) => !usedSet.has(table)).sort(),
+    };
+}
+/** Paquete de un especificador (`@alcance/pkg/sub` → `@alcance/pkg`); `null` si es relativo o `node:`. */
+export function packageOf(specifier) {
+    if (!specifier || specifier.startsWith('.') || specifier.startsWith('/') || specifier.startsWith('node:'))
+        return null;
+    const [first, second] = specifier.split('/');
+    if (specifier.startsWith('@'))
+        return second ? `${first}/${second}` : null;
+    return first || null;
+}
+/** Especificadores de módulo de unas fuentes (import/export … from/require). */
+function moduleSpecifiers(file, text, ts) {
+    if (!ts) {
+        // Fallback sin `typescript`: cuenta también el texto emitido dentro de plantillas.
+        const found = [];
+        for (const re of [/from\s+['"]([^'"]+)['"]/g, /require\(\s*['"]([^'"]+)['"]\s*\)/g]) {
+            for (const match of text.matchAll(re))
+                found.push(match[1]);
+        }
+        return found;
+    }
+    const source = ts.createSourceFile(file, text, ts.ScriptTarget.Latest, true);
+    const found = [];
+    const visit = (node) => {
+        const specifier = (ts.isImportDeclaration(node) || ts.isExportDeclaration(node))
+            ? node.moduleSpecifier
+            : (ts.isImportEqualsDeclaration(node) && ts.isExternalModuleReference(node.moduleReference))
+                ? node.moduleReference.expression
+                : undefined;
+        if (specifier && ts.isStringLiteralLike(specifier))
+            found.push(specifier.text);
+        ts.forEachChild(node, visit);
+    };
+    visit(source);
+    return found;
+}
+/** Paquetes externos que importa un motor (`src/**`), con el archivo y si es sólo de pruebas. */
+export function importedPackages(motorDir) {
+    const ts = tryLoadTypescript();
+    const byName = new Map();
+    for (const file of projectSources(motorDir)) {
+        const text = readFileSync(file, 'utf-8');
+        for (const specifier of moduleSpecifiers(file, text, ts)) {
+            const name = packageOf(specifier);
+            if (!name)
+                continue;
+            const dev = /\.test\.tsx?$/.test(file);
+            const previous = byName.get(name);
+            if (previous && (!previous.dev || dev))
+                continue;
+            byName.set(name, { name, file, dev });
+        }
+    }
+    return [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * "El motor declara lo que usa": imports externos de `src/**` que no están en las
+ * `dependencies`/`peerDependencies`/`optionalDependencies` del motor (para pruebas,
+ * vale también `devDependencies`).
+ */
+export function undeclaredImports(motorDir, pkg) {
+    const declared = new Set([
+        ...Object.keys(pkg?.dependencies ?? {}),
+        ...Object.keys(pkg?.peerDependencies ?? {}),
+        ...Object.keys(pkg?.optionalDependencies ?? {}),
+    ]);
+    const devDeclared = new Set([...declared, ...Object.keys(pkg?.devDependencies ?? {})]);
+    return importedPackages(motorDir).filter((finding) => !(finding.dev ? devDeclared : declared).has(finding.name));
+}
+//# sourceMappingURL=usage.js.map

package/dist/compose/usage.js.map

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

package/dist/compose/vendor.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Vendorización "etapa 0" (https://gitlab.com/pasosdeJesus/m/-/work_items/39 D17): copia trazable de un motor dentro del
+ * consumidor (`packages/generated/<motor>`), con **procedencia** (motor, versión,
+ * origen y `sha256`) para poder medir **drift** contra el original. Adoptar un
+ * cambio del motor = **regenerar** (`eng:sync --vendor`), no fusionar a mano.
+ *
+ * "Porque ¿quién de vosotros, queriendo edificar una torre, no se sienta primero y calcula los gastos…?" (Lucas 14:28)
+ */
+import { type PackageJson } from './discover.js';
+export interface Provenance {
+    motor: string;
+    version: string;
+    /** Ruta local del motor (`kind: 'local'`), o `<url>#<ref>` cuando viene de git. */
+    source: string;
+    sha256: string;
+    /** De dónde se tomó el motor. Por defecto `local`. */
+    kind?: 'local' | 'git';
+    /** URL del repositorio cuando `kind: 'git'`. */
+    origin?: string;
+    /** Ref (rama, tag o commit) cuando `kind: 'git'`. */
+    ref?: string;
+    /** Subdirectorio del motor dentro del repositorio, cuando aplica. */
+    path?: string;
+}
+/** Origen git de un motor, para dejar la procedencia trazable (`--from-git`). */
+export interface GitOrigin {
+    url: string;
+    ref: string;
+    path?: string;
+}
+/** `sha256` del esquema de referencia del motor (`db/structure.sql`), o `null`. */
+export declare function structureSha(dir: string): string | null;
+/**
+ * `tsconfig.json` de la copia vendorizada: proyecto **autónomo** (no hereda de `m`),
+ * de modo que cada copia se compile por separado (`tsc -b`) y no pese en el
+ * consumidor (mismo criterio que sus paquetes de motor, p. ej. `gdcluster`).
+ */
+export declare function vendoredTsconfig(): string;
+/** `package.json` de la copia vendorizada: paquete propio, compilable por separado. */
+export declare function vendoredPackageJson(motorDir: string, pkg: PackageJson | null): string;
+/**
+ * Motor original con el que medir el drift de una copia vendorizada: el `--from`
+ * (la carpeta del motor, o un checkout donde vive en `packages/<motor>`), y si no
+ * la `source` de la procedencia.
+ */
+export declare function resolveOrigin(from: string | null, motorName: string, provenanceSource?: string): string | null;
+/** Copia un motor a `outDir` con procedencia. Regenera: borra `outDir` primero. */
+export declare function vendor(motorDir: string, outDir: string, gitOrigin?: GitOrigin): Provenance;
+/** Lee la procedencia de una copia vendorizada, o `null`. */
+export declare function readProvenance(outDir: string): Provenance | null;
+/** Quita una copia vendorizada. Devuelve `true` si existía. */
+export declare function unvendor(outDir: string): boolean;
+export type DriftCode = 'ok' | 'drift' | 'absent';
+/** Qué cambió respecto de la procedencia: el esquema (`sha256`) o la versión del motor. */
+export type DriftReason = 'schema' | 'version';
+export interface DriftFinding {
+    code: DriftCode;
+    message: string;
+    reason?: DriftReason;
+}
+/**
+ * Mide el drift de una copia vendorizada contra el motor original: primero el
+ * esquema (`sha256` de `db/structure.sql`) y después la **versión** del motor
+ * ([REQ/40](https://gitlab.com/pasosdeJesus/m/-/work_items/40) D5). Así un cambio de versión sin cambio de
+ * esquema también marca drift.
+ */
+export declare function drift(outDir: string, originalDir: string): DriftFinding;
+//# sourceMappingURL=vendor.d.ts.map