@memberjunction/cli 5.41.0 → 5.43.0

package/dist/lib/claude-pack/PackMerger.js

@@ -0,0 +1,315 @@
+/**
+ * Per-file merge for the Claude Code pack.
+ *
+ * Implements the table in plans/claude-install-pack.md §6.4:
+ *
+ *   CLAUDE.md           — managed-block rewrite (preserves user content)
+ *   .claude/mj/**       — overwritten as a unit (incl. sweep of stale files)
+ *   .claude/settings.json — deep-merge per §10.2
+ *   .claude/commands/*  — seed-once; overwrite needs --force / --refresh-commands
+ *   .claude/skills/**   — same rule as commands
+ *
+ * The merger never destroys user content by default. `Force` and the
+ * `Refresh*` flags are explicit opt-ins.
+ */
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, unlinkSync, writeFileSync, } from 'node:fs';
+import path from 'node:path';
+import { parseManagedBlock, rewriteManagedBlock, wrapWithManagedBlock, ManagedBlockError, } from './ManagedBlockEditor.js';
+import { mergeSettings } from './SettingsMerger.js';
+import { emptyActionLog, recordOutcome, } from './PackTypes.js';
+// ---------------------------------------------------------------------------
+// Main entry point
+// ---------------------------------------------------------------------------
+export function mergePack(opts) {
+    const actions = emptyActionLog();
+    const warnings = [];
+    mergeRootClaudeMd(opts, actions, warnings);
+    mergeMjBundle(opts, actions, warnings);
+    if (!opts.SkipSettings)
+        mergeSettingsFile(opts, actions, warnings);
+    if (!opts.SkipCommands) {
+        mergeSeededTree(opts, actions, warnings, '.claude/commands/', !!opts.RefreshCommands);
+    }
+    if (!opts.SkipSkills) {
+        mergeSeededTree(opts, actions, warnings, '.claude/skills/', !!opts.RefreshSkills);
+    }
+    return { Actions: actions, Warnings: warnings };
+}
+// ---------------------------------------------------------------------------
+// CLAUDE.md — managed-block rewrite
+// ---------------------------------------------------------------------------
+function mergeRootClaudeMd(opts, actions, warnings) {
+    const packBytes = opts.PackFiles.get('CLAUDE.md');
+    if (!packBytes) {
+        recordOutcome(actions, { path: 'CLAUDE.md', outcome: 'error', reason: 'absent from pack' });
+        return;
+    }
+    const packText = decodeText(packBytes);
+    let packBlock;
+    try {
+        packBlock = parseManagedBlock(packText);
+    }
+    catch (err) {
+        recordOutcome(actions, {
+            path: 'CLAUDE.md',
+            outcome: 'error',
+            reason: `pack CLAUDE.md malformed: ${err.message}`,
+        });
+        return;
+    }
+    if (!packBlock) {
+        recordOutcome(actions, {
+            path: 'CLAUDE.md',
+            outcome: 'error',
+            reason: 'pack CLAUDE.md has no managed block',
+        });
+        return;
+    }
+    const targetPath = path.join(opts.TargetDir, 'CLAUDE.md');
+    if (!existsSync(targetPath)) {
+        writeFile(opts, targetPath, packText);
+        recordOutcome(actions, { path: 'CLAUDE.md', outcome: 'added' });
+        return;
+    }
+    const existing = readFileSync(targetPath, 'utf8');
+    let existingBlock;
+    try {
+        existingBlock = parseManagedBlock(existing);
+    }
+    catch (err) {
+        warnings.push(`CLAUDE.md has malformed MJ-MANAGED markers — leaving the file alone. ` +
+            `Fix it and re-run, or pass --force to wrap the existing content. (${err.message})`);
+        recordOutcome(actions, {
+            path: 'CLAUDE.md',
+            outcome: 'skipped',
+            reason: 'malformed managed markers',
+        });
+        return;
+    }
+    let newContent;
+    if (existingBlock === null) {
+        newContent = wrapWithManagedBlock(existing, packBlock.body, packBlock.attrs);
+    }
+    else {
+        newContent = rewriteManagedBlock(existing, packBlock.body, packBlock.attrs);
+    }
+    if (newContent === existing) {
+        recordOutcome(actions, { path: 'CLAUDE.md', outcome: 'skipped', reason: 'identical' });
+        return;
+    }
+    writeFile(opts, targetPath, newContent);
+    recordOutcome(actions, { path: 'CLAUDE.md', outcome: 'updated' });
+}
+// ---------------------------------------------------------------------------
+// .claude/mj/** — overwritten as a unit + sweep of stale files
+// ---------------------------------------------------------------------------
+function mergeMjBundle(opts, actions, _warnings) {
+    const mjPaths = collectPackPathsByPrefix(opts.PackFiles, '.claude/mj/');
+    const targetMjDir = path.join(opts.TargetDir, '.claude', 'mj');
+    // Sweep: delete any existing .claude/mj/ files that aren't in the new pack.
+    // The folder is "managed as a unit" — stale files from previous versions
+    // would otherwise linger.
+    if (existsSync(targetMjDir)) {
+        const expected = new Set(mjPaths);
+        for (const stale of walkRelativeFiles(targetMjDir, opts.TargetDir)) {
+            if (!stale.startsWith('.claude/mj/'))
+                continue;
+            if (!expected.has(stale)) {
+                const absPath = path.join(opts.TargetDir, stale);
+                if (!opts.DryRun)
+                    unlinkSync(absPath);
+                recordOutcome(actions, {
+                    path: stale,
+                    outcome: 'updated',
+                    reason: 'removed (no longer shipped)',
+                });
+            }
+        }
+    }
+    // Write or overwrite every file the pack ships under .claude/mj/.
+    for (const relPath of mjPaths) {
+        const bytes = opts.PackFiles.get(relPath);
+        const absPath = path.join(opts.TargetDir, relPath);
+        const existed = existsSync(absPath);
+        const identical = existed && bytesEqual(readFileBytes(absPath), bytes);
+        if (identical) {
+            recordOutcome(actions, { path: relPath, outcome: 'skipped', reason: 'identical' });
+            continue;
+        }
+        writeFile(opts, absPath, bytes);
+        recordOutcome(actions, { path: relPath, outcome: existed ? 'updated' : 'added' });
+    }
+}
+// ---------------------------------------------------------------------------
+// .claude/settings.json — deep-merge per §10.2
+// ---------------------------------------------------------------------------
+function mergeSettingsFile(opts, actions, warnings) {
+    const packBytes = opts.PackFiles.get('.claude/settings.json');
+    if (!packBytes) {
+        recordOutcome(actions, {
+            path: '.claude/settings.json',
+            outcome: 'error',
+            reason: 'absent from pack',
+        });
+        return;
+    }
+    let packJson;
+    try {
+        packJson = JSON.parse(decodeText(packBytes));
+    }
+    catch (err) {
+        recordOutcome(actions, {
+            path: '.claude/settings.json',
+            outcome: 'error',
+            reason: `pack settings.json invalid JSON: ${err.message}`,
+        });
+        return;
+    }
+    const targetPath = path.join(opts.TargetDir, '.claude', 'settings.json');
+    let existing = {};
+    const existed = existsSync(targetPath);
+    if (existed) {
+        try {
+            existing = JSON.parse(readFileSync(targetPath, 'utf8'));
+        }
+        catch (err) {
+            warnings.push(`Existing .claude/settings.json is malformed JSON; leaving it alone. (${err.message})`);
+            recordOutcome(actions, {
+                path: '.claude/settings.json',
+                outcome: 'skipped',
+                reason: 'malformed JSON',
+            });
+            return;
+        }
+    }
+    const { Result, Changed } = mergeSettings({ Existing: existing, Pack: packJson });
+    if (!Changed && existed) {
+        recordOutcome(actions, {
+            path: '.claude/settings.json',
+            outcome: 'skipped',
+            reason: 'identical',
+        });
+        return;
+    }
+    writeFile(opts, targetPath, JSON.stringify(Result, null, 2) + '\n');
+    recordOutcome(actions, {
+        path: '.claude/settings.json',
+        outcome: existed ? 'updated' : 'added',
+    });
+}
+// ---------------------------------------------------------------------------
+// .claude/commands/* and .claude/skills/** — seed-once with --force override
+// ---------------------------------------------------------------------------
+function mergeSeededTree(opts, actions, warnings, prefix, refresh) {
+    const paths = collectPackPathsByPrefix(opts.PackFiles, prefix);
+    for (const relPath of paths) {
+        const result = seedOneFile(opts, relPath, refresh, warnings);
+        recordOutcome(actions, result);
+    }
+}
+function seedOneFile(opts, relPath, refresh, warnings) {
+    const bytes = opts.PackFiles.get(relPath);
+    const absPath = path.join(opts.TargetDir, relPath);
+    if (!existsSync(absPath)) {
+        writeFile(opts, absPath, bytes);
+        return { path: relPath, outcome: 'added' };
+    }
+    const existing = readFileBytes(absPath);
+    if (bytesEqual(existing, bytes)) {
+        return { path: relPath, outcome: 'skipped', reason: 'identical' };
+    }
+    // Different — user has customized this file. Default behavior is to
+    // preserve theirs; --force or --refresh-commands/--refresh-skills
+    // overrides with a .bak backup.
+    if (opts.Force || refresh) {
+        if (!opts.DryRun) {
+            writeFileSync(absPath + '.bak', existing);
+        }
+        writeFile(opts, absPath, bytes);
+        return { path: relPath, outcome: 'updated', reason: 'overwritten (.bak saved)' };
+    }
+    warnings.push(`${relPath} differs from pack — kept user version. Pass --force to overwrite.`);
+    return { path: relPath, outcome: 'skipped', reason: 'user-modified' };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function decodeText(bytes) {
+    return new TextDecoder('utf-8').decode(bytes);
+}
+/**
+ * Read a file's raw bytes as a fresh `Uint8Array`. `readFileSync(path)` returns
+ * `Buffer`, which Node's strict @types/node 20+ won't always assign to
+ * `Uint8Array<ArrayBufferLike>` due to generic-param invariance — wrapping in
+ * `new Uint8Array(...)` produces a portable, type-clean value.
+ */
+function readFileBytes(absPath) {
+    return new Uint8Array(readFileSync(absPath));
+}
+function bytesEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return true;
+}
+function collectPackPathsByPrefix(files, prefix) {
+    return [...files.keys()].filter((p) => p.startsWith(prefix)).sort();
+}
+function writeFile(opts, absPath, body) {
+    assertWithinTarget(opts.TargetDir, absPath);
+    if (opts.DryRun)
+        return;
+    mkdirSync(path.dirname(absPath), { recursive: true });
+    if (typeof body === 'string') {
+        writeFileSync(absPath, body, 'utf8');
+    }
+    else {
+        writeFileSync(absPath, body);
+    }
+}
+/**
+ * Defense-in-depth against malicious pack manifests: every write must
+ * resolve to a path inside `targetDir`. A hostile `--from` pack whose
+ * manifest declares `relPath: "../../etc/whatever"` would otherwise
+ * escape the install directory.
+ */
+function assertWithinTarget(targetDir, absPath) {
+    const resolvedTarget = path.resolve(targetDir);
+    const resolvedAbs = path.resolve(absPath);
+    const targetWithSep = resolvedTarget.endsWith(path.sep) ? resolvedTarget : resolvedTarget + path.sep;
+    if (resolvedAbs !== resolvedTarget && !resolvedAbs.startsWith(targetWithSep)) {
+        throw new Error(`Pack manifest tried to write outside the target directory: ${absPath} (target: ${targetDir})`);
+    }
+}
+/**
+ * Walk a directory and return file paths relative to `relativeTo`, using
+ * POSIX separators (`/`) regardless of host OS — these are pack-relative
+ * paths the rest of the merger compares with.
+ */
+function walkRelativeFiles(dir, relativeTo) {
+    const out = [];
+    function recurse(current) {
+        for (const entry of readdirSync(current)) {
+            const abs = path.join(current, entry);
+            const stat = statSync(abs);
+            if (stat.isDirectory()) {
+                recurse(abs);
+            }
+            else {
+                const rel = path.relative(relativeTo, abs).split(path.sep).join('/');
+                out.push(rel);
+            }
+        }
+    }
+    if (existsSync(dir))
+        recurse(dir);
+    return out;
+}
+/** Re-export for tests that want to exercise the walker in isolation. */
+export const _internals = { walkRelativeFiles, bytesEqual, collectPackPathsByPrefix };
+// ManagedBlockError re-export — callers may catch it specifically.
+export { ManagedBlockError };
+//# sourceMappingURL=PackMerger.js.map

