@mmnto/totem 1.113.1 → 1.115.0

package/dist/seat-lifecycle.js

@@ -0,0 +1,197 @@
+/**
+ * Declared seat lifecycle — the per-seat `lifecycle.json` marker behind
+ * `totem seat add | suspend | remove | list` (mmnto-ai/totem#2511).
+ *
+ * Seat EXISTENCE stays dir-derived (`readSeatDirs`, the mmnto-ai/totem#2141
+ * dirs-union invariant): a seat's first write registers it, and this file adds
+ * no second registration surface. An ABSENT marker means `active`, so a
+ * markerless tree behaves bit-identically to a pre-#2511 one. Lifecycle
+ * filters downstream consumers (broadcast denominators, annotations); it never
+ * decides who exists — `resolveSelfAgents` stays lifecycle-blind.
+ *
+ * Reads FAIL OPEN and LOUD: an unreadable or invalid marker degrades to
+ * `active` with a warning that names the marker file, because a corrupt marker
+ * must never shrink a broadcast denominator (wrongly closing an obligation)
+ * nor hide held mail. Writes fail HARD: the atomic helper leaves the old
+ * marker or the new one, never a torn transition.
+ *
+ * The whole tree is gitignored, so markers are machine-local by design —
+ * the same scope ECL coordination already has.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { z } from 'zod';
+import { getErrorMessage, TotemError } from './errors.js';
+import { writeFileAtomicSync } from './fs-atomic.js';
+import { isPathSafeAgentId, readSeatDirs } from './orchestration-resolver.js';
+/** Marker filename inside `<repoRoot>/.totem/orchestration/<seat>/`. */
+export const SEAT_LIFECYCLE_FILENAME = 'lifecycle.json';
+/** The on-disk compatibility contract for a lifecycle marker. */
+export const SEAT_LIFECYCLE_SCHEMA_VERSION = 1;
+const TOTEM_DIR = '.totem';
+const ORCHESTRATION_DIR = 'orchestration';
+/**
+ * Errno values that PROVE a marker is absent rather than unreadable. Every
+ * other errno is a real read failure and earns a warning: "I could not tell"
+ * must never render as "there is no marker" (`worktreePathExists`'s posture).
+ */
+const MARKER_ABSENT_ERRNOS = new Set(['ENOENT', 'ENOTDIR']);
+/**
+ * `errors.ts` is out of this slice's scope, so the two refusal classes reuse
+ * existing codes and are named here — one edit site if a `SEAT_*` code is
+ * later minted.
+ */
+const SEAT_LIFECYCLE_INVALID_CODE = 'CONFIG_INVALID';
+const SEAT_LIFECYCLE_WRITE_FAILED_CODE = 'CHECK_FAILED';
+/**
+ * The closed lifecycle set. DECLARED state only — operator-driven and durable.
+ * Session state (`LIVE`/`IDLE`/`FAULTED`) is a different axis entirely: it is
+ * DERIVED by the totem-status#127 projection, which CONSUMES lifecycle.
+ */
+export const SeatLifecycleStateSchema = z.enum(['active', 'suspended', 'retired']);
+/**
+ * The `lifecycle.json` payload.
+ *
+ * `.strict()` plus the closed enum is what makes the totem-status#127 axis
+ * ruling STRUCTURAL rather than advisory: session-state vocabulary
+ * (`LIVE`/`IDLE`/`FAULTED`) is unrepresentable here — not as a `state` value
+ * (the enum rejects it) and not as a smuggled sibling key (strict rejects it).
+ * A marker can only ever say what was declared.
+ *
+ * `by` is resolved from the environment BY CALLERS (the `TOTEM_SELF_AGENT`
+ * seat) or honestly absent — a stamped absence, never a fabricated attribution
+ * (the mmnto-ai/totem#2625 MB-2 rule).
+ */
+export const SeatLifecycleMarkerSchema = z
+    .object({
+    schemaVersion: z.literal(SEAT_LIFECYCLE_SCHEMA_VERSION),
+    state: SeatLifecycleStateSchema,
+    /** ISO-8601 instant of the transition, stamped at the write site. */
+    since: z.string().datetime({ offset: true }),
+    by: z.string().trim().min(1).optional(),
+    /** Operator's recorded ruling — the §6.6 audit trail when present. */
+    reason: z.string().optional(),
+})
+    .strict();
+/** Absolute path to a seat's marker file. Caller guarantees a safe `agentId`. */
+function markerPathFor(repoRoot, agentId) {
+    return path.join(path.resolve(repoRoot), TOTEM_DIR, ORCHESTRATION_DIR, agentId, SEAT_LIFECYCLE_FILENAME);
+}
+/** The fail-open answer: a seat with no usable marker is `active`. */
+function defaultActive(warning) {
+    return warning === undefined
+        ? { state: 'active', source: 'default-active' }
+        : { state: 'active', source: 'default-active', warning };
+}
+/**
+ * The degraded-read warning. It names the marker file because the recovery
+ * route is "fix or delete the marker" — the message hands over the one-step
+ * target rather than making the reader hunt for it.
+ */
+function unusableMarkerWarning(markerPath, agentId, detail) {
+    return `seat "${agentId}": unusable lifecycle marker at ${markerPath} (${detail}) — treating the seat as active; fix or delete the marker`;
+}
+/** Flatten zod issues into one line for a warning or error detail. */
+function describeIssues(err) {
+    return err.issues
+        .map((issue) => `${issue.path.join('.') || '<root>'}: ${issue.message}`)
+        .join('; ');
+}
+/**
+ * Read one seat's declared lifecycle. NEVER throws — every failure direction
+ * lands on `active` with a warning, because refusing to answer would take a
+ * poll, a `seat list`, or a doctor check down with one bad file.
+ *
+ * An unsafe `agentId` degrades the same way rather than throwing: this is a
+ * read path, and the caller may be enumerating ids it did not choose.
+ */
+export function readSeatLifecycle(repoRoot, agentId) {
+    if (!isPathSafeAgentId(agentId)) {
+        // JSON.stringify escapes control characters: echoing a raw unsafe id into
+        // a CLI log is the terminal-injection class the guard exists to stop.
+        return defaultActive(`unsafe seat id ${JSON.stringify(agentId)} — refusing to resolve a lifecycle marker path; treating the seat as active`);
+    }
+    const markerPath = markerPathFor(repoRoot, agentId);
+    let raw;
+    // totem-context: intentional degradation — the catch IS the answer: ENOENT/ENOTDIR PROVE the marker is absent (the expected state of every seat that predates #2511, silent by contract), and every other errno degrades LOUDLY to active so a corrupt marker can never shrink a broadcast denominator.
+    try {
+        raw = fs.readFileSync(markerPath, 'utf-8');
+        // totem-context: intentional degradation — see directive above the try; dual placement so the rule fires on either the catch-keyword line or the catch-body line.
+    }
+    catch (err) {
+        const code = err !== null && typeof err === 'object' && 'code' in err
+            ? err.code
+            : undefined;
+        if (code !== undefined && MARKER_ABSENT_ERRNOS.has(code)) {
+            return defaultActive();
+        }
+        return defaultActive(unusableMarkerWarning(markerPath, agentId, getErrorMessage(err)));
+    }
+    let payload;
+    // totem-context: intentional degradation — malformed JSON is the corrupt-marker failure mode (#2511 failure table): warn naming the file and fail open to active, never throw out of a read path.
+    try {
+        payload = JSON.parse(raw);
+        // totem-context: intentional degradation — see directive above the try; dual placement so the rule fires on either the catch-keyword line or the catch-body line.
+    }
+    catch (err) {
+        return defaultActive(unusableMarkerWarning(markerPath, agentId, getErrorMessage(err)));
+    }
+    const parsed = SeatLifecycleMarkerSchema.safeParse(payload);
+    if (!parsed.success) {
+        return defaultActive(unusableMarkerWarning(markerPath, agentId, describeIssues(parsed.error)));
+    }
+    return { state: parsed.data.state, source: 'marker', marker: parsed.data };
+}
+/**
+ * Write (or replace) one seat's marker atomically and return the marker path.
+ *
+ * Overwriting an existing marker — including a corrupt one — is deliberate:
+ * the verbs ARE the recovery path for the degraded read above. Callers surface
+ * the pre-write warning from `readSeatLifecycle`; they do not refuse the write.
+ *
+ * Throws on an unsafe seat id or a schema-invalid marker (both are caller
+ * errors that must not reach disk) and on any I/O failure — the atomic helper
+ * guarantees the old marker survives a failed write.
+ */
+export function writeSeatLifecycle(repoRoot, agentId, marker) {
+    if (!isPathSafeAgentId(agentId)) {
+        throw new TotemError(SEAT_LIFECYCLE_INVALID_CODE, `Refusing to write a lifecycle marker for unsafe seat id ${JSON.stringify(agentId)}.`, 'Seat ids are single path segments: no separators, `..`, null byte, control/whitespace, or win32-reserved characters.');
+    }
+    const parsed = SeatLifecycleMarkerSchema.safeParse(marker);
+    if (!parsed.success) {
+        throw new TotemError(SEAT_LIFECYCLE_INVALID_CODE, `Refusing to write a lifecycle marker that violates the schema: ${describeIssues(parsed.error)}`, 'The marker schema is strict by contract (session state is not lifecycle state) — fix the caller rather than widening the schema.');
+    }
+    const markerPath = markerPathFor(repoRoot, agentId);
+    try {
+        fs.mkdirSync(path.dirname(markerPath), { recursive: true });
+        writeFileAtomicSync(markerPath, JSON.stringify(parsed.data, null, 2) + '\n');
+    }
+    catch (err) {
+        throw new TotemError(SEAT_LIFECYCLE_WRITE_FAILED_CODE, `Could not write the lifecycle marker at ${markerPath}: ${getErrorMessage(err)}`, 'Check write permissions on the seat directory and free disk space, then re-run — the write is atomic, so the seat is still in its previous state.', err);
+    }
+    return markerPath;
+}
+/**
+ * Every registered seat in a repo with its declared lifecycle, sorted by seat
+ * (`readSeatDirs` order).
+ *
+ * DERIVED at read time and never cached or persisted (Tenet 20): the dirs are
+ * the roster and the markers are the state, so a transition is visible to the
+ * very next read with no invalidation step — which is what lets `pollMail`
+ * consume per-invocation markers without a staleness seam.
+ */
+export function deriveSeatStatuses(repoRoot) {
+    return readSeatDirs(repoRoot).map((seat) => {
+        const read = readSeatLifecycle(repoRoot, seat);
+        const status = { seat, state: read.state, source: read.source };
+        if (read.marker !== undefined) {
+            status.since = read.marker.since;
+            status.marker = read.marker;
+        }
+        if (read.warning !== undefined) {
+            status.warning = read.warning;
+        }
+        return status;
+    });
+}
+//# sourceMappingURL=seat-lifecycle.js.map

