@ryanstark24/sfgraph-cli 1.1.0

package/dist/commands/_mcp-config.js

@@ -0,0 +1,98 @@
+import { existsSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir, platform } from "node:os";
+import { dirname, join } from "node:path";
+/** MCP server invocation. On Windows, `npx` is `npx.cmd`; spawned tools that
+ *  receive `command: 'npx'` literally will ENOENT. We emit the platform-correct
+ *  binary so the same `sfgraph install` produces a working config on macOS,
+ *  Linux, and Windows.
+ *
+ *  When `localBinPath` is set (local-dev mode), invoke the local build via
+ *  `node <absPath> mcp` — no PATH dependency, no published npm package
+ *  required. */
+function sfgraphEntryFor(plat, localBinPath, pinNode, env) {
+    let entry;
+    if (localBinPath) {
+        entry = { command: pinNode ?? "node", args: [localBinPath, "mcp"] };
+    }
+    else if (plat === "win32") {
+        entry = { command: "npx.cmd", args: ["-y", "@ryanstark24/sfgraph"] };
+    }
+    else {
+        entry = { command: "npx", args: ["-y", "@ryanstark24/sfgraph"] };
+    }
+    if (env && Object.keys(env).length > 0)
+        entry.env = env;
+    return entry;
+}
+export function configPathFor(target, opts = {}) {
+    const home = opts.homeOverride ?? homedir();
+    const plat = opts.platformOverride ?? platform();
+    switch (target) {
+        case "claude": {
+            // Claude Desktop config path is per-platform.
+            if (plat === "darwin") {
+                return join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
+            }
+            if (plat === "win32") {
+                return join(home, "AppData", "Roaming", "Claude", "claude_desktop_config.json");
+            }
+            // linux fallback
+            return join(home, ".config", "Claude", "claude_desktop_config.json");
+        }
+        case "cursor":
+            // Cursor uses ~/.cursor on every platform.
+            return join(home, ".cursor", "mcp.json");
+        case "vscode":
+            // VS Code's User settings dir is per-platform.
+            if (plat === "darwin") {
+                return join(home, "Library", "Application Support", "Code", "User", "mcp.json");
+            }
+            if (plat === "win32") {
+                return join(home, "AppData", "Roaming", "Code", "User", "mcp.json");
+            }
+            return join(home, ".config", "Code", "User", "mcp.json");
+    }
+}
+export async function writeMcpConfig(target, opts = {}) {
+    const path = configPathFor(target, opts);
+    const plat = opts.platformOverride ?? platform();
+    const sfgraphEntry = sfgraphEntryFor(plat, opts.localBinPath, opts.pinNode, opts.env);
+    let existing = {};
+    if (existsSync(path)) {
+        try {
+            existing = JSON.parse(await readFile(path, "utf8"));
+        }
+        catch {
+            existing = {};
+        }
+    }
+    const merged = { ...existing };
+    const servers = { ...(merged.mcpServers ?? {}) };
+    const before = servers.sfgraph;
+    servers.sfgraph = sfgraphEntry;
+    merged.mcpServers = servers;
+    const nextJson = `${JSON.stringify(merged, null, 2)}\n`;
+    let action;
+    if (opts.dryRun) {
+        action = "would-write";
+    }
+    else if (existsSync(path)) {
+        const prev = await readFile(path, "utf8");
+        if (prev === nextJson && before && before.command === sfgraphEntry.command) {
+            action = "skipped";
+        }
+        else {
+            await mkdir(dirname(path), { recursive: true });
+            await writeFile(path, nextJson, "utf8");
+            action = "updated";
+        }
+    }
+    else {
+        await mkdir(dirname(path), { recursive: true });
+        await writeFile(path, nextJson, "utf8");
+        action = "created";
+    }
+    return { target, path, action };
+}
+//# sourceMappingURL=_mcp-config.js.map

