@memberjunction/cli 5.41.0 → 5.43.0

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

@@ -0,0 +1,182 @@
+/**
+ * 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)
+ */
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import path from 'node:path';
+/** Compute every target path for a given install directory. */
+export function targetPathsFor(targetDir) {
+    const root = path.resolve(targetDir);
+    const claudeDir = path.join(root, '.claude');
+    const mjDir = path.join(claudeDir, 'mj');
+    return {
+        Root: root,
+        ClaudeMd: path.join(root, 'CLAUDE.md'),
+        PackageJson: path.join(root, 'package.json'),
+        ClaudeDir: claudeDir,
+        SettingsJson: path.join(claudeDir, 'settings.json'),
+        MjDir: mjDir,
+        VersionFile: path.join(mjDir, 'VERSION'),
+        ManifestFile: path.join(mjDir, 'MANIFEST.json'),
+        CommandsDir: path.join(claudeDir, 'commands'),
+        SkillsDir: path.join(claudeDir, 'skills'),
+    };
+}
+// ---------------------------------------------------------------------------
+// Pack source paths (when loading from a local copy of the MJ repo)
+// ---------------------------------------------------------------------------
+/**
+ * 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 function resolveLocalPackRoot(fromPath, mjMajor) {
+    const abs = path.resolve(fromPath);
+    // Shape A: MJ repo root — look for templates/claude-pack/dist/v{N}/
+    const repoCandidate = path.join(abs, 'templates', 'claude-pack', 'dist', `v${mjMajor}`);
+    if (existsSync(path.join(repoCandidate, 'CLAUDE.md'))) {
+        return repoCandidate;
+    }
+    // Shape B: already-unpacked dist — must contain CLAUDE.md + .claude/mj/VERSION
+    if (existsSync(path.join(abs, 'CLAUDE.md')) &&
+        existsSync(path.join(abs, '.claude', 'mj', 'VERSION'))) {
+        return abs;
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// MJ major version detection
+// ---------------------------------------------------------------------------
+/**
+ * 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 function parseSemverMajor(version) {
+    const trimmed = version.trim();
+    if (!trimmed)
+        return null;
+    // Strip common range/prefix chars: ^ ~ >= <= = > < v
+    const stripped = trimmed.replace(/^(\^|~|>=|<=|>|<|=|v)+/, '');
+    const match = stripped.match(/^(\d+)(?:\.|$)/);
+    return match ? match[1] : null;
+}
+/**
+ * Workspace subdirectories that distribution-style `mj install` outputs
+ * place @memberjunction/* deps under (e.g. `apps/MJAPI`, `apps/MJExplorer`,
+ * and any custom `packages/*` packages). When the root `package.json` is
+ * a workspace shell with no direct @mj deps, we walk one level into each
+ * of these subdirs to find them.
+ */
+const WORKSPACE_SUBDIRS = ['apps', 'packages'];
+/**
+ * Collect every `@memberjunction/*` dep entry visible to a target install dir.
+ *
+ * Looks at:
+ *   1. `<dir>/package.json`
+ *   2. `<dir>/apps/*\/package.json`
+ *   3. `<dir>/packages/*\/package.json`
+ *
+ * The walk-the-workspaces fallback is needed for distribution-style installs
+ * (the output of `mj install`), where the root `package.json` is a workspace
+ * shell — `@memberjunction/*` deps live in `apps/MJAPI/package.json`,
+ * `apps/MJExplorer/package.json`, etc. Source-style monorepo checkouts and
+ * simple consumer projects all keep deps at the root, where step 1 finds them.
+ *
+ * Returned in iteration order (root first, then alphabetical subdir order)
+ * so the FIRST entry found drives single-answer functions like
+ * {@link detectMJMajor}. Returns an empty array when no MJ deps are visible
+ * anywhere reachable.
+ */
+function collectMJDeps(targetDir) {
+    const candidates = [path.join(targetDir, 'package.json')];
+    for (const subdir of WORKSPACE_SUBDIRS) {
+        const dir = path.join(targetDir, subdir);
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            continue;
+        }
+        entries.sort();
+        for (const entry of entries) {
+            candidates.push(path.join(dir, entry, 'package.json'));
+        }
+    }
+    const collected = [];
+    for (const pkgPath of candidates) {
+        if (!existsSync(pkgPath))
+            continue;
+        let pkg;
+        try {
+            pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+        }
+        catch {
+            continue;
+        }
+        const deps = { ...(pkg.dependencies ?? {}), ...(pkg.devDependencies ?? {}) };
+        for (const [name, version] of Object.entries(deps)) {
+            if (name.startsWith('@memberjunction/')) {
+                collected.push({ name, version });
+            }
+        }
+    }
+    return collected;
+}
+/**
+ * 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 function detectMJMajor(targetDir) {
+    for (const { version } of collectMJDeps(targetDir)) {
+        const major = parseSemverMajor(version);
+        if (major)
+            return major;
+    }
+    return 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 function detectMJVersionString(targetDir) {
+    for (const { version } of collectMJDeps(targetDir)) {
+        const stripped = version.replace(/^(\^|~|>=|<=|>|<|=|v)+/, '');
+        if (/^\d+\./.test(stripped))
+            return stripped;
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Remote URL construction
+// ---------------------------------------------------------------------------
+/** Default GitHub raw URL prefix for the pack's `dist/` tree. */
+const DEFAULT_RAW_BASE = 'https://raw.githubusercontent.com/MemberJunction/MJ';
+/**
+ * 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 function buildRemoteUrlPrefix(mjMajor, ref = 'main') {
+    return `${DEFAULT_RAW_BASE}/${ref}/templates/claude-pack/dist/v${mjMajor}/`;
+}
+//# sourceMappingURL=PackPaths.js.map

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

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

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

@@ -0,0 +1,124 @@
+/**
+ * Shared types for the Claude Code pack install / update flow.
+ *
+ * The build pipeline in `templates/claude-pack/build-pack.mjs` (Milestone 1)
+ * emits a `MANIFEST.json` that this package consumes — its shape is the
+ * authoritative contract between the two.
+ *
+ * @see plans/claude-install-pack.md §5.2 (manifest format), §6.4 (merge rules),
+ *      §7.4 (flags), §7.5 (JSON output)
+ */
+/** One file entry inside a pack's `MANIFEST.json`. */
+export interface ManifestEntry {
+    /** Pack-relative POSIX path, e.g. `.claude/mj/core.md`. */
+    path: string;
+    /** Byte length of the file as shipped. */
+    bytes: number;
+    /** Hex sha256 digest of the file bytes. */
+    sha256: string;
+}
+/** Top-level shape of `.claude/mj/MANIFEST.json`. */
+export interface Manifest {
+    /** Pack semver, e.g. `5.1.0`. */
+    packVersion: string;
+    /** MJ major version, e.g. `5`. */
+    mjMajor: string;
+    /**
+     * Public URL prefix used as the base for over-the-wire fetches.
+     * Example: `https://raw.githubusercontent.com/MemberJunction/MJ/main/templates/claude-pack/dist/v5/`
+     */
+    remoteUrlPrefix: string;
+    files: ManifestEntry[];
+}
+/**
+ * Outcome bucket for a single file/path during install or update.
+ *
+ * Mirrors the `actions` keys in the JSON output (§7.5).
+ */
+export type FileOutcome = 'added' | 'updated' | 'skipped' | 'error';
+/**
+ * Per-file result emitted by the merger. The `reason` is a human-readable
+ * explanation surfaced in `--verbose` output and warnings.
+ */
+export interface FileMergeResult {
+    path: string;
+    outcome: FileOutcome;
+    reason?: string;
+}
+/**
+ * Bucketed view of every file the operation touched. Drives both the
+ * human-readable summary and the `--json` output (§7.5).
+ */
+export interface ActionLog {
+    added: string[];
+    updated: string[];
+    skipped: string[];
+    errors: string[];
+}
+/**
+ * Full result object — the shape returned to callers and serialized for
+ * `--json`. Matches the schema in §7.5 of the plan.
+ *
+ * **`warnings` vs `notes`**: a `warning` flags a state the caller may want to
+ * act on (no local pack, customized file would be overwritten, etc.); a
+ * `note` is purely informational status (`Pack is up to date`,
+ * `Update available: v5.1 → v5.2`). Older versions of this type collapsed
+ * both into `warnings`, which made successful `--check` runs look like
+ * something was wrong. `notes` is always present (empty array if none),
+ * keeping `--json` consumers happy.
+ */
+export interface InstallResult {
+    ok: boolean;
+    packVersion: string;
+    /** MJ semver detected in the target dir (e.g. `5.33.0`), or `null` if undetectable. */
+    installedMJVersion: string | null;
+    actions: ActionLog;
+    warnings: string[];
+    notes: string[];
+}
+/** Empty action log helper — exported to avoid `{} as ActionLog` casts. */
+export declare function emptyActionLog(): ActionLog;
+/** Apply a single file's outcome to the rolling action log. */
+export declare function recordOutcome(log: ActionLog, result: FileMergeResult): void;
+/**
+ * A pack can be sourced from the network (raw.githubusercontent.com),
+ * from a local path on disk (for `--from <path>` or `--offline`), or from
+ * an already-installed copy (the user's existing `.claude/mj/`).
+ */
+export type PackSource = {
+    kind: 'remote';
+    baseUrl: string;
+    ref: string;
+} | {
+    kind: 'local';
+    rootDir: string;
+};
+/**
+ * The `__mj_managed` block embedded inside a user's `.claude/settings.json`.
+ * `keys` lists the dotted paths the MJ pack owns; the merger uses this to
+ * know what it's allowed to rewrite vs what belongs to the user.
+ *
+ * @see plans/claude-install-pack.md §10.2
+ */
+export interface ManagedSettingsMeta {
+    /** Pack semver that last wrote this block. */
+    version: string;
+    /** MJ major the pack was built for. */
+    mjMajor?: string;
+    /** Dotted paths in `settings.json` that MJ manages. */
+    keys: string[];
+}
+/**
+ * Parsed shape of the `<!-- MJ-MANAGED:CLAUDE-PACK START … -->`…`<!-- MJ-MANAGED:CLAUDE-PACK END -->`
+ * block in a user's root `CLAUDE.md`. `before` and `after` together with the
+ * rewritten block reconstitute the full file.
+ */
+export interface ManagedBlock {
+    before: string;
+    /** The contents between START and END markers (exclusive of marker lines). */
+    body: string;
+    after: string;
+    /** Attributes parsed off the START marker, e.g. `version=5.1.0` and `mj-major=5`. */
+    attrs: Record<string, string>;
+}
+//# sourceMappingURL=PackTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PackTypes.d.ts","sourceRoot":"","sources":["../../../src/lib/claude-pack/PackTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qDAAqD;AACrD,MAAM,WAAW,QAAQ;IACvB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAMD;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,uFAAuF;IACvF,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,IAAI,SAAS,CAE1C;AAeD,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAG3E;AAMD;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAMvC;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAMD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B"}

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