package/dist/seat-lifecycle.js.map

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

package/dist/seat-lifecycle.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tests for the declared seat-lifecycle markers (mmnto-ai/totem#2511).
+ *
+ * Filesystem-driven against real temp trees, mirroring
+ * `orchestration-resolver.test.ts` so the two seat-surface suites stay
+ * symmetric. The load-bearing invariants here are the fail-open read (a
+ * corrupt marker degrades to `active` and says so, naming the file) and the
+ * structural exclusion of session-state vocabulary from the marker schema.
+ */
+export {};
+//# sourceMappingURL=seat-lifecycle.test.d.ts.map

package/dist/seat-lifecycle.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seat-lifecycle.test.d.ts","sourceRoot":"","sources":["../src/seat-lifecycle.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/seat-lifecycle.test.js

@@ -0,0 +1,210 @@
+/**
+ * Tests for the declared seat-lifecycle markers (mmnto-ai/totem#2511).
+ *
+ * Filesystem-driven against real temp trees, mirroring
+ * `orchestration-resolver.test.ts` so the two seat-surface suites stay
+ * symmetric. The load-bearing invariants here are the fail-open read (a
+ * corrupt marker degrades to `active` and says so, naming the file) and the
+ * structural exclusion of session-state vocabulary from the marker schema.
+ */
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { TotemError } from './errors.js';
+import { deriveSeatStatuses, readSeatLifecycle, SEAT_LIFECYCLE_FILENAME, SEAT_LIFECYCLE_SCHEMA_VERSION, SeatLifecycleMarkerSchema, writeSeatLifecycle, } from './seat-lifecycle.js';
+import { cleanTmpDir } from './test-utils.js';
+let tmpRoot;
+let repoRoot;
+const SINCE = '2026-08-11T04:00:00Z';
+function markerPath(seat) {
+    return path.join(repoRoot, '.totem', 'orchestration', seat, SEAT_LIFECYCLE_FILENAME);
+}
+/** Create the seat dir (the registration) without writing any marker. */
+function mkSeat(seat) {
+    fs.mkdirSync(path.join(repoRoot, '.totem', 'orchestration', seat), { recursive: true });
+}
+/** Plant raw bytes as a seat's marker — the corrupt-file fixture. */
+function plantRawMarker(seat, contents) {
+    mkSeat(seat);
+    fs.writeFileSync(markerPath(seat), contents, 'utf-8');
+}
+function marker(overrides = {}) {
+    return {
+        schemaVersion: SEAT_LIFECYCLE_SCHEMA_VERSION,
+        state: 'active',
+        since: SINCE,
+        ...overrides,
+    };
+}
+beforeEach(() => {
+    // totem-context: test fixture only; agents do not consume this temp dir.
+    tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'totem-seat-'));
+    repoRoot = path.join(tmpRoot, 'r');
+    fs.mkdirSync(repoRoot, { recursive: true });
+});
+afterEach(() => {
+    cleanTmpDir(tmpRoot);
+});
+// ─── Absent marker ─────────────────────────────────────────────────────────
+describe('readSeatLifecycle — absent marker', () => {
+    it('reports active/default-active with NO warning when the seat has no marker', () => {
+        mkSeat('a-seat');
+        const result = readSeatLifecycle(repoRoot, 'a-seat');
+        expect(result.state).toBe('active');
+        expect(result.source).toBe('default-active');
+        expect(result.warning).toBeUndefined();
+        expect(result.marker).toBeUndefined();
+    });
+    it('reports active/default-active with no warning when the whole tree is absent', () => {
+        const result = readSeatLifecycle(repoRoot, 'never-written');
+        expect(result.state).toBe('active');
+        expect(result.source).toBe('default-active');
+        expect(result.warning).toBeUndefined();
+    });
+});
+// ─── Corrupt marker: fail open, name the file ──────────────────────────────
+describe('readSeatLifecycle — unusable marker', () => {
+    it('degrades malformed JSON to active with a warning naming the marker path', () => {
+        plantRawMarker('a-seat', '{ this is not json');
+        const result = readSeatLifecycle(repoRoot, 'a-seat');
+        expect(result.state).toBe('active');
+        expect(result.source).toBe('default-active');
+        expect(result.warning).toContain(markerPath('a-seat'));
+        expect(result.warning).toContain('fix or delete the marker');
+    });
+    it('degrades a schema-invalid marker to active with a warning naming the marker path', () => {
+        plantRawMarker('a-seat', JSON.stringify({ schemaVersion: 1, state: 'LIVE', since: SINCE }));
+        const result = readSeatLifecycle(repoRoot, 'a-seat');
+        expect(result.state).toBe('active');
+        expect(result.source).toBe('default-active');
+        expect(result.warning).toContain(markerPath('a-seat'));
+    });
+    it('degrades a corrupt RETIRED marker to active — fails toward obligation-held', () => {
+        plantRawMarker('a-seat', '{"schemaVersion":1,"state":"retired"');
+        const result = readSeatLifecycle(repoRoot, 'a-seat');
+        expect(result.state).toBe('active');
+        expect(result.warning).toContain(markerPath('a-seat'));
+    });
+});
+// ─── Schema: the axis ruling, made structural ──────────────────────────────
+describe('SeatLifecycleMarkerSchema', () => {
+    it.each(['LIVE', 'IDLE', 'FAULTED'])('rejects session-state vocabulary as state: %s', (state) => {
+        expect(SeatLifecycleMarkerSchema.safeParse({ schemaVersion: 1, state, since: SINCE }).success).toBe(false);
+    });
+    it('accepts each declared lifecycle state', () => {
+        for (const state of ['active', 'suspended', 'retired']) {
+            expect(SeatLifecycleMarkerSchema.safeParse(marker({ state })).success).toBe(true);
+        }
+    });
+    it('rejects unknown keys — no session state smuggled in as a sibling field', () => {
+        expect(SeatLifecycleMarkerSchema.safeParse({ ...marker(), sessionState: 'LIVE' }).success).toBe(false);
+    });
+    it('rejects a schemaVersion other than 1', () => {
+        expect(SeatLifecycleMarkerSchema.safeParse({ ...marker(), schemaVersion: 2 }).success).toBe(false);
+    });
+    it('rejects an empty or whitespace-only `by`', () => {
+        expect(SeatLifecycleMarkerSchema.safeParse({ ...marker(), by: '' }).success).toBe(false);
+        expect(SeatLifecycleMarkerSchema.safeParse({ ...marker(), by: '   ' }).success).toBe(false);
+    });
+    it('rejects a non-ISO-8601 `since`', () => {
+        expect(SeatLifecycleMarkerSchema.safeParse({ ...marker(), since: '2026-08-11' }).success).toBe(false);
+    });
+});
+// ─── Write → read round-trip ───────────────────────────────────────────────
+describe('writeSeatLifecycle', () => {
+    it.each(['active', 'suspended', 'retired'])('round-trips state %s', (state) => {
+        writeSeatLifecycle(repoRoot, 'a-seat', marker({ state, by: 'totem-claude', reason: 'ruled' }));
+        const result = readSeatLifecycle(repoRoot, 'a-seat');
+        expect(result.state).toBe(state);
+        expect(result.source).toBe('marker');
+        expect(result.marker).toEqual({
+            schemaVersion: SEAT_LIFECYCLE_SCHEMA_VERSION,
+            state,
+            since: SINCE,
+            by: 'totem-claude',
+            reason: 'ruled',
+        });
+    });
+    it('omits `by` entirely when the caller did not resolve one — never fabricated', () => {
+        writeSeatLifecycle(repoRoot, 'a-seat', marker({ state: 'suspended' }));
+        const raw = JSON.parse(fs.readFileSync(markerPath('a-seat'), 'utf-8'));
+        expect(Object.keys(raw).sort()).toEqual([
+            'schemaVersion',
+            'since',
+            'state',
+        ]);
+        // The written bytes round-trip the STRICT schema — no field the reader rejects.
+        expect(SeatLifecycleMarkerSchema.safeParse(raw).success).toBe(true);
+        expect(readSeatLifecycle(repoRoot, 'a-seat').marker?.by).toBeUndefined();
+    });
+    it('creates the seat directory when the seat has never written', () => {
+        const written = writeSeatLifecycle(repoRoot, 'fresh-seat', marker());
+        expect(written).toBe(markerPath('fresh-seat'));
+        expect(fs.existsSync(markerPath('fresh-seat'))).toBe(true);
+    });
+    it('overwrites a corrupt marker — the verbs ARE the recovery path', () => {
+        plantRawMarker('a-seat', 'not json at all');
+        expect(readSeatLifecycle(repoRoot, 'a-seat').warning).toBeDefined();
+        writeSeatLifecycle(repoRoot, 'a-seat', marker({ state: 'suspended' }));
+        const healed = readSeatLifecycle(repoRoot, 'a-seat');
+        expect(healed.state).toBe('suspended');
+        expect(healed.source).toBe('marker');
+        expect(healed.warning).toBeUndefined();
+    });
+    it('throws a TotemError on a schema-invalid marker rather than writing it', () => {
+        expect(() => writeSeatLifecycle(repoRoot, 'a-seat', { ...marker(), state: 'LIVE' })).toThrow(TotemError);
+        expect(fs.existsSync(markerPath('a-seat'))).toBe(false);
+    });
+});
+// ─── Unsafe seat ids ───────────────────────────────────────────────────────
+describe('unsafe seat ids', () => {
+    it.each(['../escape', 'a/b', ''])('read degrades to default-active with a warning: %j', (id) => {
+        const result = readSeatLifecycle(repoRoot, id);
+        expect(result.state).toBe('active');
+        expect(result.source).toBe('default-active');
+        expect(result.warning).toContain('unsafe seat id');
+    });
+    it.each(['../escape', 'a/b', ''])('write throws a TotemError: %j', (id) => {
+        expect(() => writeSeatLifecycle(repoRoot, id, marker())).toThrow(TotemError);
+    });
+    it('does not write outside the orchestration tree for a traversal id', () => {
+        expect(() => writeSeatLifecycle(repoRoot, '../..', marker())).toThrow(TotemError);
+        expect(fs.existsSync(path.join(tmpRoot, SEAT_LIFECYCLE_FILENAME))).toBe(false);
+    });
+});
+// ─── deriveSeatStatuses ────────────────────────────────────────────────────
+describe('deriveSeatStatuses', () => {
+    it('returns one sorted row per seat dir with read-time state', () => {
+        mkSeat('a-seat');
+        writeSeatLifecycle(repoRoot, 'b-seat', marker({ state: 'suspended', reason: 'paused' }));
+        plantRawMarker('c-seat', '{ corrupt');
+        writeSeatLifecycle(repoRoot, 'd-seat', marker({ state: 'retired' }));
+        // Routing surfaces are not seats.
+        fs.mkdirSync(path.join(repoRoot, '.totem', 'orchestration', '_broadcast'), { recursive: true });
+        const statuses = deriveSeatStatuses(repoRoot);
+        expect(statuses.map((s) => s.seat)).toEqual(['a-seat', 'b-seat', 'c-seat', 'd-seat']);
+        expect(statuses.map((s) => s.state)).toEqual(['active', 'suspended', 'active', 'retired']);
+        expect(statuses.map((s) => s.source)).toEqual([
+            'default-active',
+            'marker',
+            'default-active',
+            'marker',
+        ]);
+        expect(statuses[0]?.warning).toBeUndefined();
+        expect(statuses[0]?.since).toBeUndefined();
+        expect(statuses[1]?.since).toBe(SINCE);
+        expect(statuses[1]?.marker?.reason).toBe('paused');
+        expect(statuses[2]?.warning).toContain(markerPath('c-seat'));
+    });
+    it('returns an empty list when no orchestration tree exists', () => {
+        expect(deriveSeatStatuses(repoRoot)).toEqual([]);
+    });
+    it('reflects a transition on the very next read — nothing is cached', () => {
+        writeSeatLifecycle(repoRoot, 'a-seat', marker({ state: 'active' }));
+        expect(deriveSeatStatuses(repoRoot)[0]?.state).toBe('active');
+        writeSeatLifecycle(repoRoot, 'a-seat', marker({ state: 'suspended' }));
+        expect(deriveSeatStatuses(repoRoot)[0]?.state).toBe('suspended');
+    });
+});
+//# sourceMappingURL=seat-lifecycle.test.js.map