package/dist/commands/_mcp-config.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,28 @@
+export interface DoctorOpts {
+    log?: (s: string) => void;
+    /** Override the data dir used for the on-disk checks (tests). */
+    dataDir?: string;
+    /** Override home for resolving IDE MCP config paths (tests). */
+    homeOverride?: string;
+    /** Stub the `sf --version` check (tests). */
+    sfProbe?: () => {
+        ok: boolean;
+        detail: string;
+    };
+    /** Stub the require used to load better-sqlite3 (tests). */
+    requireFn?: (id: string) => unknown;
+}
+export interface DoctorCheck {
+    name: string;
+    status: "ok" | "warn" | "fail";
+    detail: string;
+    /** Optional copy-paste fix command shown to the user. */
+    fix?: string;
+}
+export interface DoctorReport {
+    checks: DoctorCheck[];
+    ok: boolean;
+}
+export declare function runDoctorChecks(opts?: DoctorOpts): DoctorReport;
+export declare function doctorCmd(opts?: DoctorOpts): Promise<DoctorReport>;
+//# 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":"AAQA,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1B,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,4DAA4D;IAC5D,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,EAAE,EAAE,OAAO,CAAC;CACb;AA0UD,wBAAgB,eAAe,CAAC,IAAI,GAAE,UAAe,GAAG,YAAY,CAmBnE;AAQD,wBAAsB,SAAS,CAAC,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAa5E"}

package/dist/commands/doctor.js