package/dist/lib/claude-pack/PackMerger.js.map

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

package/dist/lib/claude-pack/PackOutputFormatter.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Output formatters for `mj install:claude` and `mj update:claude`.
+ *
+ * Two shapes:
+ *   - `formatPretty(result)` — human-readable colored summary for terminals
+ *   - `formatJson(result)`   — machine-readable schema from plan §7.5
+ *
+ * Lives in `lib/claude-pack/` (not in the command files) because both commands
+ * use the same renderer.
+ */
+import type { InstallResult } from './PackTypes.js';
+/** Plain `--json` output. */
+export declare function formatJson(result: InstallResult): string;
+/**
+ * Multi-line colored summary for terminals. Sections:
+ *
+ *   ✓ Claude Code pack v5.1.0 installed (MJ v5.33.0)
+ *   added:   N
+ *     <list>
+ *   updated: N
+ *     <list>
+ *   skipped: N (truncated to first few)
+ *   warnings: N
+ *     <list>
+ *
+ * Failure mode: a red banner + the errors[] list.
+ */
+export declare function formatPretty(result: InstallResult): string;
+//# sourceMappingURL=PackOutputFormatter.d.ts.map

package/dist/lib/claude-pack/PackOutputFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PackOutputFormatter.d.ts","sourceRoot":"","sources":["../../../src/lib/claude-pack/PackOutputFormatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,6BAA6B;AAC7B,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAExD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CA6C1D"}