package/dist/seat-lifecycle.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seat-lifecycle.test.js","sourceRoot":"","sources":["../src/seat-lifecycle.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAErE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,6BAA6B,EAE7B,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,IAAI,OAAe,CAAC;AACpB,IAAI,QAAgB,CAAC;AAErB,MAAM,KAAK,GAAG,sBAAsB,CAAC;AAErC,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,uBAAuB,CAAC,CAAC;AACvF,CAAC;AAED,yEAAyE;AACzE,SAAS,MAAM,CAAC,IAAY;IAC1B,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,qEAAqE;AACrE,SAAS,cAAc,CAAC,IAAY,EAAE,QAAgB;IACpD,MAAM,CAAC,IAAI,CAAC,CAAC;IACb,EAAE,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,MAAM,CAAC,YAA0C,EAAE;IAC1D,OAAO;QACL,aAAa,EAAE,6BAA6B;QAC5C,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,KAAK;QACZ,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,UAAU,CAAC,GAAG,EAAE;IACd,yEAAyE;IACzE,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IAChE,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACnC,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,GAAG,EAAE;IACb,WAAW,CAAC,OAAO,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAE9E,QAAQ,CAAC,mCAAmC,EAAE,GAAG,EAAE;IACjD,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACnF,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjB,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;QAC5D,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAE9E,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,cAAc,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;QACvD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kFAAkF,EAAE,GAAG,EAAE;QAC1F,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC5F,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4EAA4E,EAAE,GAAG,EAAE;QACpF,cAAc,CAAC,QAAQ,EAAE,sCAAsC,CAAC,CAAC;QACjE,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAE9E,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,+CAA+C,EAAE,CAAC,KAAK,EAAE,EAAE;QAC9F,MAAM,CACJ,yBAAyB,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CACvF,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,KAAK,MAAM,KAAK,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAU,EAAE,CAAC;YAChE,MAAM,CAAC,yBAAyB,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpF,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,CAAC,yBAAyB,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAC7F,KAAK,CACN,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,yBAAyB,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CACzF,KAAK,CACN,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,yBAAyB,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzF,MAAM,CAAC,yBAAyB,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,yBAAyB,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAC5F,KAAK,CACN,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAE9E,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAU,CAAC,CAAC,sBAAsB,EAAE,CAAC,KAAK,EAAE,EAAE;QACrF,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QAC/F,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YAC5B,aAAa,EAAE,6BAA6B;YAC5C,KAAK;YACL,KAAK,EAAE,KAAK;YACZ,EAAE,EAAE,cAAc;YAClB,MAAM,EAAE,OAAO;SAChB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4EAA4E,EAAE,GAAG,EAAE;QACpF,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;QACvE,MAAM,GAAG,GAAY,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QAChF,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAA8B,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC;YACjE,eAAe;YACf,OAAO;YACP,OAAO;SACR,CAAC,CAAC;QACH,gFAAgF;QAChF,MAAM,CAAC,yBAAyB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpE,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,OAAO,GAAG,kBAAkB,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;QACrE,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;QAC/C,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,cAAc,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QAC5C,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QAEpE,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;QAEvE,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,MAAM,CAAC,GAAG,EAAE,CACV,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAW,CAAC,CAChF,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACtB,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAE9E,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,oDAAoD,EAAE,CAAC,EAAE,EAAE,EAAE;QAC7F,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,+BAA+B,EAAE,CAAC,EAAE,EAAE,EAAE;QACxE,MAAM,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAClF,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAE9E,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QACzF,cAAc,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACtC,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QACrE,kCAAkC;QAClC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhG,MAAM,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAE9C,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;QACtF,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;QAC3F,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YAC5C,gBAAgB;YAChB,QAAQ;YACR,gBAAgB;YAChB,QAAQ;SACT,CAAC,CAAC;QAEH,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,aAAa,EAAE,CAAC;QAC7C,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC;QAC3C,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QACpE,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE9D,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;QACvE,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}