@bett3r-dev/pv3 1.0.0 → 1.1.7

package/build/ports/configuration/__tests__/cliArgs.test.js

@@ -0,0 +1,158 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const yargs_1 = __importDefault(require("yargs/yargs"));
+const args_1 = require("../args");
+const index_1 = require("../index");
+describe('CLI args', function () {
+    const getAdapter = (config) => ({
+        applyConfig: async () => config,
+        name: 'test',
+        _adapter: () => { },
+        start: async () => { },
+        stop: async () => { }
+    });
+    let configuration;
+    let configureCliArg;
+    beforeAll(async () => {
+        configuration = await (0, index_1.Configuration)(getAdapter({}));
+        configureCliArg = configuration.configureCliArg;
+    });
+    /** Always parse an explicit array: a bare `parse()` picks up jest's own argv. */
+    const fresh = () => (0, yargs_1.default)([]);
+    describe('getYargsInit -- declares framework mechanics only', function () {
+        it('no longer declares the four service-role flags', async () => {
+            const args = await (0, args_1.getYargsInit)().parseAsync(['-siro']);
+            expect(args.admin).toBeUndefined();
+            expect(args.infrastructure).toBeUndefined();
+            expect(args.requestAuthorization).toBeUndefined();
+            expect(args.outbox).toBeUndefined();
+        });
+        it('still parses the removed short flags, because yargs is non-strict', async () => {
+            // Nothing coerces them and nothing aliases them to a long name any more, but the
+            // process does not crash on argv it no longer understands. TV1-2264's migration
+            // window rides on exactly this, as do the undeclared `subscriptions`/`walReader`
+            // reads elsewhere in pv3.
+            const args = await (0, args_1.getYargsInit)().parseAsync(['-siro']);
+            expect(args.s).toBe(true);
+            expect(args.i).toBe(true);
+            expect(args.r).toBe(true);
+            expect(args.o).toBe(true);
+        });
+        it('keeps the flags pv3 itself reads', async () => {
+            const args = await (0, args_1.getYargsInit)().parseAsync(['-g', '-l', 'orders', '--lift', 'billing']);
+            expect(args.generateDeploymentUnits).toBe(true);
+            expect(args.lift).toEqual(['orders', 'billing']);
+        });
+    });
+    describe('configureCliArg -- defaults', function () {
+        it('registers falsy defaults', async () => {
+            const y = fresh();
+            configureCliArg({ type: 'boolean', name: 'quiet', default: false }, y);
+            configureCliArg({ type: 'number', name: 'retries', default: 0 }, y);
+            configureCliArg({ type: 'string', name: 'prefix', default: '' }, y);
+            const args = await y.parseAsync([]);
+            expect(args.quiet).toBe(false);
+            expect(args.retries).toBe(0);
+            expect(args.prefix).toBe('');
+        });
+        it('leaves an undeclared default undefined rather than inventing one', async () => {
+            // The control for the case above: without `.default()` yargs yields `undefined` even
+            // for a declared boolean, so the assertions there really are discriminating.
+            const y = fresh();
+            configureCliArg({ type: 'boolean', name: 'quiet' }, y);
+            expect((await y.parseAsync([])).quiet).toBeUndefined();
+        });
+        it('still registers truthy defaults', async () => {
+            const y = fresh();
+            configureCliArg({ type: 'number', name: 'port', alias: 'p', default: 1984 }, y);
+            expect((await y.parseAsync([])).port).toBe(1984);
+        });
+    });
+    describe('configureCliArg -- array type', function () {
+        it('parses a repeatable flag as an array, by long name and by alias', async () => {
+            const y = fresh();
+            configureCliArg({ type: 'array', name: 'pick', alias: 'k' }, y);
+            expect((await y.parseAsync(['--pick', 'a', '--pick', 'b'])).pick).toEqual(['a', 'b']);
+            expect((await y.parseAsync(['-k', 'a'])).pick).toEqual(['a']);
+        });
+        it('does not greedily swallow a following flag', async () => {
+            const y = fresh();
+            configureCliArg({ type: 'array', name: 'pick' }, y);
+            configureCliArg({ type: 'boolean', name: 'dryRun' }, y);
+            const args = await y.parseAsync(['--pick', 'a', '--dryRun']);
+            expect(args.pick).toEqual(['a']);
+            expect(args.dryRun).toBe(true);
+        });
+    });
+    describe('configureCliArg -- alias collisions', function () {
+        it('throws, naming both flags, when a second flag claims an alias already owned', () => {
+            const y = fresh();
+            configureCliArg({ type: 'boolean', name: 'requestAuthorization', alias: 'r' }, y);
+            expect(() => configureCliArg({ type: 'boolean', name: 'rulesWorker', alias: 'r' }, y))
+                .toThrow(/collision.*requestAuthorization.*rulesWorker/);
+        });
+        it('throws when a flag NAME collides with an existing alias', () => {
+            const y = fresh();
+            configureCliArg({ type: 'boolean', name: 'admin', alias: 's' }, y);
+            expect(() => configureCliArg({ type: 'string', name: 's' }, y))
+                .toThrow(/collision.*admin.*"s"/);
+        });
+        it('leaves the first flag intact after a rejected collision', async () => {
+            const y = fresh();
+            configureCliArg({ type: 'boolean', name: 'requestAuthorization', alias: 'r' }, y);
+            expect(() => configureCliArg({ type: 'boolean', name: 'rulesWorker', alias: 'r' }, y)).toThrow();
+            // The whole point: `-r` must set ONE target, not silently fan out to both.
+            const args = await y.parseAsync(['-r']);
+            expect(args.requestAuthorization).toBe(true);
+            expect(args.rulesWorker).toBeUndefined();
+        });
+        it('is silently idempotent for the exact same (name, alias) pair', async () => {
+            // An adapter can be constructed more than once per process; that must not be fatal.
+            const y = fresh();
+            const definition = { type: 'number', name: 'port', alias: 'p', default: 1984 };
+            configureCliArg(definition, y);
+            expect(() => configureCliArg(definition, y)).not.toThrow();
+            expect((await y.parseAsync(['-p', '3000'])).port).toBe(3000);
+        });
+        it('lets the same flag add an alias it did not previously have', () => {
+            const y = fresh();
+            configureCliArg({ type: 'boolean', name: 'walReader' }, y);
+            expect(() => configureCliArg({ type: 'boolean', name: 'walReader', alias: 'w' }, y)).not.toThrow();
+        });
+        it('guards the framework flags on the shared singleton', () => {
+            // No second argument -> the module singleton, whose registry is pre-seeded with
+            // pv3's own flags. A consumer reaching for -l/-g/-h must not transitively alias
+            // onto lift/generateDeploymentUnits/help.
+            expect(() => configureCliArg({ type: 'boolean', name: 'listen', alias: 'l' }))
+                .toThrow(/collision.*lift.*listen/);
+            expect(() => configureCliArg({ type: 'boolean', name: 'generate', alias: 'g' }))
+                .toThrow(/collision.*generateDeploymentUnits.*generate/);
+            expect(() => configureCliArg({ type: 'boolean', name: 'host', alias: 'h' }))
+                .toThrow(/collision.*help.*host/);
+        });
+        it('does not guard tokens the framework released', () => {
+            // -s/-i/-r/-o are consumer territory now. This is what TV1-2264 relies on.
+            expect(() => configureCliArg({ type: 'boolean', name: 'admin', alias: 's' })).not.toThrow();
+            expect(() => configureCliArg({ type: 'boolean', name: 'outbox', alias: 'o' })).not.toThrow();
+        });
+    });
+    describe('configureCliArg -- help output', function () {
+        it('lists a consumer-registered flag with its alias and description', async () => {
+            const y = fresh();
+            configureCliArg({
+                type: 'boolean',
+                name: 'walReader',
+                alias: 'w',
+                description: 'Run the WAL reader in this process'
+            }, y);
+            const help = await y.getHelp();
+            expect(help).toContain('--walReader');
+            expect(help).toContain('-w');
+            expect(help).toContain('Run the WAL reader in this process');
+        });
+    });
+});
+//# sourceMappingURL=cliArgs.test.js.map

