@jantstack/adonis-authz 2.0.0-alpha.1 → 2.4.0-alpha.10

package/build/commands/authz_relations_reconcile.js

@@ -0,0 +1,438 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { BaseCommand, flags } from '@adonisjs/core/ace';
+import { AuthorizationConfigError, StaleSourceRefusedError } from '../src/errors.js';
+/**
+ * Límites DECLARADOS de la identidad (cierre-2 de alpha.10 · C1 y C6):
+ *  - la identidad es la REFERENCIA de la factory: dos factories DISTINTAS que
+ *    construyen el mismo backend (`fga: () => new OpenFgaRelationsDriver(…mismo
+ *    store…)`) NO se detectan — el alias pasa el guard. No se construye nada antes
+ *    del guard, así que no hay backend que comparar; identidad declarada por el
+ *    driver ⇒ roadmap 2.5. Registra un alias con la MISMA referencia
+ *    (`const fga = () => …; drivers: { openfga: fga, alias: fga }`) o no lo registres.
+ *  - `authorization` es estructural (`Pick<…>`): un objeto que FALSEA
+ *    `relationsDriverKey`/`relationsDriverFactory` decide el activo y las factories.
+ *    Pásale el manager del servicio, nunca uno construido o envuelto a mano.
+ */
+export async function runRelationsReconcile(authorization, options) {
+    const { reconcileRelations } = await import('../src/relations/reconcile.js');
+    const raw = options;
+    // Entradas que ya no gobiernan nada (L5: una opción inerte no cae en un
+    // default en silencio). `from`/`to` como instancias y `activeKey` eran
+    // justo las etiquetas desalineables del R4.
+    const retiredOptions = ['from', 'to', 'activeKey'].filter((name) => raw[name] !== undefined);
+    if (retiredOptions.length > 0) {
+        throw new AuthorizationConfigError(`runRelationsReconcile: ${retiredOptions.map((n) => `\`${n}\``).join(', ')} ya no se acepta(n) (cierre de 2.4.0-alpha.10): ` +
+            'el origen y el destino se resuelven por `fromKey`/`toKey` desde el config del manager, y el driver activo lo ' +
+            'dice el manager (`relations.default ?? default`). Pasar instancias o un activo propio permitía que la etiqueta ' +
+            'contradijera al driver y la dirección rancia pasara.');
+    }
+    if (typeof options.toKey !== 'string' || typeof options.fromKey !== 'string') {
+        throw new AuthorizationConfigError('runRelationsReconcile: hacen falta `toKey` y `fromKey` (las claves de relations.drivers del destino y del ORIGEN) ' +
+            'desde 2.4.0-alpha.10 — sin ellas no se puede negar la dirección rancia (re-escribir en el driver de relaciones ' +
+            'ACTIVO lo que el origen dejó de ver en el cutover).');
+    }
+    const { toKey, fromKey, allowStaleSource, ...rest } = options;
+    const toFactory = authorization.relationsDriverFactory(toKey);
+    const fromFactory = authorization.relationsDriverFactory(fromKey);
+    for (const [role, key, factory] of [['destino', toKey, toFactory], ['origen', fromKey, fromFactory]]) {
+        if (typeof factory !== 'function') {
+            throw new AuthorizationConfigError(`runRelationsReconcile: el ${role} '${key}' no es una clave de relations.drivers en el config del manager.`);
+        }
+    }
+    const active = authorization.relationsDriverKey();
+    /** Mismo driver ⇔ misma clave o misma factory resuelta (un alias es el mismo driver). */
+    const sameDriver = (a, b) => a === b || authorization.relationsDriverFactory(a) === authorization.relationsDriverFactory(b);
+    if (sameDriver(fromKey, toKey)) {
+        throw new AuthorizationConfigError(`runRelationsReconcile: el origen '${fromKey}' y el destino '${toKey}' son el MISMO driver ` +
+            `(${fromKey === toKey ? 'misma clave' : 'la misma factory bajo dos claves'}): no hay nada que migrar y un --prune ` +
+            'se compararía consigo mismo. Nombra el otro driver.');
+    }
+    const stale = sameDriver(toKey, active);
+    const allowStale = allowStaleSource === true;
+    if (stale && !allowStale && options.dryRun !== true) {
+        const alias = toKey === active ? '' : ` (la clave '${toKey}' resuelve la MISMA factory que el activo '${active}')`;
+        throw new StaleSourceRefusedError(`authz:relations:reconcile --to=${toKey} (origen '${fromKey}'): '${toKey}' es el driver de ` +
+            `relaciones ACTIVO (relations.default ?? default)${alias} y el origen no lo es. Esa dirección re-escribiría en el driver ` +
+            `activo tuplas que el origen ya no refleja: resucitaría las comparticiones retiradas desde el cutover (y con ` +
+            `--prune borraría las creadas después). No se ha construido, leído, congelado ni escrito nada. Tras el cutover el driver ` +
+            `activo ES la fuente de verdad de las relaciones: no hay nada que migrar hacia él; para volver atrás, migra en ` +
+            `la otra dirección (--to=${fromKey} --from=${toKey}) ANTES de cambiar relations.default/default. ` +
+            `Si de verdad el origen sigue siendo la fuente de verdad, la decisión humana es --allow-stale-source ` +
+            `(allowStaleSource: true).`);
+    }
+    const from = await fromFactory();
+    const to = await toFactory();
+    const pass = () => reconcileRelations({ ...rest, from, to });
+    const mark = (report) => {
+        if (stale)
+            report.staleSource = { to: toKey, from: fromKey, allowed: allowStale };
+        return report;
+    };
+    if (options.dryRun === true)
+        return mark(await pass());
+    const reason = `authz:relations:reconcile --to=${toKey}`;
+    return authorization.withFrozenWrites(reason, async (window) => {
+        const report = mark(await pass());
+        report.frozen = {
+            durable: true,
+            lapsed: await window.lapsed(),
+            leaseMs: window.leaseMs,
+            fence: window.fence,
+            ...(window.untilMs === undefined ? {} : { untilMs: window.untilMs }),
+            ...(window.window === undefined ? {} : { window: window.window }),
+        };
+        return report;
+    }, { kind: 'reconcile', operatorAsContext: true });
+}
+/**
+ * Cómo se nombra la ventana en la que corrió la pasada (2.4.0-alpha.10 · 3):
+ * la del OPERADOR dice si caduca y cuándo — hasta alpha.9 una ventana abierta
+ * con `--lease-ms` salía como «ventana del operador» a secas, sin caducidad.
+ */
+export function frozenWindowLabel(frozen) {
+    // alpha.10 · S2: la ventana PROPIA se dice como tal — «no había ventana de
+    // operador viva» es justo lo que el operador de un cutover necesita leer.
+    if (frozen.window === 'own') {
+        return `, ventana PROPIA de la pasada (lease ${frozen.leaseMs} ms): NO había ventana de operador viva`;
+    }
+    if (frozen.window === 'enclosing')
+        return `, ventana que ya sostenía este proceso`;
+    if (frozen.untilMs !== undefined) {
+        return frozen.untilMs === null
+            ? ', ventana del operador sin caducidad'
+            : `, ventana del operador que CADUCA el ${new Date(frozen.untilMs).toISOString()} (le quedaban ${frozen.leaseMs} ms)`;
+    }
+    return frozen.leaseMs === null ? ', ventana del operador' : `, lease ${frozen.leaseMs} ms`;
+}
+/**
+ * Las líneas del reporte de `authz:relations:reconcile` y si la pasada es
+ * «limpia», en una función PURA (mismo patrón que `reconcileLines` de roles):
+ * es lo único del comando que DECIDE algo, y así tiene su caso sin montar un
+ * ace.
+ *
+ * Qué cuenta como deriva —y por tanto como exit ≠ 0—:
+ *  - **`modelDrift`** (siempre): un tipo de relación presente en el ORIGEN que
+ *    la config del DESTINO no declara. No cabe en su modelo fusionado, así que
+ *    esas tuplas nunca resolverían allí — es la deriva del presupuesto de
+ *    modelo compartido, no un detalle cosmético;
+ *  - en `--dry-run`, **cualquier cosa que la pasada haría** (escribir, borrar o
+ *    dejar `extra` sin `--prune`): es el verificador, y para eso está en CI.
+ *
+ * `extra` en una pasada que SÍ escribe (sin `--prune`) se AVISA —«repite con
+ * --prune»— pero no tumba: el operador eligió no podar. Es la misma cortesía
+ * que `authz:reconcile` de roles con la ventana del relay.
+ */
+export function relationsReconcileLines(report) {
+    const lines = [];
+    lines.push({
+        level: 'log',
+        message: `relaciones: escritas ${report.written}, actualizadas ${report.updated}, borradas ${report.deleted}, ` +
+            `iguales ${report.unchanged}, sobran ${report.extra}`,
+    });
+    // R-15: la caducada del origen es la pérdida DECLARADA de la migración (como
+    // `expired` en roles, 3b-8 · B2): se dice, no es deriva.
+    if (report.skipped.expired > 0) {
+        lines.push({
+            level: 'log',
+            message: `${report.skipped.expired} tupla(s) del origen estaban CADUCADAS al instante de la pasada y no se ` +
+                'migran (skipped.expired): no conceden nada y el destino no las necesita.',
+        });
+    }
+    // L-0: la tupla VIVA que el destino no declara (tipo o relación, F-05) no se
+    // escribió y se contó. No es una pérdida declarada como `expired` (que no
+    // concede nada): es una relación que no llegó ⇒ deriva, exit ≠ 0.
+    if (report.skipped.undeclared > 0) {
+        lines.push({
+            level: 'error',
+            message: `${report.skipped.undeclared} tupla(s) del origen NO se escribieron porque su tipo de objeto o su relación ` +
+                'no están declarados en defineRelationsConfig del DESTINO (skipped.undeclared, F-05 en el driver): ' +
+                'decláralos en el destino (y republica su modelo) y repite la pasada.',
+        });
+    }
+    for (const type of report.modelDrift) {
+        lines.push({
+            level: 'error',
+            message: `El tipo de objeto '${type}' está en el ORIGEN pero NO en la config de relaciones del DESTINO: ` +
+                'no cabe en su modelo fusionado y esas tuplas no resolverían allí. Declara el tipo en ' +
+                'defineRelationsConfig del destino (y republica su modelo) antes de migrarlas.',
+        });
+    }
+    // R-17: el seguro de borrado masivo. En una pasada REAL sin --allow-mass-delete
+    // esto ya habría lanzado 500 antes de llegar aquí; en --dry-run NO lanza y lo
+    // marca, así que el verificador tiene que sacarlo como deriva (exit ≠ 0).
+    if (report.massDelete) {
+        lines.push({
+            level: 'error',
+            message: `--prune borraría ${report.extra || report.deleted} tupla(s) del destino y el ORIGEN no aportó NI UNA ` +
+                'utilizable: la firma de un --from equivocado o de un store vacío. En una pasada real es 500 ' +
+                'E_AUTHZ_MASS_RECONCILE_REFUSED; si de verdad quieres vaciar el destino, --allow-mass-delete.',
+        });
+    }
+    if (report.extra > 0 && !report.dryRun) {
+        lines.push({
+            level: 'warning',
+            message: `${report.extra} tupla(s) del destino que el origen ya no respalda siguen ahí (no pasaste --prune): ` +
+                'repite con --prune si quieres borrarlas.',
+        });
+    }
+    // L-1 · J1: la garantía del freeze se DEMUESTRA (paridad con roles, 3b-7,
+    // juez C4). Un lease perdido a mitad = escrituras pudieron entrar durante la
+    // pasada y no aparecen en ningún contador ⇒ la pasada NO se certifica.
+    if (report.frozen) {
+        if (report.frozen.lapsed) {
+            lines.push({
+                level: 'error',
+                message: `El LEASE del freeze se perdió a MITAD de la pasada (fence ${report.frozen.fence}): otras escrituras de ` +
+                    'relaciones o de roles pudieron entrar mientras se reconciliaba y no están en estos contadores. ' +
+                    'La pasada NO se certifica: repite authz:relations:reconcile.',
+            });
+        }
+        else {
+            lines.push({
+                level: 'log',
+                message: `Escrituras congeladas durante la pasada (fence ${report.frozen.fence}` +
+                    `${frozenWindowLabel(report.frozen)}): ` +
+                    'la ventana aguantó entera.',
+            });
+        }
+    }
+    // alpha.10 · S1: la dirección rancia se dice siempre; en el verificador es deriva.
+    if (report.staleSource !== undefined) {
+        const { to, from, allowed } = report.staleSource;
+        lines.push({
+            level: 'warning',
+            message: `dirección RANCIA: '${to}' es el driver de relaciones ACTIVO y las tuplas salen de '${from}', que dejó de verlas ` +
+                'en el cutover — esta pasada resucita las comparticiones retiradas desde entonces (y con --prune borra las ' +
+                'nuevas). ' +
+                (allowed
+                    ? 'Levantada a sabiendas con --allow-stale-source.'
+                    : 'Sin --allow-stale-source la pasada de verdad se niega (E_AUTHZ_STALE_SOURCE_REFUSED).'),
+        });
+    }
+    const cambios = report.written + report.updated + report.deleted + (report.dryRun ? report.extra : 0);
+    const clean = !(report.dryRun && report.staleSource !== undefined && !report.staleSource.allowed) &&
+        report.modelDrift.length === 0 &&
+        report.skipped.undeclared === 0 &&
+        !report.massDelete &&
+        !(report.frozen?.lapsed === true) &&
+        (!report.dryRun || cambios === 0);
+    return { lines, clean };
+}
+/**
+ * **`authz:relations:reconcile`** (Fase 4, lote 4-6) — migra las tuplas de
+ * RELACIÓN de un `RelationsDriver` a otro, idempotente y bidireccional, nunca
+ * silenciosa. Es el comando de plataforma que envuelve `reconcileRelations`
+ * (lote 4-5), análogo a `authz:reconcile` de roles pero para el puerto
+ * `RelationsDriver`.
+ *
+ *   node ace authz:relations:reconcile --to=openfga --dry-run   # el VERIFICADOR
+ *   node ace authz:relations:reconcile --to=openfga             # migra
+ *   node ace authz:relations:reconcile --to=openfga --prune     # y borra lo que el origen ya no respalda
+ *
+ * `--to`/`--from` nombran claves de `relations.drivers` en
+ * `config/authorization.ts` (NO las de `drivers` de roles): las relaciones
+ * tienen su propio puerto y sus propios drivers. La factory del driver
+ * `openfga` de relaciones entra por el subpath `/openfga` DENTRO de ella, así
+ * que este comando NUNCA importa el SDK (pureza).
+ *
+ * **Solo migra HECHOS de relación**: no hay árbol ni catálogo en `relations/`,
+ * así que —a diferencia de `authz:reconcile` de roles— no hay fases de marcador
+ * de raíz, proyección ni árbol. La migración es **POR partición**
+ * (mono-tenant: `APP_SCOPE`, el default); para migrar otra partición se pasan
+ * `--partition-type`/`--partition-uuid`, y migrar TODAS es iterar por el
+ * consumidor (una migración de tenant es un caso natural).
+ *
+ * **`--dry-run` es el verificador y es read-only por contrato** (como el de
+ * roles, S18): mismo recorrido, cero escrituras, los mismos números; NO hay
+ * `--fix`. Además vigila la **deriva del modelo fusionado** (`modelDrift`): un
+ * tipo del origen que el destino no declara sale como error.
+ *
+ * Es una operación de PLATAFORMA: no lleva actor, no se expone por HTTP.
+ */
+export default class AuthzRelationsReconcile extends BaseCommand {
+    static commandName = 'authz:relations:reconcile';
+    static description = 'Rebuild (or verify, with --dry-run) the relation tuples of one RelationsDriver from another';
+    static options = {
+        startApp: true,
+    };
+    async run() {
+        if (!this.to) {
+            this.logger.error("Falta --to: 'node ace authz:relations:reconcile --to=openfga'. Es la clave del driver DESTINO en " +
+                '`relations.drivers` de config/authorization.ts.');
+            this.exitCode = 1;
+            return;
+        }
+        // Cierre del auditor de alpha.10 · R4: las claves, las factories y el driver
+        // ACTIVO salen del MISMO sitio — el manager de servicio (construido desde
+        // config/authorization.ts) —, que es también quien toma la ventana. Hasta el
+        // cierre el comando resolvía los drivers de `this.app.config` y le pasaba a
+        // `runRelationsReconcile` las instancias y, aparte, las etiquetas.
+        const { default: authorization } = await import('../services/main.js');
+        const keys = authorization.relationsDriverKeys();
+        if (keys.length === 0) {
+            this.logger.error('No hay `relations.drivers` en config/authorization.ts: declara los drivers de relaciones (por clave) ' +
+                'para poder migrar sus tuplas.');
+            this.exitCode = 1;
+            return;
+        }
+        // El ORIGEN: `--from` si se pasa; si no, el ÚNICO que no es el destino.
+        let fromKey = this.from;
+        if (!fromKey) {
+            const candidates = keys.filter((k) => k !== this.to);
+            if (candidates.length !== 1) {
+                this.logger.error(`No se puede elegir el ORIGEN solo: hay ${candidates.length} candidatos (${candidates.join(', ') || 'ninguno'}). ` +
+                    'Nómbralo con --from=<clave>: de dónde salen las tuplas decide lo que queda escrito.');
+                this.exitCode = 1;
+                return;
+            }
+            fromKey = candidates[0];
+        }
+        if (authorization.relationsDriverFactory(this.to) === undefined) {
+            this.logger.error(`El destino '${this.to}' no es una clave de relations.drivers (${keys.join(', ')}).`);
+            this.exitCode = 1;
+            return;
+        }
+        if (authorization.relationsDriverFactory(fromKey) === undefined) {
+            this.logger.error(`El origen '${fromKey}' no es una clave de relations.drivers (${keys.join(', ')}).`);
+            this.exitCode = 1;
+            return;
+        }
+        // La partición (mono-tenant por defecto). El reconcile es POR partición.
+        // Las DOS banderas van juntas o no va ninguna (cierre de alpha.9, 🟡 B del
+        // auditor): media pareja reconciliaba `app` en silencio, escribía CERO y
+        // salía `[success]` — la misma forma del 🔴 «migra 0 y reporta éxito» que
+        // este lote cierra, sobreviviendo a una errata del runbook de cutover.
+        if (this.partitionUuid && !this.partitionType) {
+            this.logger.error('--partition-uuid sin --partition-type: las dos banderas van juntas. ' +
+                'Sin --partition-type se reconciliaría la partición RAÍZ (app) y tus tuplas por tenant no se migrarían.');
+            this.exitCode = 1;
+            return;
+        }
+        // alpha.10 · 5 (sexto informe de COGNITIV): la variante que el cierre de
+        // alpha.9 no cazó — pareja COMPLETA con `app` también reconciliaba la raíz
+        // en silencio, tirando el uuid (una errata del runbook: `app` por el tipo).
+        if (this.partitionType === 'app' && this.partitionUuid) {
+            this.logger.error(`--partition-type=app con --partition-uuid=${this.partitionUuid}: la partición raíz no lleva uuid. ` +
+                'O quitas --partition-uuid (reconciliar la raíz) o pones el tipo del tenant en --partition-type.');
+            this.exitCode = 1;
+            return;
+        }
+        if (this.partitionType && this.partitionType !== 'app' && !this.partitionUuid) {
+            this.logger.error(`--partition-type=${this.partitionType} exige --partition-uuid (el tenant concreto a reconciliar).`);
+            this.exitCode = 1;
+            return;
+        }
+        const partition = this.partitionType && this.partitionType !== 'app'
+            ? { type: this.partitionType, uuid: this.partitionUuid }
+            : { type: 'app', uuid: null };
+        // La config del DESTINO, para vigilar la deriva del modelo fusionado en
+        // --dry-run: es la persistida (una sola en el store compartido).
+        const { readRelationsConfig } = await import('../src/relations_config_store.js');
+        const toConfig = await readRelationsConfig().catch(() => undefined);
+        // L-1 · J1: la pasada que ESCRIBE corre bajo la ventana durable del
+        // manager de roles (la misma fila `id = 2`, toda la flota); `--dry-run` no.
+        // Los drivers los construye `runRelationsReconcile`, DESPUÉS del guard.
+        let report;
+        try {
+            report = await runRelationsReconcile(authorization, {
+                partition,
+                dryRun: this.dryRun === true,
+                prune: this.prune === true,
+                allowMassDelete: this.allowMassDelete === true,
+                allowStaleSource: this.allowStaleSource === true,
+                toKey: this.to,
+                fromKey,
+                ...(toConfig ? { toConfig } : {}),
+            });
+        }
+        catch (error) {
+            // R-17: el seguro de borrado masivo (500) sale como error de comando, no
+            // como stack crudo. `--allow-mass-delete` es la salida humana.
+            if (error?.code === 'E_AUTHZ_MASS_RECONCILE_REFUSED' || error?.code === 'E_AUTHZ_STALE_SOURCE_REFUSED') {
+                this.logger.error(String(error.message ?? error));
+                this.exitCode = 1;
+                return;
+            }
+            // L-1 · J1: un freeze vivo de OTRA pasada (423): dos migraciones no se
+            // pisan; el mensaje nombra al dueño y cómo se levanta.
+            if (error?.code === 'E_AUTHZ_FREEZE_HELD' || error?.code === 'E_AUTHZ_OPERATOR_WINDOW_EXPIRED') {
+                this.logger.error(String(error.message ?? error));
+                this.exitCode = 1;
+                return;
+            }
+            // Cierre R4: origen y destino que resuelven el MISMO driver (misma clave o
+            // alias de la misma factory) es un error de configuración de la pasada.
+            if (error?.code === 'E_AUTHZ_CONFIG') {
+                this.logger.error(String(error.message ?? error));
+                this.exitCode = 1;
+                return;
+            }
+            throw error;
+        }
+        const { lines, clean } = relationsReconcileLines(report);
+        for (const { level, message } of lines)
+            this.logger[level](message);
+        const resumen = `escritas ${report.written}, actualizadas ${report.updated}, borradas ${report.deleted}, ` +
+            `iguales ${report.unchanged}, sobran ${report.extra}, caducadas omitidas ${report.skipped.expired}, ` +
+            `no declaradas en el destino ${report.skipped.undeclared}`;
+        if (report.dryRun) {
+            if (clean) {
+                this.logger.success(`Sin deriva: '${this.to}' coincide con '${fromKey}' (${resumen}).`);
+                return;
+            }
+            this.logger.error(`DERIVA con '${this.to}': ${resumen}. No se ha escrito nada (--dry-run).`);
+            this.exitCode = 1;
+            return;
+        }
+        this.logger.success(`Relaciones de '${this.to}' reconciliadas desde '${fromKey}': ${resumen}.`);
+        if (!clean) {
+            this.logger.warning('Queda algo que esta pasada no arregla sola (mira las líneas de arriba).');
+            this.exitCode = 1;
+        }
+    }
+}
+__decorate([
+    flags.string({ description: 'Destination driver: a key of `relations.drivers` in config/authorization.ts' }),
+    __metadata("design:type", Object)
+], AuthzRelationsReconcile.prototype, "to", void 0);
+__decorate([
+    flags.string({ description: 'Source driver (a key of `relations.drivers`); required when more than one is registered' }),
+    __metadata("design:type", Object)
+], AuthzRelationsReconcile.prototype, "from", void 0);
+__decorate([
+    flags.boolean({ description: 'Report what it would do and write nothing (this is the verifier)' }),
+    __metadata("design:type", Object)
+], AuthzRelationsReconcile.prototype, "dryRun", void 0);
+__decorate([
+    flags.boolean({ description: 'Also delete the tuples the source no longer backs (leftovers)' }),
+    __metadata("design:type", Object)
+], AuthzRelationsReconcile.prototype, "prune", void 0);
+__decorate([
+    flags.boolean({
+        description: 'Allow --prune to empty the destination when the source has no usable tuple (mass-delete safeguard)',
+    }),
+    __metadata("design:type", Object)
+], AuthzRelationsReconcile.prototype, "allowMassDelete", void 0);
+__decorate([
+    flags.boolean({
+        description: 'Allow --to=<ACTIVE relations driver> from another source: rewrites into the serving driver tuples the source no longer reflects',
+    }),
+    __metadata("design:type", Object)
+], AuthzRelationsReconcile.prototype, "allowStaleSource", void 0);
+__decorate([
+    flags.string({ description: 'Partition (tenant) scope type to migrate; default: app (mono-tenant)' }),
+    __metadata("design:type", Object)
+], AuthzRelationsReconcile.prototype, "partitionType", void 0);
+__decorate([
+    flags.string({ description: 'Partition (tenant) scope uuid; required with --partition-type' }),
+    __metadata("design:type", Object)
+], AuthzRelationsReconcile.prototype, "partitionUuid", void 0);
+//# sourceMappingURL=authz_relations_reconcile.js.map

package/build/commands/authz_relations_reconcile.js.map

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

package/build/commands/authz_scopes_relay.d.ts

@@ -0,0 +1,97 @@
+import { BaseCommand } from '@adonisjs/core/ace';
+import { CommandOptions } from '@adonisjs/core/types/ace';
+import type { ScopeRelayQueue } from '../src/types.js';
+/**
+ * **La edad de la cola en el comando** (2.4.0-alpha.8; panel relay 2,
+ * cuestión 5), en una función PURA (patrón `requeueLines`): qué se imprime y
+ * si `--max-age` la convierte en salida ≠ 0.
+ *
+ *  - Sin cabeza con fecha (`pendingAgeMs === null`: cola vacía, solo
+ *    aparcadas, o una outbox de terceros sin `createdAt`) no se dice nada y
+ *    nunca se alarma.
+ *  - Con edad, se INFORMA siempre (es lo que faltaba en el B2 de COGNITIV:
+ *    diez pasadas con el store caído y nadie sabía desde cuándo).
+ *  - **Solo con umbral** (`--max-age=<ms>`) y edad POR ENCIMA es `exceeded`
+ *    (exit ≠ 0): sin umbral un cron no puede quedarse en rojo para siempre
+ *    por una cola que simplemente tiene backlog. Un umbral inválido lanza.
+ */
+export declare function queueAgeLines(queue: ScopeRelayQueue, maxAgeMs: number | undefined, remaining?: boolean): {
+    lines: Array<{
+        level: 'info' | 'warning' | 'error';
+        message: string;
+    }>;
+    exceeded: boolean;
+};
+/**
+ * Drena la OUTBOX del árbol de scopes y aplica los cambios al driver
+ * (3b-2d; panel 2, cruce 4 · S5).
+ *
+ * Con `scopes.outbox` declarada, `authorization.scopes.attached/moved/
+ * detached` no escriben en el backend: encolan el cambio DENTRO de la
+ * transacción del consumidor. Este comando es quien lo propaga.
+ *
+ *   node ace authz:scopes:relay                 # drena
+ *   node ace authz:scopes:relay --dry-run       # solo dice qué haría
+ *   node ace authz:scopes:relay --limit 500     # una pasada acotada
+ *   node ace authz:scopes:relay --only=12,13    # SOLO esas entradas (2.4.0-alpha.5)
+ *   node ace authz:scopes:relay --wait-lease-ms=5000   # espera el lease hasta 5 s en vez de salir `busy` (2.4.0-alpha.8)
+ *   node ace authz:scopes:relay --max-age=300000       # exit ≠ 0 si la pendiente más antigua lleva > 5 min (2.4.0-alpha.8)
+ *
+ * **`--max-age`** (alpha.8, cuestión 5 del panel relay 2): el reporte lleva
+ * SIEMPRE la edad de la cabeza global de la cola (`queue.pendingAgeMs`, con
+ * el reloj de quien encoló) y se imprime; con umbral, superarlo es salida ≠ 0
+ * — la alarma que faltaba cuando el store está caído (un 503 no consume
+ * intento: `attempts` y `dead` se quedan a cero). Sin umbral solo informa.
+ *
+ * **`--only`** (alpha.5 · R1): releva solo los ids del recibo que devolvió
+ * `scopes.attached/moved/detached` (`{ queued }`). El orden por clave no se
+ * relaja: una entrada pedida que dependa de una anterior sin aplicar y no
+ * pedida sale «aplazada» (`depends-on:<id>`), nunca fuera de orden; `--only`
+ * vacío es un error, no «todo». La salida es POR ENTRADA (`entries`), y los
+ * ids que no estaban ni pendientes ni aparcados se dicen (`missing`).
+ *
+ * **Lo aparcado tapona por clave** (alpha.5 · R2a): un `attached`/`moved`
+ * que nombre un scope de una entrada APARCADA sale «aplazado» con
+ * `parked:<id>` en todas las pasadas hasta que alguien mire la aparcada; un
+ * `detached` de esa clave se aplica igual (una purga nunca queda bloqueada).
+ * Y un 503 del backend NO consume intento: la caída del store es común a
+ * todas las entradas y no dice nada de ninguna.
+ *
+ * Pensado para un supervisor (un bucle, un cron corto, un worker): la pasada
+ * es REANUDABLE —lo que no entra sigue pendiente—. Un cambio que falla
+ * **aplaza lo que depende de él** (todo cambio posterior que nombre alguno de
+ * sus scopes) y deja pasar el resto: hasta 3b-2h paraba la pasada entera, y
+ * eso convertía una entrada irreparable en un tapón permanente para todos los
+ * tenants (3b-2h · 🔴 2). Sale con código ≠ 0 si algo falló o hay entradas
+ * APARCADAS, para que el supervisor se entere.
+ *
+ * **Escritor ÚNICO**: si la outbox sabe dar lease (`sqlScopeOutbox` lo hace),
+ * una segunda pasada simultánea no hace nada y lo dice. Sin lease, no lances
+ * dos a la vez: la rezagada re-aplica cambios viejos sobre el árbol nuevo.
+ *
+ * **Lo que este comando no puede arreglar**: entre el commit del consumidor
+ * y la pasada hay un lag (segundos) en el que el backend decide con el árbol
+ * VIEJO. Es un fail-open temporal —el tenant antiguo conserva acceso tras un
+ * `moved`, los denies heredados no aplican tras un `attached`—. No hay 2PC.
+ * Un ciclo más corto acorta esa ventana **mientras la cola avance**: lo que
+ * falla o se aparca no está acotado por el ciclo y hay que mirarlo.
+ *
+ * Es una operación de PLATAFORMA (como `authz:catalog:prune-orphans`): se
+ * salta `requireActor`/`requireWithin` porque la policy ya se juzgó al
+ * ENCOLAR, con el árbol y la sesión de aquel momento. No se expone por HTTP.
+ */
+export default class AuthzScopesRelay extends BaseCommand {
+    static commandName: string;
+    static description: string;
+    static options: CommandOptions;
+    dryRun: boolean | undefined;
+    limit: number | undefined;
+    batchSize: number | undefined;
+    only: string[] | undefined;
+    waitLeaseMs: number | undefined;
+    maxAge: number | undefined;
+    /** `--only=12,13` o `--only=12 --only=13`: ids numéricos como número, el resto como cadena. */
+    static parseOnly(values: string[] | undefined): Array<string | number> | undefined;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=authz_scopes_relay.d.ts.map

package/build/commands/authz_scopes_relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authz_scopes_relay.d.ts","sourceRoot":"","sources":["../../commands/authz_scopes_relay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAS,MAAM,oBAAoB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,SAAS,GAAE,OAAe,GACzB;IAAE,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAoC/F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,WAAW;IACvD,MAAM,CAAC,WAAW,SAAuB;IACzC,MAAM,CAAC,WAAW,SAAiF;IAEnG,MAAM,CAAC,OAAO,EAAE,cAAc,CAE7B;IAKO,MAAM,EAAE,OAAO,GAAG,SAAS,CAAA;IAG3B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IAGzB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAK7B,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAK1B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAK/B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAElC,+FAA+F;IAC/F,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,SAAS;IAS5E,GAAG;CAgMV"}