package/dist/lib/claude-pack/PackOutputFormatter.js

@@ -0,0 +1,82 @@
+/**
+ * Output formatters for `mj install:claude` and `mj update:claude`.
+ *
+ * Two shapes:
+ *   - `formatPretty(result)` — human-readable colored summary for terminals
+ *   - `formatJson(result)`   — machine-readable schema from plan §7.5
+ *
+ * Lives in `lib/claude-pack/` (not in the command files) because both commands
+ * use the same renderer.
+ */
+import chalk from 'chalk';
+/** Plain `--json` output. */
+export function formatJson(result) {
+    return JSON.stringify(result, null, 2);
+}
+/**
+ * Multi-line colored summary for terminals. Sections:
+ *
+ *   ✓ Claude Code pack v5.1.0 installed (MJ v5.33.0)
+ *   added:   N
+ *     <list>
+ *   updated: N
+ *     <list>
+ *   skipped: N (truncated to first few)
+ *   warnings: N
+ *     <list>
+ *
+ * Failure mode: a red banner + the errors[] list.
+ */
+export function formatPretty(result) {
+    const lines = [];
+    if (!result.ok) {
+        lines.push(chalk.red.bold('✗ Claude Code pack operation failed.'));
+        if (result.actions.errors.length > 0) {
+            lines.push(chalk.red('errors:'));
+            for (const err of result.actions.errors) {
+                lines.push(chalk.red(`  - ${err}`));
+            }
+        }
+        if (result.warnings.length > 0) {
+            lines.push(chalk.yellow('warnings:'));
+            for (const w of result.warnings) {
+                lines.push(chalk.yellow(`  - ${w}`));
+            }
+        }
+        return lines.join('\n');
+    }
+    const version = result.packVersion ? `v${result.packVersion}` : '(check only)';
+    const mjLabel = result.installedMJVersion
+        ? `for MJ v${result.installedMJVersion}`
+        : 'no local MJ detected';
+    lines.push(chalk.green.bold(`✓ Claude Code pack ${version} ${mjLabel}`));
+    appendBucket(lines, 'added', result.actions.added, chalk.green);
+    appendBucket(lines, 'updated', result.actions.updated, chalk.cyan);
+    appendBucket(lines, 'skipped', result.actions.skipped, chalk.dim, 5);
+    if (result.notes.length > 0) {
+        lines.push(chalk.cyan(`notes (${result.notes.length}):`));
+        for (const n of result.notes) {
+            lines.push(chalk.cyan(`  - ${n}`));
+        }
+    }
+    if (result.warnings.length > 0) {
+        lines.push(chalk.yellow(`warnings (${result.warnings.length}):`));
+        for (const w of result.warnings) {
+            lines.push(chalk.yellow(`  - ${w}`));
+        }
+    }
+    return lines.join('\n');
+}
+function appendBucket(lines, label, entries, color, maxList = Number.POSITIVE_INFINITY) {
+    if (entries.length === 0)
+        return;
+    lines.push(color(`${label} (${entries.length}):`));
+    const shown = entries.slice(0, maxList);
+    for (const e of shown) {
+        lines.push(color(`  - ${e}`));
+    }
+    if (entries.length > shown.length) {
+        lines.push(color(`  … ${entries.length - shown.length} more`));
+    }
+}
+//# sourceMappingURL=PackOutputFormatter.js.map