package/build/ports/configuration/__tests__/cliArgs.test.js.map

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

package/build/ports/configuration/__tests__/configurationPortEmitter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=configurationPortEmitter.test.d.ts.map

package/build/ports/configuration/__tests__/configurationPortEmitter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configurationPortEmitter.test.d.ts","sourceRoot":"","sources":["../../../../src/ports/configuration/__tests__/configurationPortEmitter.test.ts"],"names":[],"mappings":""}

package/build/ports/configuration/__tests__/configurationPortEmitter.test.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const pv3_types_1 = require("@bett3r-dev/pv3-types");
+const base_1 = require("../../base");
+const index_1 = require("../index");
+// TV1-2069 — emitter-identity of the configuration port.
+//
+// The claim: the configuration port passes its OWN `emitter` into `createPort(...)`.
+// `createPort`'s `onStarted`/`onStopped` close over the emitter *createPort itself*
+// builds, but the returned instance's `.emitter` is overwritten by the port's own
+// emitter (the `...port` spread lands after the `emitter` key). Configuration then
+// calls `config.emitter.emit( 'started' )` on that own emitter — a DIFFERENT object
+// from the one the `onStarted` closure listens on — so an early-registered
+// `onStarted` callback would never fire.
+describe('configuration port emitter identity (TV1-2069)', () => {
+    const getAdapter = (config) => ({
+        applyConfig: async () => config,
+        name: 'test',
+        _adapter: () => { },
+        start: async () => { },
+        stop: async () => { }
+    });
+    describe('Given a port that supplies its OWN emitter (exactly as the configuration port does)', () => {
+        it('When onStarted is registered BEFORE start and started is emitted on port.emitter, Then the early callback fires', () => {
+            // Given — mimic ConfigurationPort: hand createPort a port object carrying its own emitter.
+            const ownEmitter = new pv3_types_1.TypedEventEmitter();
+            const port = (0, base_1.createPort)({ name: 'config-like', emitter: ownEmitter });
+            let firedEarly = false;
+            // Early registration — before start(), so onStarted takes the emitter.once() path.
+            port.onStarted(() => { firedEarly = true; });
+            // When — start exactly as Configuration does ( index.ts:112-113 ).
+            port.isStarted = true;
+            port.emitter.emit('started');
+            // Then — the callback the port registered must fire on the same emitter it emits on.
+            expect(firedEarly).toBe(true);
+        });
+    });
+    describe('Given the real configuration port ( already started )', () => {
+        it('When onStopped is registered and stopped is emitted on config.emitter, Then the callback fires ( same-emitter identity )', async () => {
+            // Given — the public API always hands back an already-started port, so the
+            // started/before-start window is unreachable here; onStopped exercises the
+            // identical emitter-identity defect without the isStarted short-circuit.
+            const configuration = await (0, index_1.Configuration)(getAdapter({ module1: { prop1: 'a' } }));
+            let stopped = false;
+            configuration.onStopped(() => { stopped = true; });
+            // When — emit on config.emitter, the very object index.ts emits 'started' on.
+            configuration.emitter.emit('stopped');
+            // Then
+            expect(stopped).toBe(true);
+        });
+        it('When onStarted is registered AFTER start, Then it fires immediately ( isStarted short-circuit, unaffected by the defect )', async () => {
+            // Given
+            const configuration = await (0, index_1.Configuration)(getAdapter({ module1: { prop1: 'a' } }));
+            let fired = false;
+            // When
+            configuration.onStarted(() => { fired = true; });
+            // Then — this path runs synchronously via instance.isStarted, so it is green
+            // both before and after the fix; it documents that the after-start path is intact.
+            expect(fired).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=configurationPortEmitter.test.js.map

package/build/ports/configuration/__tests__/configurationPortEmitter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configurationPortEmitter.test.js","sourceRoot":"","sources":["../../../../src/ports/configuration/__tests__/configurationPortEmitter.test.ts"],"names":[],"mappings":";;AAAA,qDAA6E;AAC7E,qCAAwC;AACxC,oCAAyC;AAEzC,yDAAyD;AACzD,EAAE;AACF,qFAAqF;AACrF,oFAAoF;AACpF,kFAAkF;AAClF,mFAAmF;AACnF,oFAAoF;AACpF,2EAA2E;AAC3E,yCAAyC;AAEzC,QAAQ,CAAE,gDAAgD,EAAE,GAAG,EAAE;IAC/D,MAAM,UAAU,GAAG,CAAE,MAAW,EAAG,EAAE,CAAC,CAAC;QACrC,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM;QAC/B,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;QAClB,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACrB,IAAI,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;KACrB,CAAC,CAAC;IAEH,QAAQ,CAAE,qFAAqF,EAAE,GAAG,EAAE;QACpG,EAAE,CAAE,iHAAiH,EAAE,GAAG,EAAE;YAC1H,2FAA2F;YAC3F,MAAM,UAAU,GAAG,IAAI,6BAAiB,EAAqB,CAAC;YAC9D,MAAM,IAAI,GAAG,IAAA,iBAAU,EAAC,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;YACtE,IAAI,UAAU,GAAG,KAAK,CAAC;YACvB,mFAAmF;YACnF,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAE7C,mEAAmE;YACnE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAE,SAAS,CAAE,CAAC;YAE/B,qFAAqF;YACrF,MAAM,CAAE,UAAU,CAAE,CAAC,IAAI,CAAE,IAAI,CAAE,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAE,uDAAuD,EAAE,GAAG,EAAE;QACtE,EAAE,CAAE,0HAA0H,EAAE,KAAK,IAAI,EAAE;YACzI,2EAA2E;YAC3E,2EAA2E;YAC3E,yEAAyE;YACzE,MAAM,aAAa,GAAG,MAAM,IAAA,qBAAa,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAC,CAAC,CAAC,CAAC;YACnF,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,aAAa,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAEnD,8EAA8E;YAC9E,aAAa,CAAC,OAAO,CAAC,IAAI,CAAE,SAAS,CAAE,CAAC;YAExC,OAAO;YACP,MAAM,CAAE,OAAO,CAAE,CAAC,IAAI,CAAE,IAAI,CAAE,CAAC;QACjC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAE,2HAA2H,EAAE,KAAK,IAAI,EAAE;YAC1I,QAAQ;YACR,MAAM,aAAa,GAAG,MAAM,IAAA,qBAAa,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAC,CAAC,CAAC,CAAC;YACnF,IAAI,KAAK,GAAG,KAAK,CAAC;YAElB,OAAO;YACP,aAAa,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAEjD,6EAA6E;YAC7E,mFAAmF;YACnF,MAAM,CAAE,KAAK,CAAE,CAAC,IAAI,CAAE,IAAI,CAAE,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/ports/configuration/__tests__/getArgsSync.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=getArgsSync.test.d.ts.map

package/build/ports/configuration/__tests__/getArgsSync.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getArgsSync.test.d.ts","sourceRoot":"","sources":["../../../../src/ports/configuration/__tests__/getArgsSync.test.ts"],"names":[],"mappings":""}

package/build/ports/configuration/__tests__/getArgsSync.test.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * `getArgsSync()` -- the last-applied arg snapshot, read synchronously.
+ *
+ * The contract under test is a TRI-STATE, and the third state is the whole
+ * point: `undefined` ("nothing has parsed yet") is a DIFFERENT answer from `{}`
+ * ("parsed, and the argv carried no flags"). See pv3 ADR-024.
+ *
+ * These drive the port through the `applyArgs` seam rather than through
+ * `process.argv`. `formatArgs` calls `parseAsync()` on yargs' DEFAULT singleton,
+ * which snapshots `process.argv` at import time -- so mutating `process.argv`
+ * inside a test is invisible to it, and the runner's own argv would leak into
+ * every assertion. Mocking the seam also gives the "does not parse" case
+ * (`case 4`) a real call-count oracle instead of a proxy.
+ */
+const applyArgsMock = jest.fn();
+jest.mock('../args', () => {
+    const actual = jest.requireActual('../args');
+    return { ...actual, applyArgs: (...args) => applyArgsMock(...args) };
+});
+const index_1 = require("../index");
+const getAdapter = (config) => ({
+    applyConfig: async () => config,
+    name: 'test',
+    _adapter: () => { },
+    start: async () => { },
+    stop: async () => { }
+});
+/** Make the next parse resolve to `args`, as `applyArgs` would. */
+const nextParseYields = (args) => applyArgsMock.mockImplementation(async (config) => ({ config, args }));
+describe('ConfigurationPort.getArgsSync', function () {
+    beforeEach(() => {
+        applyArgsMock.mockReset();
+        nextParseYields({});
+    });
+    it('returns undefined on a fresh port, before anything has parsed', async () => {
+        const configuration = await (0, index_1.Configuration)(getAdapter({}));
+        expect(configuration.getArgsSync()).toBeUndefined();
+    });
+    it('returns the very snapshot getArgs() just produced', async () => {
+        nextParseYields({ someFlag: true });
+        const configuration = await (0, index_1.Configuration)(getAdapter({}));
+        const parsed = await configuration.getArgs();
+        expect(configuration.getArgsSync()).toBe(parsed);
+        expect(configuration.getArgsSync()).toEqual({ someFlag: true });
+    });
+    it('reflects the NEWEST parse, not a construction-time freeze', async () => {
+        // Pins the mechanism against the ticket's own proposed one. `-p/--port` and
+        // the `generateDocumentation` command register during `setupPorts`, so a
+        // snapshot frozen when the port was constructed would predate them.
+        nextParseYields({ firstFlag: true });
+        const configuration = await (0, index_1.Configuration)(getAdapter({}));
+        await configuration.getArgs();
+        expect(configuration.getArgsSync()).toEqual({ firstFlag: true });
+        nextParseYields({ secondFlag: true });
+        await configuration.getArgs();
+        expect(configuration.getArgsSync()).toEqual({ secondFlag: true });
+    });
+    it('performs NO parse of its own', async () => {
+        nextParseYields({ firstFlag: true });
+        const configuration = await (0, index_1.Configuration)(getAdapter({}));
+        await configuration.getArgs();
+        const parsesSoFar = applyArgsMock.mock.calls.length;
+        configuration.getArgsSync();
+        configuration.getArgsSync();
+        configuration.getArgsSync();
+        expect(applyArgsMock.mock.calls.length).toBe(parsesSoFar);
+    });
+    it('returns {} -- NOT undefined -- for a parsed but FLAGLESS argv', async () => {
+        // THE TRAP ORACLE. `formatArgs` returns `omit([ '$0', '_' ], args )`, so a
+        // legitimately flagless parse yields `{}`. An implementation that derived
+        // "has it parsed yet?" from `Object.keys( _args ).length` would answer
+        // `undefined` here -- i.e. "unknown" for exactly the argv whose correct
+        // answer is "every flag is off". The parsed-ness flag must be its own
+        // boolean, which is what this pins.
+        nextParseYields({});
+        const configuration = await (0, index_1.Configuration)(getAdapter({}));
+        await configuration.getArgs();
+        const snapshot = configuration.getArgsSync();
+        expect(snapshot).toBeDefined();
+        expect(snapshot).toEqual({});
+    });
+});
+//# sourceMappingURL=getArgsSync.test.js.map

package/build/ports/configuration/__tests__/getArgsSync.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getArgsSync.test.js","sourceRoot":"","sources":["../../../../src/ports/configuration/__tests__/getArgsSync.test.ts"],"names":[],"mappings":";;AAEA;;;;;;;;;;;;;GAaG;AACH,MAAM,aAAa,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;AAEhC,IAAI,CAAC,IAAI,CAAE,SAAS,EAAE,GAAG,EAAE;IACzB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAE,SAAS,CAAE,CAAC;IAC/C,OAAO,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,CAAE,GAAG,IAAe,EAAE,EAAE,CAAC,aAAa,CAAE,GAAG,IAAI,CAAE,EAAE,CAAC;AACrF,CAAC,CAAC,CAAC;AAEH,oCAAyC;AAEzC,MAAM,UAAU,GAAG,CAAE,MAAW,EAAyB,EAAE,CAAC,CAAC;IAC3D,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM;IAC/B,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;IAClB,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;IACrB,IAAI,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;CACrB,CAAoC,CAAC;AAEtC,mEAAmE;AACnE,MAAM,eAAe,GAAG,CAAE,IAAyB,EAAG,EAAE,CACtD,aAAa,CAAC,kBAAkB,CAAE,KAAK,EAAG,MAA2B,EAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAEjG,QAAQ,CAAE,+BAA+B,EAAE;IACzC,UAAU,CAAC,GAAG,EAAE;QACd,aAAa,CAAC,SAAS,EAAE,CAAC;QAC1B,eAAe,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAE,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,aAAa,GAAG,MAAM,IAAA,qBAAa,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;QAE3D,MAAM,CAAE,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAE,mDAAmD,EAAE,KAAK,IAAI,EAAE;QAClE,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,MAAM,aAAa,GAAG,MAAM,IAAA,qBAAa,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;QAE3D,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC;QAE7C,MAAM,CAAE,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAE,MAAM,CAAE,CAAC;QACpD,MAAM,CAAE,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAE,2DAA2D,EAAE,KAAK,IAAI,EAAE;QAC1E,4EAA4E;QAC5E,yEAAyE;QACzE,oEAAoE;QACpE,eAAe,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrC,MAAM,aAAa,GAAG,MAAM,IAAA,qBAAa,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3D,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC;QAC9B,MAAM,CAAE,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAElE,eAAe,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC;QAE9B,MAAM,CAAE,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAE,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC7C,eAAe,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrC,MAAM,aAAa,GAAG,MAAM,IAAA,qBAAa,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3D,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC;QAC9B,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QAEpD,aAAa,CAAC,WAAW,EAAE,CAAC;QAC5B,aAAa,CAAC,WAAW,EAAE,CAAC;QAC5B,aAAa,CAAC,WAAW,EAAE,CAAC;QAE5B,MAAM,CAAE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAE,CAAC,IAAI,CAAE,WAAW,CAAE,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAE,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC9E,2EAA2E;QAC3E,0EAA0E;QAC1E,uEAAuE;QACvE,wEAAwE;QACxE,sEAAsE;QACtE,oCAAoC;QACpC,eAAe,CAAC,EAAE,CAAC,CAAC;QACpB,MAAM,aAAa,GAAG,MAAM,IAAA,qBAAa,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;QAE3D,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC;QAE9B,MAAM,QAAQ,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;QAC7C,MAAM,CAAE,QAAQ,CAAE,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,CAAE,QAAQ,CAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/ports/configuration/args.d.ts

@@ -1,57 +1,64 @@
-import yargs from 'yargs';
-export declare const getYargs: () => yargs.Argv<{}>;
-export declare const getYargsInit: () => yargs.Argv<{
-    modules: (string | number)[] | undefined;
+import { Argv } from 'yargs';
+export declare const getYargs: () => Argv<{}>;
+/**
+ * The flags pv3 ITSELF reads, and nothing else.
+ *
+ * A flag the framework declares but never reads is a lie in its own `--help` output and an
+ * invitation for consumers to alias onto it. Which services a given process actually runs is
+ * an application concern; applications declare those flags themselves through
+ * `ConfigurationPort.configureCliArg`. See ADR-020.
+ *
+ * - `--config`                     yargs' own config-file loading
+ * - `-h`/`--help`                  yargs' own help
+ * - `-g`/`--generateDeploymentUnits`  read in `ports/endpoints/index.ts`
+ * - `-l`/`--lift`                  backs `ConfigurationPort.getLift()`
+ *
+ * Parsing stays NON-STRICT: an undeclared flag still parses, it just gets no alias, no type
+ * coercion, no default and no help entry.
+ */
+export declare const getYargsInit: () => Argv<{
+    generateDeploymentUnits: boolean | undefined;
 } & {
-    m: (string | number)[] | undefined;
+    g: boolean | undefined;
 } & {
-    admin: boolean | undefined;
+    lift: (string | number)[] | undefined;
 } & {
-    s: boolean | undefined;
-} & {
-    infrastructure: boolean | undefined;
-} & {
-    i: boolean | undefined;
-} & {
-    requestAuthorization: boolean | undefined;
-} & {
-    r: boolean | undefined;
-} & {
-    outbox: boolean | undefined;
-} & {
-    o: boolean | undefined;
+    l: (string | number)[] | undefined;
 }>;
+/**
+ * Claims `name` -- and `alias`, when given -- on `instance`'s alias registry.
+ *
+ * yargs merges alias groups transitively and SILENTLY: registering a second flag on an alias
+ * another flag already owns makes one `-r` set BOTH targets, with no error and no warning.
+ * That is how teselly's rules worker piggybacked on the dead `requestAuthorization`/`-r` flag
+ * and ran in every pod for months. So a collision is fatal here rather than merely logged --
+ * it always originates in code, never in operator argv, which makes it deterministic at
+ * composition time and impossible to surprise an operator with at runtime.
+ *
+ * @returns `false` when this exact `(name, alias)` pair is already registered, so the caller
+ * can skip re-registering. Adapters do get constructed more than once per process.
+ * @throws when any token is already owned by a DIFFERENT flag, naming both flags.
+ */
+export declare const claimCliArgTokens: (instance: Argv, name: string, alias?: string) => boolean;
 export declare const formatArgs: (config: Record<string, any>) => Promise<Omit<{
     [x: string]: unknown;
-    modules: (string | number)[] | undefined;
-    m: (string | number)[] | undefined;
-    admin: boolean | undefined;
-    s: boolean | undefined;
-    infrastructure: boolean | undefined;
-    i: boolean | undefined;
-    requestAuthorization: boolean | undefined;
-    r: boolean | undefined;
-    outbox: boolean | undefined;
-    o: boolean | undefined;
-    _: (string | number)[];
     $0: string;
-}, "_" | "m" | "$0">>;
+    _: (string | number)[];
+    g: boolean | undefined;
+    generateDeploymentUnits: boolean | undefined;
+    l: (string | number)[] | undefined;
+    lift: (string | number)[] | undefined;
+}, "$0" | "_">>;
 export declare const applyArgs: (config?: Record<string, any>) => Promise<{
     config: any;
     args: Omit<{
         [x: string]: unknown;
-        modules: (string | number)[] | undefined;
-        m: (string | number)[] | undefined;
-        admin: boolean | undefined;
-        s: boolean | undefined;
-        infrastructure: boolean | undefined;
-        i: boolean | undefined;
-        requestAuthorization: boolean | undefined;
-        r: boolean | undefined;
-        outbox: boolean | undefined;
-        o: boolean | undefined;
-        _: (string | number)[];
         $0: string;
-    }, "_" | "m" | "$0">;
+        _: (string | number)[];
+        g: boolean | undefined;
+        generateDeploymentUnits: boolean | undefined;
+        l: (string | number)[] | undefined;
+        lift: (string | number)[] | undefined;
+    }, "$0" | "_">;
 }>;
 //# sourceMappingURL=args.d.ts.map

package/build/ports/configuration/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../../src/ports/configuration/args.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,eAAO,MAAM,QAAQ,sBAAc,CAAC;AAEpC,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;EAiBwC,CAAC;AAGlE,eAAO,MAAM,UAAU,WAAiB,OAAO,MAAM,EAAC,GAAG,CAAC;;;;;;;;;;;;;;qBAIzD,CAAC;AAEF,eAAO,MAAM,SAAS,YAAmB,OAAO,MAAM,EAAE,GAAG,CAAC;;;;;;;;;;;;;;;;;EAM3D,CAAC"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../../src/ports/configuration/args.ts"],"names":[],"mappings":"AACA,OAAc,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAGpC,eAAO,MAAM,QAAQ,gBAAc,CAAC;AAEpC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,YAAY;;;;;;;;EAUwC,CAAC;AAgClE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB,aAAe,IAAI,QAAQ,MAAM,UAAU,MAAM,KAAI,OAWlF,CAAC;AAEF,eAAO,MAAM,UAAU,WAAiB,MAAM,CAAC,MAAM,EAAC,GAAG,CAAC;;;;;;;;eAIzD,CAAC;AAEF,eAAO,MAAM,SAAS,YAAmB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;;;;;;;;;;;EAM3D,CAAC"}

package/build/ports/configuration/args.js

@@ -3,34 +3,97 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.applyArgs = exports.formatArgs = exports.getYargsInit = exports.getYargs = void 0;
+exports.applyArgs = exports.formatArgs = exports.claimCliArgTokens = exports.getYargsInit = exports.getYargs = void 0;
 const ramda_1 = require("ramda");
 const yargs_1 = __importDefault(require("yargs"));
 const common_1 = require("./common");
 const getYargs = () => yargs_1.default;
 exports.getYargs = getYargs;
+/**
+ * The flags pv3 ITSELF reads, and nothing else.
+ *
+ * A flag the framework declares but never reads is a lie in its own `--help` output and an
+ * invitation for consumers to alias onto it. Which services a given process actually runs is
+ * an application concern; applications declare those flags themselves through
+ * `ConfigurationPort.configureCliArg`. See ADR-020.
+ *
+ * - `--config`                     yargs' own config-file loading
+ * - `-h`/`--help`                  yargs' own help
+ * - `-g`/`--generateDeploymentUnits`  read in `ports/endpoints/index.ts`
+ * - `-l`/`--lift`                  backs `ConfigurationPort.getLift()`
+ *
+ * Parsing stays NON-STRICT: an undeclared flag still parses, it just gets no alias, no type
+ * coercion, no default and no help entry.
+ */
 const getYargsInit = () => yargs_1.default
     .config()
     .usage('Usage: $0 [Commands | Options]')
     .help('h')
     .alias('h', 'help')
-    .array('modules')
-    .alias('modules', 'm')
-    .boolean('admin')
-    .alias('admin', 's')
-    .boolean('infrastructure')
-    .alias('infrastructure', 'i')
-    .boolean('requestAuthorization')
-    .alias('requestAuthorization', 'r')
-    .boolean('outbox')
-    .alias('outbox', 'o')
-    .describe('modules', 'Modules to load')
+    .boolean('generateDeploymentUnits')
+    .alias('generateDeploymentUnits', 'g')
+    .array('lift')
+    .alias('lift', 'l')
     .epilog(`copyright bett3r.dev ${new Date().getFullYear()}`);
 exports.getYargsInit = getYargsInit;
+/**
+ * The tokens `getYargsInit()` claims above, as `token -> owning flag name`. Seeded into the
+ * singleton's registry so a consumer reaching for `-l`, `-g` or `-h` collides loudly instead
+ * of silently transitively aliasing onto a framework flag.
+ */
+const FRAMEWORK_CLI_TOKENS = [
+    ['help', 'help'],
+    ['h', 'help'],
+    ['generateDeploymentUnits', 'generateDeploymentUnits'],
+    ['g', 'generateDeploymentUnits'],
+    ['lift', 'lift'],
+    ['l', 'lift']
+];
+/**
+ * One alias registry per yargs instance, with exactly that instance's lifetime: a fresh
+ * registry per jest module registry, a fresh one per process, and nothing retained for an
+ * `Argv` that has been discarded.
+ */
+const cliArgRegistries = new WeakMap();
+const getCliArgRegistry = (instance) => {
+    let registry = cliArgRegistries.get(instance);
+    if (!registry) {
+        registry = new Map(instance === (0, exports.getYargs)() ? FRAMEWORK_CLI_TOKENS : []);
+        cliArgRegistries.set(instance, registry);
+    }
+    return registry;
+};
+/**
+ * Claims `name` -- and `alias`, when given -- on `instance`'s alias registry.
+ *
+ * yargs merges alias groups transitively and SILENTLY: registering a second flag on an alias
+ * another flag already owns makes one `-r` set BOTH targets, with no error and no warning.
+ * That is how teselly's rules worker piggybacked on the dead `requestAuthorization`/`-r` flag
+ * and ran in every pod for months. So a collision is fatal here rather than merely logged --
+ * it always originates in code, never in operator argv, which makes it deterministic at
+ * composition time and impossible to surprise an operator with at runtime.
+ *
+ * @returns `false` when this exact `(name, alias)` pair is already registered, so the caller
+ * can skip re-registering. Adapters do get constructed more than once per process.
+ * @throws when any token is already owned by a DIFFERENT flag, naming both flags.
+ */
+const claimCliArgTokens = (instance, name, alias) => {
+    const registry = getCliArgRegistry(instance);
+    const tokens = alias ? [name, alias] : [name];
+    const collision = tokens
+        .map(token => ({ token, owner: registry.get(token) }))
+        .find(({ owner }) => owner !== undefined && owner !== name);
+    if (collision)
+        throw new Error(`CLI alias collision: "${collision.token}" is already registered for "${collision.owner}" (attempted by "${name}")`);
+    const isNew = tokens.some(token => registry.get(token) !== name);
+    tokens.forEach(token => registry.set(token, name));
+    return isNew;
+};
+exports.claimCliArgTokens = claimCliArgTokens;
 const formatArgs = async (config) => {
     const y = (0, exports.getYargsInit)();
     const args = await y.parseAsync();
-    return (0, ramda_1.omit)(['m', '$0', '_'], args);
+    return (0, ramda_1.omit)(['$0', '_'], args);
 };
 exports.formatArgs = formatArgs;
 const applyArgs = async (config = {}) => {

package/build/ports/configuration/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../../../src/ports/configuration/args.ts"],"names":[],"mappings":";;;;;;AAAA,iCAA6B;AAC7B,kDAA0B;AAC1B,qCAA+C;AAExC,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,eAAK,CAAC;AAAvB,QAAA,QAAQ,YAAe;AAE7B,MAAM,YAAY,GAAG,GAAG,EAAE,CAC/B,eAAK;KACF,MAAM,EAAE;KACR,KAAK,CAAE,gCAAgC,CAAE;KACzC,IAAI,CAAE,GAAG,CAAE;KACX,KAAK,CAAE,GAAG,EAAE,MAAM,CAAE;KACpB,KAAK,CAAE,SAAS,CAAE;KAClB,KAAK,CAAE,SAAS,EAAE,GAAG,CAAE;KACvB,OAAO,CAAE,OAAO,CAAE;KAClB,KAAK,CAAE,OAAO,EAAE,GAAG,CAAE;KACrB,OAAO,CAAE,gBAAgB,CAAE;KAC3B,KAAK,CAAE,gBAAgB,EAAE,GAAG,CAAE;KAC9B,OAAO,CAAE,sBAAsB,CAAE;KACjC,KAAK,CAAE,sBAAsB,EAAE,GAAG,CAAE;KACpC,OAAO,CAAE,QAAQ,CAAE;KACnB,KAAK,CAAE,QAAQ,EAAE,GAAG,CAAE;KACtB,QAAQ,CAAE,SAAS,EAAE,iBAAiB,CAAE;KACxC,MAAM,CAAE,wBAAwB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAE,CAAC;AAjBrD,QAAA,YAAY,gBAiByC;AAG3D,MAAM,UAAU,GAAG,KAAK,EAAE,MAAyB,EAAG,EAAE;IAC7D,MAAM,CAAC,GAAG,IAAA,oBAAY,GAAE,CAAC;IACzB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,UAAU,EAAE,CAAC;IAClC,OAAO,IAAA,YAAI,EAAC,CAAE,GAAG,EAAE,IAAI,EAAE,GAAG,CAAE,EAAE,IAAI,CAAE,CAAC;AACzC,CAAC,CAAC;AAJW,QAAA,UAAU,cAIrB;AAEK,MAAM,SAAS,GAAG,KAAK,EAAG,SAA8B,EAAE,EAAE,EAAE;IACnE,MAAM,IAAI,GAAG,MAAM,IAAA,kBAAU,EAAE,MAAM,CAAE,CAAC;IACxC,OAAO;QACL,MAAM,EAAE,IAAA,4BAAmB,EAAE,MAAM,EAAE,IAAI,CAAE;QAC3C,IAAI;KACL,CAAC;AACJ,CAAC,CAAC;AANW,QAAA,SAAS,aAMpB"}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../../src/ports/configuration/args.ts"],"names":[],"mappings":"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"}

package/build/ports/configuration/common.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mergeConfigProperty = void 0;
+exports.mergeConfigProperty = mergeConfigProperty;
 function mergeConfigProperty(configObj, newConfig) {
     if (!newConfig)
         return configObj;
@@ -15,5 +15,4 @@ function mergeConfigProperty(configObj, newConfig) {
     });
     return configObj;
 }
-exports.mergeConfigProperty = mergeConfigProperty;
 //# sourceMappingURL=common.js.map

package/build/ports/configuration/common.js.map

@@ -1 +1 @@
-{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/ports/configuration/common.ts"],"names":[],"mappings":";;;AAAA,SAAgB,mBAAmB,CAAE,SAAa,EAAE,SAAa;IAC/D,IAAK,CAAC,SAAS;QAAG,OAAO,SAAS,CAAC;IACnC,MAAM,CAAC,mBAAmB,CAAE,SAAS,CAAE,CAAC,OAAO,CAAC,CAAE,IAAI,EAAG,EAAE;QACzD,IAAK,SAAS,CAAC,IAAI,CAAC,IAAI,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAE,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE;YAC/F,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACxC,mBAAmB,CAAE,SAAS,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;SACxD;aAAK;YACJ,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;SACnC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,SAAS,CAAC;AACnB,CAAC;AAXD,kDAWC"}
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/ports/configuration/common.ts"],"names":[],"mappings":";;;AAAA,6BAAqC,SAAa,EAAE,SAAa;IAC/D,IAAK,CAAC,SAAS;QAAG,OAAO,SAAS,CAAC;IACnC,MAAM,CAAC,mBAAmB,CAAE,SAAS,CAAE,CAAC,OAAO,CAAC,CAAE,IAAI,EAAG,EAAE;QACzD,IAAK,SAAS,CAAC,IAAI,CAAC,IAAI,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAE,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAChG,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACxC,mBAAmB,CAAE,SAAS,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,CAAC;aAAK,CAAC;YACL,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/build/ports/configuration/index.d.ts

@@ -6,5 +6,5 @@ declare global {
         }
     }
 }