@@ -0,0 +1,32 @@
+/**
+ * Shared types for the Claude Code pack install / update flow.
+ *
+ * The build pipeline in `templates/claude-pack/build-pack.mjs` (Milestone 1)
+ * emits a `MANIFEST.json` that this package consumes — its shape is the
+ * authoritative contract between the two.
+ *
+ * @see plans/claude-install-pack.md §5.2 (manifest format), §6.4 (merge rules),
+ *      §7.4 (flags), §7.5 (JSON output)
+ */
+/** Empty action log helper — exported to avoid `{} as ActionLog` casts. */
+export function emptyActionLog() {
+    return { added: [], updated: [], skipped: [], errors: [] };
+}
+/**
+ * Maps the per-file outcome to its bucket in `ActionLog`. The singular form
+ * (`'error'`) maps to the plural bucket name (`errors`) — kept this way
+ * because the JSON contract in §7.5 specifies `errors` (a list) while the
+ * outcome enum reads more naturally in singular form per record.
+ */
+const OUTCOME_TO_BUCKET = {
+    added: 'added',
+    updated: 'updated',
+    skipped: 'skipped',
+    error: 'errors',
+};
+/** Apply a single file's outcome to the rolling action log. */
+export function recordOutcome(log, result) {
+    const bucket = OUTCOME_TO_BUCKET[result.outcome];
+    log[bucket].push(result.reason ? `${result.path} (${result.reason})` : result.path);
+}
+//# sourceMappingURL=PackTypes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PackTypes.js","sourceRoot":"","sources":["../../../src/lib/claude-pack/PackTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAwFH,2EAA2E;AAC3E,MAAM,UAAU,cAAc;IAC5B,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAC7D,CAAC;AAED;;;;;GAKG;AACH,MAAM,iBAAiB,GAAyC;IAC9D,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,QAAQ;CAChB,CAAC;AAEF,+DAA+D;AAC/D,MAAM,UAAU,aAAa,CAAC,GAAc,EAAE,MAAuB;IACnE,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjD,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACtF,CAAC"}

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