@@ -0,0 +1,356 @@
+import { spawnSync } from "node:child_process";
+import { constants, accessSync, existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { isAbiMismatch } from "@ryanstark24/sfgraph-core";
+import { getSfgraphPaths } from "@ryanstark24/sfgraph-shared";
+import { configPathFor } from "./_mcp-config.js";
+function check(name, fn) {
+    try {
+        return { name, ...fn() };
+    }
+    catch (e) {
+        return {
+            name,
+            status: "fail",
+            detail: `unexpected error: ${e.message}`,
+        };
+    }
+}
+function checkNode() {
+    return {
+        status: "ok",
+        detail: `${process.version} (ABI ${process.versions.modules}); exec=${process.execPath}`,
+    };
+}
+/** Resolve better-sqlite3 from any package that depends on it (core/mcp-server),
+ *  not just the CLI's own node_modules. Packaged distribution sees it hoisted
+ *  alongside `@ryanstark24/sfgraph-server`, so resolve via that package's path. */
+function defaultRequire() {
+    // Resolve through a sibling package (@ryanstark24/sfgraph-server) that
+    // depends on better-sqlite3, so the doctor works whether or not the CLI's
+    // own node_modules has the binding hoisted into it.
+    const here = createRequire(import.meta.url);
+    try {
+        const serverEntry = here.resolve("@ryanstark24/sfgraph-server");
+        return createRequire(serverEntry);
+    }
+    catch {
+        return here;
+    }
+}
+function checkBetterSqlite3(requireFn) {
+    const req = requireFn ?? defaultRequire();
+    try {
+        req("better-sqlite3");
+        return { status: "ok", detail: "loads cleanly" };
+    }
+    catch (e) {
+        const msg = e.message;
+        if (isAbiMismatch(msg)) {
+            return {
+                status: "fail",
+                detail: `ABI mismatch — binding compiled for a different Node ABI (running ABI ${process.versions.modules})`,
+                fix: "npm rebuild better-sqlite3   # or: pnpm rebuild better-sqlite3",
+            };
+        }
+        return {
+            status: "fail",
+            detail: `failed to load: ${msg.split("\n")[0]}`,
+            fix: "npm install --force better-sqlite3",
+        };
+    }
+}
+/**
+ * macOS-only: verify the better-sqlite3 binding's code signature is one
+ * dyld will actually accept. The failure mode this catches is the
+ * "linker-signed adhoc" stamp that the build toolchain emits — macOS 26+
+ * rejects it with SIGKILL on dlopen, with no JS handler able to intercept.
+ * The kill is silent; ingests die mid-run with no error message. This
+ * check surfaces the issue *before* the next ingest hits it.
+ */
+function checkMacosCodesign(requireFn) {
+    if (process.platform !== "darwin")
+        return null;
+    const req = requireFn ?? defaultRequire();
+    // Resolve the actual .node file path.
+    let bindingPath = null;
+    try {
+        // The official entry point is index.js; the .node lives under build/Release.
+        const entry = req.resolve("better-sqlite3");
+        // entry ≈ <pkg>/lib/index.js — walk up to <pkg> then into build/Release.
+        const pkgRoot = path.resolve(path.dirname(entry), "..");
+        const candidate = path.join(pkgRoot, "build", "Release", "better_sqlite3.node");
+        if (existsSync(candidate))
+            bindingPath = candidate;
+    }
+    catch {
+        /* unresolvable; skip */
+    }
+    if (!bindingPath) {
+        return {
+            status: "warn",
+            detail: "couldn't locate better_sqlite3.node to verify code signature",
+        };
+    }
+    const r = spawnSync("codesign", ["--verify", "--strict", bindingPath], {
+        encoding: "utf8",
+    });
+    if (r.error) {
+        return {
+            status: "warn",
+            detail: `codesign tool unavailable: ${r.error.message}`,
+        };
+    }
+    if (r.status === 0) {
+        // Verified. Also check it's not the brittle linker-signed adhoc stamp.
+        const display = spawnSync("codesign", ["-dvv", bindingPath], { encoding: "utf8" });
+        const out = (display.stderr || display.stdout || "").toString();
+        if (/linker-signed/.test(out)) {
+            return {
+                status: "warn",
+                detail: "binding has linker-signed adhoc stamp; macOS 26+ may SIGKILL on dlopen. Re-sign with ad-hoc.",
+                fix: `codesign --force --sign - "${bindingPath}"`,
+            };
+        }
+        // Secondary check: AMFI library-validation rejection. If Node has
+        // Hardened Runtime + library validation enabled (the default for the
+        // Node.js Foundation builds + nvm), it refuses to load ad-hoc-signed
+        // bindings — even though `codesign --verify` says the binding itself
+        // is fine. The symptom is a silent SIGKILL mid-ingest. Detect by
+        // inspecting Node's own signing flags + entitlements (NOT the
+        // binding's — those are unrelated).
+        const nodeFlags = spawnSync("codesign", ["-dvv", process.execPath], { encoding: "utf8" });
+        const nodeFlagsOut = (nodeFlags.stderr || nodeFlags.stdout || "").toString();
+        const nodeEnts = spawnSync("codesign", ["-d", "--entitlements", "-", "--xml", process.execPath], { encoding: "utf8" });
+        const entsOut = (nodeEnts.stdout || nodeEnts.stderr || "").toString();
+        const hasLibValDisabled = /com\.apple\.security\.cs\.disable-library-validation/.test(entsOut);
+        // Node binary has Hardened Runtime if its codesign flags include
+        // `runtime` (the human-readable name) or 0x10000 (the bit). Foundation
+        // / nvm builds always do.
+        const isHardenedRuntime = /flags=0x[0-9a-f]*\(.*\bruntime\b/.test(nodeFlagsOut) ||
+            /flags=0x10000\b/.test(nodeFlagsOut) ||
+            /\bruntime\b/.test(nodeFlagsOut);
+        if (isHardenedRuntime && !hasLibValDisabled) {
+            const entitlementsPath = "/tmp/sfgraph-node-libval.plist";
+            const plistBody = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0"><dict>
+  <key>com.apple.security.cs.disable-library-validation</key><true/>
+  <key>com.apple.security.cs.allow-jit</key><true/>
+  <key>com.apple.security.cs.allow-unsigned-executable-memory</key><true/>
+</dict></plist>`;
+            return {
+                status: "warn",
+                detail: `Node has Hardened Runtime with library validation; AMFI will SIGKILL on ad-hoc-signed bindings mid-ingest (silent death, no error). Re-sign Node with disable-library-validation entitlement.`,
+                fix: `cat > ${entitlementsPath} <<'EOF'\n${plistBody}\nEOF\ncodesign --force --sign - --entitlements ${entitlementsPath} ${process.execPath}`,
+            };
+        }
+        return { status: "ok", detail: `code signature valid (${bindingPath})` };
+    }
+    return {
+        status: "fail",
+        detail: `codesign rejected binding: ${(r.stderr || r.stdout || "").trim().split("\n")[0]}`,
+        fix: `codesign --force --sign - "${bindingPath}"`,
+    };
+}
+function checkDataDir(dataDir) {
+    if (!existsSync(dataDir)) {
+        return {
+            status: "warn",
+            detail: `${dataDir} does not exist (will be created on first ingest)`,
+        };
+    }
+    try {
+        accessSync(dataDir, constants.W_OK);
+        return { status: "ok", detail: `${dataDir} (writable)` };
+    }
+    catch {
+        return {
+            status: "fail",
+            detail: `${dataDir} exists but is not writable`,
+            fix: `chmod u+w "${dataDir}"`,
+        };
+    }
+}
+function checkOrgDatabases(dataDir, requireFn) {
+    if (!existsSync(dataDir)) {
+        return { status: "warn", detail: "no data dir yet — run `sfgraph ingest --org <alias>`" };
+    }
+    let files = [];
+    try {
+        files = readdirSync(dataDir).filter((f) => f.endsWith(".sqlite") && !f.startsWith("backups"));
+    }
+    catch {
+        return { status: "warn", detail: "cannot read data dir" };
+    }
+    if (files.length === 0) {
+        return { status: "warn", detail: "no <orgId>.sqlite files yet" };
+    }
+    const req = requireFn ?? defaultRequire();
+    let Ctor;
+    try {
+        Ctor = req("better-sqlite3");
+    }
+    catch (e) {
+        return {
+            status: "fail",
+            detail: `cannot load better-sqlite3 to verify org DBs: ${e.message.split("\n")[0]}`,
+        };
+    }
+    const Ctor2 = Ctor;
+    const failures = [];
+    for (const f of files) {
+        const dbPath = path.join(dataDir, f);
+        try {
+            const db = new Ctor2(dbPath, { readonly: true, fileMustExist: true });
+            try {
+                // _sfgraph_schema_version is created by the migration runner on first init
+                db.prepare("SELECT version FROM _sfgraph_schema_version LIMIT 1").get();
+            }
+            finally {
+                db.close();
+            }
+        }
+        catch (e) {
+            // Surface the full multi-line error message — better-sqlite3 ABI
+            // mismatch errors put the salient detail on lines 2-4, and the
+            // single-line truncation made every failure look identical even
+            // when the root cause varied.
+            const fullMsg = e.message.replace(/\n/g, "\n        ");
+            failures.push(`${f}:\n        ${fullMsg}`);
+        }
+    }
+    if (failures.length > 0) {
+        return {
+            status: "fail",
+            detail: `${failures.length} of ${files.length} org DBs failed to open:\n      ${failures.join("\n      ")}`,
+            // The 'bindings file not found' / ABI mismatch failure mode is a
+            // native-binding issue (Node version doesn't match what better-sqlite3
+            // was built for), NOT a graph corruption issue. Re-ingest would just
+            // hit the same load failure. Point users at the binding rebuild
+            // instead; once that's green, `sfgraph doctor` reruns cleanly.
+            fix: "Rebuild the native binding for your Node runtime: sfgraph rebuild-bindings",
+        };
+    }
+    return { status: "ok", detail: `${files.length} org DB(s) open with expected schema` };
+}
+function checkSfCli(sfProbe) {
+    if (sfProbe) {
+        const r = sfProbe();
+        return r.ok
+            ? { status: "ok", detail: r.detail }
+            : { status: "warn", detail: r.detail, fix: "install: npm i -g @salesforce/cli" };
+    }
+    const r = spawnSync(process.platform === "win32" ? "sf.cmd" : "sf", ["--version"], {
+        encoding: "utf8",
+    });
+    if (r.error || r.status !== 0) {
+        return {
+            status: "warn",
+            detail: "`sf` CLI not found on PATH (only required for `sfgraph ingest`)",
+            fix: "npm i -g @salesforce/cli",
+        };
+    }
+    return { status: "ok", detail: (r.stdout || "").trim().split("\n")[0] ?? "found" };
+}
+function checkMcpConfigs(homeOverride) {
+    const targets = ["claude", "cursor", "vscode"];
+    const found = [];
+    const missing = [];
+    for (const t of targets) {
+        const opts = homeOverride ? { homeOverride } : {};
+        const p = configPathFor(t, opts);
+        if (existsSync(p))
+            found.push(`${t}: ${p}`);
+        else
+            missing.push(t);
+    }
+    if (found.length === 0) {
+        return {
+            status: "warn",
+            detail: "no IDE MCP configs detected",
+            fix: "sfgraph install --target cursor   # or claude / vscode / all",
+        };
+    }
+    const detail = found.join(", ") + (missing.length > 0 ? ` (not configured: ${missing.join(", ")})` : "");
+    return { status: "ok", detail };
+}
+function checkOrgSnapshot(dataDir) {
+    const p = path.join(dataDir, "orgs-snapshot.json");
+    if (!existsSync(p)) {
+        return {
+            status: "warn",
+            detail: "missing — list_orgs in a sandboxed MCP child will show empty aliases / no default-org",
+            fix: "Run `sfgraph refresh-orgs` (or `sfgraph install`) to capture sf state",
+        };
+    }
+    try {
+        const raw = JSON.parse(readFileSync(p, "utf8"));
+        const orgCount = Object.keys(raw.authorizations ?? {}).length;
+        if (orgCount === 0) {
+            return {
+                status: "warn",
+                detail: "snapshot has 0 orgs — sf was probably not authenticated when install ran",
+                fix: "Run `sf org login web --alias <X>` then `sfgraph refresh-orgs`",
+            };
+        }
+        const ageMs = Date.now() - (raw.recordedAt ?? statSync(p).mtimeMs);
+        const ageDays = Math.floor(ageMs / (1000 * 60 * 60 * 24));
+        if (ageDays >= 7) {
+            return {
+                status: "warn",
+                detail: `${orgCount} org${orgCount === 1 ? "" : "s"} snapshot, ${ageDays}d old`,
+                fix: "Run `sfgraph refresh-orgs` to capture any sf-CLI changes",
+            };
+        }
+        return {
+            status: "ok",
+            detail: `${orgCount} org${orgCount === 1 ? "" : "s"} snapshot, ${ageDays}d old`,
+        };
+    }
+    catch (e) {
+        return {
+            status: "fail",
+            detail: `unreadable: ${e.message}`,
+            fix: "Run `sfgraph refresh-orgs` to regenerate",
+        };
+    }
+}
+export function runDoctorChecks(opts = {}) {
+    const dataDir = opts.dataDir ?? getSfgraphPaths().data;
+    const checks = [
+        check("node runtime", checkNode),
+        check("better-sqlite3 native binding", () => checkBetterSqlite3(opts.requireFn)),
+    ];
+    if (process.platform === "darwin") {
+        const codesign = checkMacosCodesign(opts.requireFn);
+        if (codesign)
+            checks.push({ name: "macOS code-signing", ...codesign });
+    }
+    checks.push(check("sfgraph data dir", () => checkDataDir(dataDir)), check("org databases", () => checkOrgDatabases(dataDir, opts.requireFn)), check("org snapshot", () => checkOrgSnapshot(dataDir)), check("sf CLI", () => checkSfCli(opts.sfProbe)), check("IDE MCP configs", () => checkMcpConfigs(opts.homeOverride)));
+    const ok = checks.every((c) => c.status !== "fail");
+    return { checks, ok };
+}
+const ICON = {
+    ok: "✓",
+    warn: "⚠",
+    fail: "✗",
+};
+export async function doctorCmd(opts = {}) {
+    const log = opts.log ?? ((s) => console.log(s));
+    const report = runDoctorChecks(opts);
+    log("sfgraph doctor");
+    log("");
+    for (const c of report.checks) {
+        log(`  ${ICON[c.status]} ${c.name}: ${c.detail}`);
+        if (c.fix)
+            log(`      fix: ${c.fix}`);
+    }
+    log("");
+    log(report.ok ? "All checks passed." : "One or more checks failed — see fix hints above.");
+    if (!report.ok)
+        process.exitCode = 1;
+    return report;
+}
+//# 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/ingest.d.ts

@@ -0,0 +1,31 @@
+export interface IngestOpts {
+    org?: string | undefined;
+    orgs?: string | undefined;
+    all?: boolean | undefined;
+    parallel?: boolean | undefined;
+    mode?: "full" | "incremental" | "auto" | undefined;
+    db?: string | undefined;
+    embedModel?: string | undefined;
+    embedModelId?: string | undefined;
+    embedModelDim?: number | undefined;
+    rebuild?: boolean | undefined;
+    noBackup?: boolean | undefined;
+    detectDeletions?: boolean | undefined;
+    /** Comma-separated source labels to fetch (e.g. 'apex,generic:Profile').
+     *  Forces mode=full and merges into the existing graph without rebuild. */
+    only?: string | undefined;
+    /** Read the previously-persisted skip report and re-ingest only those
+     *  labels. Useful for rate-limit recovery and post-permission-grant
+     *  backfill. */
+    retrySkipped?: boolean | undefined;
+    /** Override Tooling-API pool maxConcurrent (default 5). */
+    toolingPool?: number | undefined;
+    /** Override Metadata-API pool maxConcurrent (default 5). Bumping this is
+     *  usually the highest-leverage knob for slow ingests because Profile /
+     *  PermissionSet / Layout fans go through here. */
+    metadataPool?: number | undefined;
+    /** Override Data (SObject/Bulk) pool maxConcurrent (default 10). */
+    dataPool?: number | undefined;
+}
+export declare function ingestCmd(opts: IngestOpts): Promise<void>;
+//# sourceMappingURL=ingest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../src/commands/ingest.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,GAAG,SAAS,CAAC;IACnD,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC;+EAC2E;IAC3E,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B;;oBAEgB;IAChB,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;uDAEmD;IACnD,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AA8LD,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA0G/D"}