package/dist/lib/claude-pack/PackOutputFormatter.js.map

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

package/dist/lib/claude-pack/PackPaths.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Path helpers for the Claude Code pack install / update flow.
+ *
+ * Pure path math + a small `package.json`-reading helper for detecting the
+ * MJ major version a user's project is on. No network, no FS mutation.
+ *
+ * @see plans/claude-install-pack.md §3.2 (target layout), §6.4 (paths per rule)
+ */
+/**
+ * Every file/directory in a user's project that the pack writes to or
+ * reads from. Built from a single `targetDir` so callers don't have to
+ * `path.join` repeatedly.
+ */
+export interface TargetPaths {
+    /** The root directory we're installing into. */
+    Root: string;
+    /** `<Root>/CLAUDE.md` — root instructions file. */
+    ClaudeMd: string;
+    /** `<Root>/package.json` — used for MJ major detection. */
+    PackageJson: string;
+    /** `<Root>/.claude/` — the Claude Code config root. */
+    ClaudeDir: string;
+    /** `<Root>/.claude/settings.json` — settings file we merge into. */
+    SettingsJson: string;
+    /** `<Root>/.claude/mj/` — the fully-managed bundle directory. */
+    MjDir: string;
+    /** `<Root>/.claude/mj/VERSION` — pack version stamp. */
+    VersionFile: string;
+    /** `<Root>/.claude/mj/MANIFEST.json` — checksums of the installed pack. */
+    ManifestFile: string;
+    /** `<Root>/.claude/commands/` — curated commands directory. */
+    CommandsDir: string;
+    /** `<Root>/.claude/skills/` — curated skills directory. */
+    SkillsDir: string;
+}
+/** Compute every target path for a given install directory. */
+export declare function targetPathsFor(targetDir: string): TargetPaths;
+/**
+ * When `--from <path>` is used, the path may point at either:
+ * - the **MJ repo root** (we look for `templates/claude-pack/dist/v{N}/` underneath), or
+ * - an **already-unpacked dist directory** (we use it directly).
+ *
+ * Returns the resolved root of the pack contents, or null if neither shape works.
+ */
+export declare function resolveLocalPackRoot(fromPath: string, mjMajor: string): string | null;
+/**
+ * Strip the leading `^` / `~` / `>=` / etc. and extract the first numeric
+ * component. Returns `null` if the string isn't a recognizable semver.
+ *
+ * Accepts: `5.33.0`, `^5.33.0`, `~5.33.0`, `>=5.33.0`, `5`, `v5.33.0`.
+ * Rejects: empty, `next`, `latest`, `*`, anything without a leading digit
+ * after the strip.
+ */
+export declare function parseSemverMajor(version: string): string | null;
+/**
+ * Detect the MJ major version installed in the user's project. Reads
+ * `<dir>/package.json` and looks at any `@memberjunction/*` entry in
+ * `dependencies` or `devDependencies`. Falls back to scanning
+ * `<dir>/apps/*\/package.json` and `<dir>/packages/*\/package.json` for
+ * distribution-style workspace installs whose root has no direct @mj deps.
+ *
+ * Returns `null` if no MJ dependency is declared anywhere reachable (e.g.,
+ * a fresh `mj install` that hasn't run `npm install` yet, or a non-MJ project).
+ */
+export declare function detectMJMajor(targetDir: string): string | null;
+/**
+ * Detect the full MJ semver string (e.g. `5.33.0`) installed in the user's
+ * project. Same scan order as {@link detectMJMajor} — root, then workspace
+ * subdirs. Returns the bare semver with any `^`/`~`/`>=` prefix stripped,
+ * or `null` if nothing is reachable.
+ */
+export declare function detectMJVersionString(targetDir: string): string | null;
+/**
+ * Build the remote URL prefix for a given MJ major and git ref.
+ *
+ * `ref` defaults to `main`. Callers that want pinned-to-tag behavior should
+ * pass the tag explicitly (e.g. `v5.33.0`) — see plan §8.5.
+ */
+export declare function buildRemoteUrlPrefix(mjMajor: string, ref?: string): string;
+//# sourceMappingURL=PackPaths.d.ts.map

package/dist/lib/claude-pack/PackPaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PackPaths.d.ts","sourceRoot":"","sources":["../../../src/lib/claude-pack/PackPaths.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAgB7D;AAMD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkBrF;AAMD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO/D;AAkED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM9D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMtE;AASD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAe,GAAG,MAAM,CAElF"}