@@ -0,0 +1,47 @@
+/**
+ * Deep-merge for `.claude/settings.json`.
+ *
+ * The pack ships a baseline `settings.json` with a top-level
+ * `__mj_managed: { version, mjMajor?, keys: ["permissions.allow", "env.MJ_CLAUDE_PACK", ...] }`
+ * block. `keys` lists the dotted JSON paths the pack owns.
+ *
+ * The merger:
+ *   1. Deep-clones the user's existing settings as the starting point
+ *   2. For each path in `__mj_managed.keys`, merges the pack's value into the
+ *      user's:
+ *        - Arrays  → union, deduped, user entries first then pack entries
+ *        - Objects → recursive merge (per-key)
+ *        - Primitives → pack wins (rare in practice — primitives shouldn't
+ *          really be managed keys, but the rule keeps the merger total)
+ *   3. Replaces `__mj_managed` wholesale with the pack's block (so version
+ *      and mjMajor stamps update on every merge)
+ *   4. Leaves every user key outside `__mj_managed.keys` completely alone
+ *
+ * @see plans/claude-install-pack.md §10.2
+ */
+import type { ManagedSettingsMeta } from './PackTypes.js';
+export declare class SettingsMergeError extends Error {
+    constructor(message: string);
+}
+export interface MergeSettingsOptions {
+    /** User's existing settings.json contents. Use `{}` when the file is absent. */
+    Existing: Record<string, unknown>;
+    /** The pack baseline (rendered from settings.template.json). Must contain `__mj_managed.keys`. */
+    Pack: Record<string, unknown>;
+}
+export interface MergeSettingsResult {
+    /** The merged settings JSON, ready to write back. */
+    Result: Record<string, unknown>;
+    /**
+     * True if the merged result differs from `Existing`. Lets the caller
+     * skip an FS write when nothing changed.
+     */
+    Changed: boolean;
+}
+export declare function mergeSettings(opts: MergeSettingsOptions): MergeSettingsResult;
+/** Read the `__mj_managed` block out of a settings object, or null if absent. */
+export declare function readManagedMeta(settings: Record<string, unknown>): ManagedSettingsMeta | null;
+export declare function getAtPath(obj: Record<string, unknown>, dottedPath: string): unknown;
+export declare function setAtPath(obj: Record<string, unknown>, dottedPath: string, value: unknown): void;
+export declare function isPlainObject(v: unknown): v is Record<string, unknown>;
+//# sourceMappingURL=SettingsMerger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsMerger.d.ts","sourceRoot":"","sources":["../../../src/lib/claude-pack/SettingsMerger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAM1D,qBAAa,kBAAmB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI9B;AAMD,MAAM,WAAW,oBAAoB;IACjC,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,kGAAkG;IAClG,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAChC,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,mBAAmB,CAuB7E;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,mBAAmB,GAAG,IAAI,CAY7F;AA8CD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAQnF;AAED,wBAAgB,SAAS,CACrB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,OAAO,GACf,IAAI,CAaN;AAMD,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEtE"}

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

