@justfortytwo/installer 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Enrico Deleo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,70 @@
+# @justfortytwo/installer
+
+The all-in-one installer and lifecycle CLI for **fortytwo** — a personal
+assistant built on Claude Code. One package ships two bins:
+
+- **`create-fortytwo`** — the install-time alias (`npm create fortytwo` /
+  `npx create-fortytwo`). With no verb, it runs `init`.
+- **`fortytwo`** — the everyday lifecycle alias for the verbs below.
+
+## The two-surface model
+
+fortytwo is delivered as **two surfaces**, and this CLI is the single
+operator interface over both:
+
+1. **The npm engine.** The reusable machinery — the memory MCP server, the
+   safety gate, the channel adapters, and the local embedder — published as
+   `@justfortytwo/*` packages and wired in as Claude Code plugins. This is
+   shared, versioned code.
+2. **The scaffolded persona.** `CLAUDE.md` + `context/*` — who the assistant is
+   and who it serves. This is **not** a plugin. It is per-user, personal, and
+   gitignored. The CLI **scaffolds** it by rendering the `@justfortytwo/persona`
+   package's `templates/` (guided by its `manifest.json`) against your captured
+   answers in `.fortytwo/identity.json`. Re-rendering is idempotent and never
+   clobbers fields you've captured or hand-edited.
+
+Secrets live only in a gitignored `.env`; your captured identity lives in the
+gitignored `.fortytwo/identity.json`; neither is ever committed.
+
+## Verbs
+
+| Verb       | What it does |
+|------------|--------------|
+| `init`     | Capture your assistant's name + owner details (interactive, or via flags/env for CI). Writes `.fortytwo/identity.json`, secrets to `.env`, renders the persona, provisions local infra (pulls the embedder model, migrates the memory DB), records the installed version set, and issues a pairing code. |
+| `pair`     | Issue a one-time `/login` pairing code to bind another chat/device to a channel. |
+| `doctor`   | Health-check the engine: boot the memory MCP and assert its tool contract, fire a synthetic event at the safety gate, confirm DB migrations are applied, check the embedder model is pulled, and cross-check installed sibling versions against the declared compatibility ranges. |
+| `update`   | Resolve the latest in-range version of each engine package, install, then run `doctor` to verify. On failure it points you to `rollback`. |
+| `rollback` | Restore the previous version set recorded before the last `update`. |
+| `enrich`   | Capture more answers to deepen the persona, then re-render (no clobber). |
+| `forget`   | Redact or remove specific memories from the memory store. |
+| `unbind`   | Revoke a channel binding (un-pair a chat / drop it from the allowlist). |
+
+Run `fortytwo <verb> --help` for verb-specific options.
+
+## Update safety
+
+Distribution follows a **semver-ranges, latest-compatible** policy — there is no
+curated bill-of-materials. `update` installs the latest in-range version of each
+engine package and then runs `doctor` as a post-install health check. **Rollback
+is manual**: the prior version set is recorded before every update, so
+`fortytwo rollback` can restore exactly the set that was running before.
+
+## The embedder
+
+The engine uses a **local** embedder for privacy — personal data never leaves
+your machine. The standard model is `qwen3-embedding:0.6b`, served by Ollama;
+`init` pulls it and `doctor` verifies it.
+
+## Requirements
+
+- Node.js >= 18
+- [Ollama](https://ollama.com/) for the local embedder (optional but
+  recommended — the engine degrades gracefully without it)
+
+## License
+
+MIT © 2026 Enrico Deleo
+
+---
+
+Created and maintained by [**Enrico Deleo**](https://enricodeleo.com).

package/dist/commands/doctor.d.ts

@@ -0,0 +1,36 @@
+import { type MigrationState } from '../engine.js';
+export interface CheckResult {
+    name: string;
+    ok: boolean;
+    detail: string;
+    /** A failed required check makes doctor exit non-zero; warn-only checks don't. */
+    required: boolean;
+}
+/** Everything the checks need, injectable so tests stay hermetic. */
+export interface DoctorDeps {
+    loadGate: () => Promise<{
+        POLICY_SCHEMA_VERSION?: number;
+    } | null>;
+    loadMemory: () => Promise<{
+        MEMORY_TOOL_CONTRACT_VERSION?: number;
+    } | null>;
+    installedVersion: (spec: string) => string | null;
+    /** spec -> declared semver range (from this CLI's fortytwo.compat). */
+    compatRanges: Record<string, string>;
+    /** Installed Ollama model names, or null if unreachable. */
+    ollamaModels: () => Promise<string[] | null>;
+    embedModel: string;
+    migrationState: () => Promise<MigrationState>;
+}
+/**
+ * Run all checks, return per-check results + aggregate. Reused by `update` as
+ * the post-install verify step. Aggregate ok = every required check passed.
+ */
+export declare function runDoctorChecks(deps: DoctorDeps): Promise<{
+    results: CheckResult[];
+    ok: boolean;
+}>;
+/** Wire the real engine siblings, Ollama, and memory DB into the checks. */
+export declare function defaultDoctorDeps(): DoctorDeps;
+export declare function runDoctor(_argv: string[]): Promise<number>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAaA,OAAO,EAEkD,KAAK,cAAc,EAC3E,MAAM,cAAc,CAAC;AAQtB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,qEAAqE;AACrE,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,OAAO,CAAC;QAAE,qBAAqB,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACnE,UAAU,EAAE,MAAM,OAAO,CAAC;QAAE,4BAA4B,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAC5E,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAClD,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,4DAA4D;IAC5D,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;CAC/C;AAyED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,EAAE,EAAE,OAAO,CAAA;CAAE,CAAC,CAUxG;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,IAAI,UAAU,CAa9C;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAQhE"}

package/dist/commands/doctor.js

@@ -0,0 +1,126 @@
+// doctor — the post-verify health check. Run standalone, and also automatically
+// at the end of `update` to decide whether an upgrade is healthy or needs rollback.
+//
+// Each check is independent and reported individually so a partial failure is
+// actionable. Exit code is non-zero if ANY required check fails; warn-only
+// checks (embedder) never fail the run.
+//
+// Checks are pure functions of an injected `DoctorDeps`, so they unit-test
+// hermetically; `defaultDoctorDeps()` wires the real engine siblings + Ollama +
+// the memory DB. CROSS-PACKAGE CONTRACTS asserted: gate's POLICY_SCHEMA_VERSION
+// and memory's MEMORY_TOOL_CONTRACT_VERSION must equal what this CLI was built
+// against, and installed siblings must satisfy the declared compat ranges.
+import { loadGate, loadMemory, readInstalledVersion, readSelfCompatRanges, satisfiesRange, fetchOllamaModels, readMigrationState, } from '../engine.js';
+import { EMBED_MODEL, DEFAULT_OLLAMA_BASE_URL, DEFAULT_DB_PATH } from './init.js';
+// The contract versions this CLI was authored against. A sibling advertising a
+// different MAJOR has broken the contract — doctor must flag it loudly.
+const EXPECTED_POLICY_SCHEMA = 1;
+const EXPECTED_MEMORY_CONTRACT = 1;
+async function checkGate(deps) {
+    const name = 'safety gate';
+    const gate = await deps.loadGate();
+    if (!gate) {
+        return { name, ok: false, required: true, detail: '@justfortytwo/gate is not installed' };
+    }
+    const v = gate.POLICY_SCHEMA_VERSION;
+    if (v !== EXPECTED_POLICY_SCHEMA) {
+        return { name, ok: false, required: true, detail: `policySchema version ${v} != expected ${EXPECTED_POLICY_SCHEMA}` };
+    }
+    return { name, ok: true, required: true, detail: `gate present, policySchema v${v}` };
+}
+async function checkMemoryContract(deps) {
+    const name = 'memory-mcp contract';
+    const mem = await deps.loadMemory();
+    if (!mem) {
+        return { name, ok: false, required: true, detail: '@justfortytwo/memory is not installed' };
+    }
+    const v = mem.MEMORY_TOOL_CONTRACT_VERSION;
+    if (v !== EXPECTED_MEMORY_CONTRACT) {
+        return { name, ok: false, required: true, detail: `memory tool contract version ${v} != expected ${EXPECTED_MEMORY_CONTRACT}` };
+    }
+    return { name, ok: true, required: true, detail: `memory present, tool contract v${v}` };
+}
+async function checkCompat(deps) {
+    const name = 'peerDeps / fortytwo.compat';
+    const drift = [];
+    const seen = [];
+    for (const [spec, range] of Object.entries(deps.compatRanges)) {
+        const installed = deps.installedVersion(spec);
+        if (installed === null)
+            continue; // optional sibling not installed — not a drift
+        seen.push(`${spec}@${installed}`);
+        if (!satisfiesRange(installed, range))
+            drift.push(`${spec}@${installed} ∉ ${range}`);
+    }
+    if (drift.length > 0) {
+        return { name, ok: false, required: true, detail: `compat drift: ${drift.join('; ')}` };
+    }
+    return { name, ok: true, required: true, detail: seen.length ? `in range: ${seen.join(', ')}` : 'no engine siblings installed' };
+}
+async function checkEmbedder(deps) {
+    // Warn-only: a missing embedder degrades semantic recall (FakeEmbedder
+    // fallback) but never blocks the assistant — mirrors wakeup.sh.
+    const name = 'embedder model';
+    const models = await deps.ollamaModels();
+    if (models === null) {
+        return { name, ok: false, required: false, detail: 'Ollama unreachable (semantic recall will degrade)' };
+    }
+    if (!models.includes(deps.embedModel)) {
+        return { name, ok: false, required: false, detail: `model ${deps.embedModel} not pulled (run: ollama pull ${deps.embedModel})` };
+    }
+    return { name, ok: true, required: false, detail: `${deps.embedModel} present` };
+}
+async function checkMigrations(deps) {
+    const name = 'db migrations';
+    const state = await deps.migrationState();
+    switch (state) {
+        case 'ok':
+            return { name, ok: true, required: true, detail: 'memory DB migrated' };
+        case 'missing':
+            return { name, ok: false, required: true, detail: 'no memory DB found — run `fortytwo init` first' };
+        case 'pending':
+            return { name, ok: false, required: true, detail: 'memory DB present but not migrated' };
+        case 'unavailable':
+            return { name, ok: false, required: false, detail: 'memory package not installed — cannot check migrations' };
+    }
+}
+/**
+ * Run all checks, return per-check results + aggregate. Reused by `update` as
+ * the post-install verify step. Aggregate ok = every required check passed.
+ */
+export async function runDoctorChecks(deps) {
+    const results = await Promise.all([
+        checkGate(deps),
+        checkMemoryContract(deps),
+        checkCompat(deps),
+        checkEmbedder(deps),
+        checkMigrations(deps),
+    ]);
+    const ok = results.every((r) => r.ok || !r.required);
+    return { results, ok };
+}
+/** Wire the real engine siblings, Ollama, and memory DB into the checks. */
+export function defaultDoctorDeps() {
+    const ollamaBaseUrl = process.env.OLLAMA_BASE_URL ?? DEFAULT_OLLAMA_BASE_URL;
+    const dbPath = process.env.DB_PATH ?? DEFAULT_DB_PATH;
+    const embedModel = process.env.EMBED_MODEL ?? EMBED_MODEL;
+    return {
+        loadGate,
+        loadMemory,
+        installedVersion: readInstalledVersion,
+        compatRanges: readSelfCompatRanges(),
+        ollamaModels: () => fetchOllamaModels(ollamaBaseUrl),
+        embedModel,
+        migrationState: () => readMigrationState(dbPath),
+    };
+}
+export async function runDoctor(_argv) {
+    const { results, ok } = await runDoctorChecks(defaultDoctorDeps());
+    for (const r of results) {
+        const mark = r.ok ? 'ok  ' : r.required ? 'FAIL' : 'warn';
+        process.stdout.write(`[${mark}] ${r.name}: ${r.detail}\n`);
+    }
+    process.stdout.write(ok ? '\ndoctor: healthy\n' : '\ndoctor: required checks failed\n');
+    return ok ? 0 : 1;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/enrich.d.ts

@@ -0,0 +1,2 @@
+export declare function runEnrich(_argv: string[]): Promise<number>;
+//# sourceMappingURL=enrich.d.ts.map

package/dist/commands/enrich.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrich.d.ts","sourceRoot":"","sources":["../../src/commands/enrich.ts"],"names":[],"mappings":"AAaA,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAWhE"}

package/dist/commands/enrich.js

@@ -0,0 +1,26 @@
+// enrich — deepen the persona by capturing more answers over time.
+//
+// init captures the minimum to boot. enrich is the ongoing "tell the assistant
+// more about yourself / refine its persona" loop. It mutates the `enrichment`
+// block of .fortytwo/identity.json, then re-renders the persona.
+//
+// CRITICAL idempotence guarantee: re-rendering MUST NOT clobber fields the user
+// already captured or hand-edited. render.ts only overwrites MANAGED outputs and
+// write-once-protects CAPTURED ones, so enrich is safe to run repeatedly.
+import { readIdentity, writeIdentity } from '../state.js';
+import { renderPersona } from '../render.js';
+export async function runEnrich(_argv) {
+    // TODO(impl):
+    //   const identity = readIdentity()  // require init has run
+    //   prompt for (or take from flags) additional persona answers; MERGE into
+    //     identity.enrichment without dropping existing keys.
+    //   writeIdentity(identity)          // stamps updatedAt
+    //   renderPersona(identity)          // idempotent re-render; reports written/skipped
+    //   print which context files changed.
+    void readIdentity;
+    void writeIdentity;
+    void renderPersona;
+    void null;
+    throw new Error('TODO(impl): runEnrich — capture more answers, merge into identity.json, re-render persona');
+}
+//# sourceMappingURL=enrich.js.map

package/dist/commands/enrich.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrich.js","sourceRoot":"","sources":["../../src/commands/enrich.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,iEAAiE;AACjE,EAAE;AACF,gFAAgF;AAChF,iFAAiF;AACjF,0EAA0E;AAE1E,OAAO,EAAE,YAAY,EAAE,aAAa,EAAiB,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAe;IAC7C,cAAc;IACd,6DAA6D;IAC7D,2EAA2E;IAC3E,0DAA0D;IAC1D,yDAAyD;IACzD,sFAAsF;IACtF,uCAAuC;IACvC,KAAK,YAAY,CAAC;IAAC,KAAK,aAAa,CAAC;IAAC,KAAK,aAAa,CAAC;IAC1D,KAAM,IAA4B,CAAC;IACnC,MAAM,IAAI,KAAK,CAAC,2FAA2F,CAAC,CAAC;AAC/G,CAAC"}

package/dist/commands/forget.d.ts

@@ -0,0 +1,2 @@
+export declare function runForget(_argv: string[]): Promise<number>;
+//# sourceMappingURL=forget.d.ts.map

package/dist/commands/forget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forget.d.ts","sourceRoot":"","sources":["../../src/commands/forget.ts"],"names":[],"mappings":"AAOA,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAahE"}

package/dist/commands/forget.js

@@ -0,0 +1,19 @@
+// forget — redact/remove specific memories from the memory MCP store.
+//
+// The data-hygiene verb: the owner asks the assistant to forget something
+// (a person, a topic, a date range, a specific entry). This is a privileged
+// operation against the canonical memory store, distinct from the assistant's
+// own turn-time memory writes.
+export async function runForget(_argv) {
+    // BLOCKED: forget needs a deletion/redaction surface on @justfortytwo/memory
+    // (delete from the store AND the derived FTS + embedding indexes so recall
+    // can't resurface a removed entry). The memory package does not expose one
+    // yet, so this command cannot honor a forget request safely. When that API
+    // lands, wire selectors here: --id, --query (semantic match + confirm),
+    // --since/--until (range), --entity, with a confirmation summary + --yes.
+    process.stderr.write('forget: not yet available — it requires a deletion/redaction API in ' +
+        '@justfortytwo/memory (not implemented). Until then, no command can remove ' +
+        'stored memories; do not assume a forget succeeded.\n');
+    return 2;
+}
+//# sourceMappingURL=forget.js.map

package/dist/commands/forget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forget.js","sourceRoot":"","sources":["../../src/commands/forget.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,EAAE;AACF,0EAA0E;AAC1E,4EAA4E;AAC5E,8EAA8E;AAC9E,+BAA+B;AAE/B,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAe;IAC7C,6EAA6E;IAC7E,2EAA2E;IAC3E,2EAA2E;IAC3E,2EAA2E;IAC3E,wEAAwE;IACxE,0EAA0E;IAC1E,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,sEAAsE;QACtE,4EAA4E;QAC5E,sDAAsD,CACvD,CAAC;IACF,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,48 @@
+import type { Answers, VersionPin } from '../state.js';
+export declare const EMBED_MODEL = "qwen3-embedding:0.6b";
+export declare const DEFAULT_OLLAMA_BASE_URL = "http://localhost:11434";
+export declare const DEFAULT_DB_PATH = "db/fortytwo.db";
+export interface ManifestField {
+    key: string;
+    prompt: string;
+    type: 'string' | 'text' | 'list' | string;
+    required?: boolean;
+    default?: unknown;
+}
+export interface AnswerSources {
+    /** A pre-filled answers map (e.g. from `--answers <file.json>`). Highest precedence. */
+    answersFile?: Record<string, unknown>;
+    /** process.env (read as FORTYTWO_<UPPER_KEY>). */
+    env?: Record<string, string | undefined>;
+    /** CLI flags, keyed by manifest field key. */
+    flags?: Record<string, string>;
+}
+/**
+ * Resolve every manifest field from (in precedence order) the answers file, the
+ * environment (FORTYTWO_<KEY>), CLI flags, then the manifest default. List
+ * fields are coerced to arrays; null/absent values become '' or [] so the
+ * renderer (which fails loud on null) never sees a hole. Required fields left
+ * empty are reported back, not silently defaulted.
+ */
+export declare function resolveAnswers(fields: ManifestField[], sources: AnswerSources): {
+    answers: Answers;
+    missingRequired: string[];
+};
+/**
+ * Merge `vars` into existing `.env` content: update matching keys in place,
+ * append new ones, preserve comments and unrelated lines. Secrets NEVER go to
+ * identity.json — only here.
+ */
+export declare function mergeEnvContent(existing: string, vars: Record<string, string>): string;
+export interface McpConfig {
+    mcpServers: Record<string, unknown>;
+    [k: string]: unknown;
+}
+/** Add (or replace) the `fortytwo-memory` MCP server entry, preserving others. */
+export declare function buildMcpConfig(existing: McpConfig | null, opts: {
+    dbPath: string;
+}): McpConfig;
+/** Pin each declared sibling to its installed version; skip the absent. */
+export declare function buildVersionPins(compatRanges: Record<string, string>, readVersion: (spec: string) => string | null): VersionPin[];
+export declare function runInit(argv: string[]): Promise<number>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAY,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAMjE,eAAO,MAAM,WAAW,yBAAyB,CAAC;AAClD,eAAO,MAAM,uBAAuB,2BAA2B,CAAC;AAChE,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAiBD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EAAE,EACvB,OAAO,EAAE,aAAa,GACrB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,eAAe,EAAE,MAAM,EAAE,CAAA;CAAE,CAajD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAetF;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI,EAAE,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAS9F;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAC3C,UAAU,EAAE,CAOd;AA4GD,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAoE7D"}