-export declare const Configuration: (...adapters: ConfigurationAdapter[]) => Promise<ConfigurationPort>;
+export declare const Configuration: (...adapters: (ConfigurationAdapter | string)[]) => Promise<ConfigurationPort>;
 //# sourceMappingURL=index.d.ts.map

package/build/ports/configuration/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ports/configuration/index.ts"],"names":[],"mappings":"AACA,OAAO,EAA0C,oBAAoB,EAAE,iBAAiB,EAAqD,MAAM,uBAAuB,CAAC;AAS3K,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,UAAU,CAAC;QACnB,UAAU,MAAM;YACd,OAAO,EAAE,MAAM,CAAA;SAChB;KACF;CACF;AAUD,eAAO,MAAM,aAAa,gBAAkB,oBAAoB,EAAE,KAAG,QAAQ,iBAAiB,CA0F7F,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ports/configuration/index.ts"],"names":[],"mappings":"AACA,OAAO,EAA0C,oBAAoB,EAAE,iBAAiB,EAAqD,MAAM,uBAAuB,CAAC;AAS3K,OAAO,CAAC,MAAM,CAAC,CAAC;IACd,UAAU,UAAU,CAAC,CAAC;QACpB,UAAU,MAAM;YACd,OAAO,EAAE,MAAM,CAAA;SAChB;KACF;CACF;AAUD,eAAO,MAAM,aAAa,gBAAkB,CAAE,oBAAoB,GAAG,MAAM,CAAE,EAAE,KAAG,OAAO,CAAC,iBAAiB,CA4H1G,CAAC"}