@@ -0,0 +1,163 @@
+/**
+ * Deep-merge for `.claude/settings.json`.
+ *
+ * The pack ships a baseline `settings.json` with a top-level
+ * `__mj_managed: { version, mjMajor?, keys: ["permissions.allow", "env.MJ_CLAUDE_PACK", ...] }`
+ * block. `keys` lists the dotted JSON paths the pack owns.
+ *
+ * The merger:
+ *   1. Deep-clones the user's existing settings as the starting point
+ *   2. For each path in `__mj_managed.keys`, merges the pack's value into the
+ *      user's:
+ *        - Arrays  → union, deduped, user entries first then pack entries
+ *        - Objects → recursive merge (per-key)
+ *        - Primitives → pack wins (rare in practice — primitives shouldn't
+ *          really be managed keys, but the rule keeps the merger total)
+ *   3. Replaces `__mj_managed` wholesale with the pack's block (so version
+ *      and mjMajor stamps update on every merge)
+ *   4. Leaves every user key outside `__mj_managed.keys` completely alone
+ *
+ * @see plans/claude-install-pack.md §10.2
+ */
+// ---------------------------------------------------------------------------
+// Errors
+// ---------------------------------------------------------------------------
+export class SettingsMergeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SettingsMergeError';
+    }
+}
+export function mergeSettings(opts) {
+    const packMeta = readManagedMeta(opts.Pack);
+    if (!packMeta) {
+        throw new SettingsMergeError('Pack settings.json has no __mj_managed.keys block — cannot determine what to merge.');
+    }
+    const result = deepClone(opts.Existing);
+    for (const dottedPath of packMeta.keys) {
+        const packValue = getAtPath(opts.Pack, dottedPath);
+        if (packValue === undefined)
+            continue; // pack declares the key but didn't ship a value — skip
+        const existingValue = getAtPath(result, dottedPath);
+        const merged = mergeValues(existingValue, packValue);
+        setAtPath(result, dottedPath, merged);
+    }
+    // Replace __mj_managed wholesale so version + mjMajor stamps refresh.
+    // Casting through unknown is required because the index signature is `unknown`.
+    result.__mj_managed = deepClone(opts.Pack.__mj_managed);
+    const changed = !shallowJsonEqual(result, opts.Existing);
+    return { Result: result, Changed: changed };
+}
+/** Read the `__mj_managed` block out of a settings object, or null if absent. */
+export function readManagedMeta(settings) {
+    const raw = settings.__mj_managed;
+    if (!isPlainObject(raw))
+        return null;
+    const obj = raw;
+    if (typeof obj.version !== 'string')
+        return null;
+    if (!Array.isArray(obj.keys))
+        return null;
+    if (!obj.keys.every((k) => typeof k === 'string'))
+        return null;
+    return {
+        version: obj.version,
+        mjMajor: typeof obj.mjMajor === 'string' ? obj.mjMajor : undefined,
+        keys: obj.keys,
+    };
+}
+// ---------------------------------------------------------------------------
+// Merge primitives
+// ---------------------------------------------------------------------------
+function mergeValues(existing, pack) {
+    if (Array.isArray(pack) && Array.isArray(existing)) {
+        return mergeArrays(existing, pack);
+    }
+    if (isPlainObject(pack) && isPlainObject(existing)) {
+        return mergeObjects(existing, pack);
+    }
+    // Type mismatch or primitive — pack wins.
+    return deepClone(pack);
+}
+/** Union user entries first, then pack entries; deduped by stable JSON encoding. */
+function mergeArrays(existing, pack) {
+    const seen = new Set();
+    const out = [];
+    for (const item of [...existing, ...pack]) {
+        const key = stableKey(item);
+        if (!seen.has(key)) {
+            seen.add(key);
+            out.push(deepClone(item));
+        }
+    }
+    return out;
+}
+function mergeObjects(existing, pack) {
+    const out = deepClone(existing);
+    for (const [key, value] of Object.entries(pack)) {
+        out[key] = mergeValues(out[key], value);
+    }
+    return out;
+}
+// ---------------------------------------------------------------------------
+// Path helpers
+// ---------------------------------------------------------------------------
+export function getAtPath(obj, dottedPath) {
+    const parts = dottedPath.split('.');
+    let cur = obj;
+    for (const p of parts) {
+        if (!isPlainObject(cur))
+            return undefined;
+        cur = cur[p];
+    }
+    return cur;
+}
+export function setAtPath(obj, dottedPath, value) {
+    const parts = dottedPath.split('.');
+    const last = parts.pop();
+    if (last === undefined)
+        return;
+    let cur = obj;
+    for (const p of parts) {
+        const next = cur[p];
+        if (!isPlainObject(next)) {
+            cur[p] = {};
+        }
+        cur = cur[p];
+    }
+    cur[last] = value;
+}
+// ---------------------------------------------------------------------------
+// Misc utilities
+// ---------------------------------------------------------------------------
+export function isPlainObject(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+function deepClone(value) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    if (Array.isArray(value))
+        return value.map((v) => deepClone(v));
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+        out[k] = deepClone(v);
+    }
+    return out;
+}
+/**
+ * Stable string key for an arbitrary JSON-ish value, used to dedupe array
+ * entries. Sorts object keys so `{a:1,b:2}` and `{b:2,a:1}` produce the same
+ * key.
+ */
+function stableKey(value) {
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return '[' + value.map(stableKey).join(',') + ']';
+    const entries = Object.entries(value).sort(([a], [b]) => a.localeCompare(b));
+    return '{' + entries.map(([k, v]) => JSON.stringify(k) + ':' + stableKey(v)).join(',') + '}';
+}
+function shallowJsonEqual(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+//# sourceMappingURL=SettingsMerger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsMerger.js","sourceRoot":"","sources":["../../../src/lib/claude-pack/SettingsMerger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACzC,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACrC,CAAC;CACJ;AAuBD,MAAM,UAAU,aAAa,CAAC,IAA0B;IACpD,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,MAAM,IAAI,kBAAkB,CACxB,qFAAqF,CACxF,CAAC;IACN,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,KAAK,MAAM,UAAU,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACnD,IAAI,SAAS,KAAK,SAAS;YAAE,SAAS,CAAC,uDAAuD;QAC9F,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,WAAW,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QACrD,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,sEAAsE;IACtE,gFAAgF;IAChF,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAA4B,CAAC;IAEnF,MAAM,OAAO,GAAG,CAAC,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAChD,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,eAAe,CAAC,QAAiC;IAC7D,MAAM,GAAG,GAAG,QAAQ,CAAC,YAAY,CAAC;IAClC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,GAAG,GAAG,GAA8B,CAAC;IAC3C,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/D,OAAO;QACH,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,OAAO,EAAE,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QAClE,IAAI,EAAE,GAAG,CAAC,IAAgB;KAC7B,CAAC;AACN,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,SAAS,WAAW,CAAC,QAAiB,EAAE,IAAa;IACjD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjD,OAAO,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjD,OAAO,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,0CAA0C;IAC1C,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,oFAAoF;AACpF,SAAS,WAAW,CAAC,QAAmB,EAAE,IAAe;IACrD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAc,EAAE,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9B,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CACjB,QAAiC,EACjC,IAA6B;IAE7B,MAAM,GAAG,GAA4B,SAAS,CAAC,QAAQ,CAAC,CAAC;IACzD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,GAAG,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,MAAM,UAAU,SAAS,CAAC,GAA4B,EAAE,UAAkB;IACtE,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,GAAG,GAAY,GAAG,CAAC;IACvB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QAC1C,GAAG,GAAI,GAA+B,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,MAAM,UAAU,SAAS,CACrB,GAA4B,EAC5B,UAAkB,EAClB,KAAc;IAEd,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO;IAC/B,IAAI,GAAG,GAA4B,GAAG,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;QACD,GAAG,GAAG,GAAG,CAAC,CAAC,CAA4B,CAAC;IAC5C,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;AACtB,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,MAAM,UAAU,aAAa,CAAC,CAAU;IACpC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,SAAS,CAAI,KAAQ;IAC1B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAiB,CAAC;IAChF,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;QACpE,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,GAAmB,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,SAAS,SAAS,CAAC,KAAc;IAC7B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9E,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAC5E,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/E,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CACrB,CAAC;IACF,OAAO,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;AACjG,CAAC;AAED,SAAS,gBAAgB,CAAC,CAAU,EAAE,CAAU;IAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/lib/cli-plugins.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Loads all CLI plugins so their `@RegisterClass(BaseCLIPlugin, …)` decorators
+ * populate the ClassFactory — the basis for the `mj usage` / `mj <domain> usage`
+ * progressive-disclosure surface (plan §5).
+ *
+ * The metadata-sync and codegen-lib plugin entry points ship WITH the CLI, so
+ * they're loaded unconditionally as built-ins (available even when no
+ * `mj-cli-plugins.json` is present). Any third-party plugins listed in that file
+ * are then loaded on top.
+ *
+ * These plugin modules are intentionally light — they static-import only
+ * cli-core + oclif + global and dynamic-import their heavy engines at execution
+ * time — so loading them here for usage composition is cheap.
+ */
+export declare function loadAllCliPlugins(searchFrom?: string): Promise<void>;
+//# sourceMappingURL=cli-plugins.d.ts.map

package/dist/lib/cli-plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-plugins.d.ts","sourceRoot":"","sources":["../../src/lib/cli-plugins.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CASzF"}

package/dist/lib/cli-plugins.js

@@ -0,0 +1,26 @@
+import { CLIPluginRegistry } from '@memberjunction/cli-core';
+/**
+ * Loads all CLI plugins so their `@RegisterClass(BaseCLIPlugin, …)` decorators
+ * populate the ClassFactory — the basis for the `mj usage` / `mj <domain> usage`
+ * progressive-disclosure surface (plan §5).
+ *
+ * The metadata-sync and codegen-lib plugin entry points ship WITH the CLI, so
+ * they're loaded unconditionally as built-ins (available even when no
+ * `mj-cli-plugins.json` is present). Any third-party plugins listed in that file
+ * are then loaded on top.
+ *
+ * These plugin modules are intentionally light — they static-import only
+ * cli-core + oclif + global and dynamic-import their heavy engines at execution
+ * time — so loading them here for usage composition is cheap.
+ */
+export async function loadAllCliPlugins(searchFrom = process.cwd()) {
+    await import('@memberjunction/metadata-sync/plugins');
+    await import('@memberjunction/codegen-lib/plugins');
+    const { failed } = await CLIPluginRegistry.LoadPluginsFromConfig(searchFrom);
+    // Surface (don't swallow) any third-party plugin that failed to load. stderr
+    // keeps stdout clean for `--format=json` consumers.
+    for (const f of failed) {
+        process.stderr.write(`Warning: could not load CLI plugin "${f.specifier}": ${f.error}\n`);
+    }
+}
+//# sourceMappingURL=cli-plugins.js.map

package/dist/lib/cli-plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-plugins.js","sourceRoot":"","sources":["../../src/lib/cli-plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,aAAqB,OAAO,CAAC,GAAG,EAAE;IACxE,MAAM,MAAM,CAAC,uCAAuC,CAAC,CAAC;IACtD,MAAM,MAAM,CAAC,qCAAqC,CAAC,CAAC;IACpD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,iBAAiB,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAC7E,6EAA6E;IAC7E,oDAAoD;IACpD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAC5F,CAAC;AACH,CAAC"}

package/dist/lib/domain-usage-command.d.ts

@@ -0,0 +1,16 @@
+import { Command } from '@oclif/core';
+/**
+ * Shared base for tier-2 usage commands (`mj <domain> usage`). Concrete
+ * subclasses under `commands/<domain>/usage.ts` set {@link Domain}. Returns every
+ * command in that domain — summary, flags, examples, runtime — composed from the
+ * registered plugins' `static Usage` (plan §5).
+ */
+export declare abstract class DomainUsageCommand extends Command {
+    static flags: {
+        format: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+    };
+    /** The domain this command documents (e.g. 'sync', 'codegen'). */
+    protected abstract Domain: string;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=domain-usage-command.d.ts.map

package/dist/lib/domain-usage-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-usage-command.d.ts","sourceRoot":"","sources":["../../src/lib/domain-usage-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAK7C;;;;;GAKG;AACH,8BAAsB,kBAAmB,SAAQ,OAAO;IACtD,MAAM,CAAC,KAAK;;MAEV;IAEF,kEAAkE;IAClE,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAE5B,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAO3B"}