@memberjunction/cli 5.41.0 → 5.43.0

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

@@ -0,0 +1,163 @@
+/**
+ * Fetches a Claude Code pack from `raw.githubusercontent.com`, verifies sha256
+ * against the manifest, and handles the tag→main ref-fallback per plan §8.5.
+ *
+ * Design notes:
+ *  - HTTP transport is injected via `HttpGetter` so tests can plug in a mock
+ *    without `vi.mock('node:https')`. Production uses `realHttpGet` (a thin
+ *    wrapper over `node:https`).
+ *  - No tokens, no auth headers — `raw.githubusercontent.com` is public
+ *    (plan §7.7). The fetcher never includes credentials.
+ *  - No caching here. The orchestrator decides whether to re-fetch.
+ *
+ * @see plans/claude-install-pack.md §5.2 (manifest), §6.3, §8.5 (ref fallback)
+ */
+import { createHash } from 'node:crypto';
+import https from 'node:https';
+import { buildRemoteUrlPrefix } from './PackPaths.js';
+/**
+ * Real production fetcher using `node:https`.
+ *
+ * Implementation note: builds the response body via manual Uint8Array
+ * concatenation instead of `Buffer.concat()` — the latter's return type
+ * (`Buffer`) doesn't cleanly assign to `Uint8Array` in the strict @types/node
+ * generics that ship with v20+, even though Buffer extends Uint8Array.
+ */
+export const realHttpGet = (url) => new Promise((resolve, reject) => {
+    const req = https.get(url, (res) => {
+        const chunks = [];
+        res.on('data', (chunk) => chunks.push(chunk));
+        res.on('end', () => {
+            resolve({ statusCode: res.statusCode ?? 0, body: concatBytes(chunks) });
+        });
+        res.on('error', reject);
+    });
+    req.on('error', reject);
+    req.setTimeout(30_000, () => {
+        req.destroy(new Error(`Timed out after 30s fetching ${url}`));
+    });
+});
+function concatBytes(chunks) {
+    const total = chunks.reduce((s, c) => s + c.byteLength, 0);
+    const out = new Uint8Array(total);
+    let offset = 0;
+    for (const c of chunks) {
+        out.set(c, offset);
+        offset += c.byteLength;
+    }
+    return out;
+}
+// ---------------------------------------------------------------------------
+// Errors
+// ---------------------------------------------------------------------------
+export class PackFetchError extends Error {
+    constructor(message, url, statusCode) {
+        super(message);
+        this.url = url;
+        this.statusCode = statusCode;
+        this.name = 'PackFetchError';
+    }
+}
+export class PackChecksumError extends Error {
+    constructor(message, path, expected, actual) {
+        super(message);
+        this.path = path;
+        this.expected = expected;
+        this.actual = actual;
+        this.name = 'PackChecksumError';
+    }
+}
+// ---------------------------------------------------------------------------
+// Main entry point
+// ---------------------------------------------------------------------------
+/**
+ * Fetch a pack: manifest first, then every file listed in it, verifying
+ * sha256 along the way. Falls back from a specific tag to `main` if the
+ * manifest 404s.
+ */
+export async function fetchPack(opts) {
+    const httpGet = opts.HttpGet ?? realHttpGet;
+    const requestedRef = opts.Ref ?? 'main';
+    const onProgress = opts.OnProgress ?? (() => { });
+    const { manifest, refUsed, baseUrl } = await fetchManifestWithFallback(opts.Major, requestedRef, httpGet, onProgress);
+    const files = new Map();
+    if (opts.ManifestOnly) {
+        return { Manifest: manifest, Files: files, RefUsed: refUsed, BaseUrl: baseUrl };
+    }
+    for (const entry of manifest.files) {
+        const url = baseUrl + entry.path;
+        onProgress(`fetching ${entry.path}`);
+        const res = await httpGet(url);
+        if (res.statusCode !== 200) {
+            throw new PackFetchError(`Failed to fetch ${entry.path}: HTTP ${res.statusCode}`, url, res.statusCode);
+        }
+        verifyChecksum(entry, res.body);
+        files.set(entry.path, res.body);
+    }
+    return { Manifest: manifest, Files: files, RefUsed: refUsed, BaseUrl: baseUrl };
+}
+// ---------------------------------------------------------------------------
+// Internals
+// ---------------------------------------------------------------------------
+async function fetchManifestWithFallback(major, requestedRef, httpGet, onProgress) {
+    const tryRef = async (ref) => {
+        const baseUrl = buildRemoteUrlPrefix(major, ref);
+        const manifestUrl = baseUrl + '.claude/mj/MANIFEST.json';
+        onProgress(`fetching manifest from ref=${ref}`);
+        const res = await httpGet(manifestUrl);
+        return { res, baseUrl, manifestUrl };
+    };
+    // First attempt: requested ref
+    const first = await tryRef(requestedRef);
+    if (first.res.statusCode === 200) {
+        return {
+            manifest: parseManifest(first.res.body, first.manifestUrl),
+            refUsed: requestedRef,
+            baseUrl: first.baseUrl,
+        };
+    }
+    // Fallback: try `main` if we weren't already on it AND the failure was 404.
+    // Other status codes (5xx, network errors) propagate immediately —
+    // fallback is for "this tag doesn't have the pack yet", not for "the
+    // network is broken".
+    if (first.res.statusCode === 404 && requestedRef !== 'main') {
+        onProgress(`ref ${requestedRef} 404; falling back to main`);
+        const second = await tryRef('main');
+        if (second.res.statusCode === 200) {
+            return {
+                manifest: parseManifest(second.res.body, second.manifestUrl),
+                refUsed: 'main',
+                baseUrl: second.baseUrl,
+            };
+        }
+        throw new PackFetchError(`Failed to fetch manifest from both ${requestedRef} and main (HTTP ${second.res.statusCode})`, second.manifestUrl, second.res.statusCode);
+    }
+    throw new PackFetchError(`Failed to fetch manifest from ${requestedRef}: HTTP ${first.res.statusCode}`, first.manifestUrl, first.res.statusCode);
+}
+function parseManifest(body, url) {
+    let raw;
+    try {
+        raw = JSON.parse(new TextDecoder('utf-8').decode(body));
+    }
+    catch (err) {
+        throw new PackFetchError(`Manifest at ${url} is not valid JSON: ${err.message}`, url);
+    }
+    if (!raw ||
+        typeof raw !== 'object' ||
+        typeof raw.packVersion !== 'string' ||
+        typeof raw.mjMajor !== 'string' ||
+        !Array.isArray(raw.files)) {
+        throw new PackFetchError(`Manifest at ${url} has the wrong shape`, url);
+    }
+    return raw;
+}
+function verifyChecksum(entry, body) {
+    const actual = createHash('sha256').update(body).digest('hex');
+    if (actual !== entry.sha256) {
+        throw new PackChecksumError(`Checksum mismatch for ${entry.path}: expected ${entry.sha256}, got ${actual}`, entry.path, entry.sha256, actual);
+    }
+    if (body.length !== entry.bytes) {
+        throw new PackChecksumError(`Size mismatch for ${entry.path}: expected ${entry.bytes} bytes, got ${body.length}`, entry.path, String(entry.bytes), String(body.length));
+    }
+}
+//# sourceMappingURL=PackFetcher.js.map

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

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

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

@@ -0,0 +1,62 @@
+/**
+ * Top-level orchestrator for `mj install:claude` and `mj update:claude`.
+ *
+ * Composes:
+ *  - source resolution (remote via PackFetcher, or local via PackPaths)
+ *  - MJ-major detection and the cross-major guard
+ *  - the --check fast path (compare versions without touching the FS)
+ *  - the merge (PackMerger) and InstallResult assembly
+ *
+ * The CLI command files thinly wrap this with flag parsing + output rendering.
+ *
+ * @see plans/claude-install-pack.md §6.3, §6.5, §7.4, §7.5
+ */
+import { type HttpGetter } from './PackFetcher.js';
+import { buildRemoteUrlPrefix } from './PackPaths.js';
+import { type InstallResult } from './PackTypes.js';
+export interface InstallPackOptions {
+    /** Absolute or relative target directory (default: process.cwd()). */
+    TargetDir: string;
+    /** Override the detected MJ major. Useful when target dir has no MJ deps yet. */
+    Major?: string;
+    /** Git ref to fetch from (branch or tag). Default: `'main'`. */
+    Ref?: string;
+    /**
+     * Use a local pack source instead of fetching. Accepts an MJ repo root
+     * (looks under `templates/claude-pack/dist/v{N}/`) or an already-unpacked
+     * dist directory.
+     */
+    FromPath?: string;
+    /** Forbid network — requires FromPath. */
+    Offline?: boolean;
+    /** Don't write anything, just compute the action plan. */
+    DryRun?: boolean;
+    /** Overwrite user-customized commands/skills (skip prompts). */
+    Force?: boolean;
+    /** Skip the seed of `.claude/commands/`. */
+    SkipCommands?: boolean;
+    /** Skip the seed of `.claude/skills/`. */
+    SkipSkills?: boolean;
+    /** Skip the `.claude/settings.json` deep-merge. */
+    SkipSettings?: boolean;
+    /** update:claude only — resync commands. */
+    RefreshCommands?: boolean;
+    /** update:claude only — resync skills. */
+    RefreshSkills?: boolean;
+    /** update:claude only — don't write; compare versions and return. */
+    CheckOnly?: boolean;
+    /**
+     * update:claude only — required when the remote pack's major differs from
+     * the local MJ install's major. Without this flag, the installer refuses
+     * the cross-major migration as a guardrail.
+     */
+    AllowMajor?: boolean;
+    /** Injected HTTP getter (tests). Defaults to real `node:https`. */
+    HttpGet?: HttpGetter;
+    /** Progress callback for verbose mode. */
+    OnProgress?: (message: string) => void;
+}
+export declare function installPack(opts: InstallPackOptions): Promise<InstallResult>;
+/** Re-export the default raw URL prefix for tests / verbose logging. */
+export { buildRemoteUrlPrefix };
+//# sourceMappingURL=PackInstaller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PackInstaller.d.ts","sourceRoot":"","sources":["../../../src/lib/claude-pack/PackInstaller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAa,KAAK,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAE9E,OAAO,EACH,oBAAoB,EAIvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAGH,KAAK,aAAa,EAErB,MAAM,gBAAgB,CAAC;AAMxB,MAAM,WAAW,kBAAkB;IAC/B,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mDAAmD;IACnD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,4CAA4C;IAC5C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,0CAA0C;IAC1C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mEAAmE;IACnE,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAMD,wBAAsB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CA2ElF;AA8ID,wEAAwE;AACxE,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

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

@@ -0,0 +1,197 @@
+/**
+ * Top-level orchestrator for `mj install:claude` and `mj update:claude`.
+ *
+ * Composes:
+ *  - source resolution (remote via PackFetcher, or local via PackPaths)
+ *  - MJ-major detection and the cross-major guard
+ *  - the --check fast path (compare versions without touching the FS)
+ *  - the merge (PackMerger) and InstallResult assembly
+ *
+ * The CLI command files thinly wrap this with flag parsing + output rendering.
+ *
+ * @see plans/claude-install-pack.md §6.3, §6.5, §7.4, §7.5
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fetchPack, PackFetchError } from './PackFetcher.js';
+import { mergePack } from './PackMerger.js';
+import { buildRemoteUrlPrefix, detectMJMajor, detectMJVersionString, resolveLocalPackRoot, } from './PackPaths.js';
+import { emptyActionLog, } from './PackTypes.js';
+// ---------------------------------------------------------------------------
+// Main entry point
+// ---------------------------------------------------------------------------
+export async function installPack(opts) {
+    const targetDir = path.resolve(opts.TargetDir);
+    const onProgress = opts.OnProgress ?? (() => { });
+    const major = opts.Major ?? detectMJMajor(targetDir);
+    if (!major) {
+        return errorResult(null, 'Could not detect MJ major version (no @memberjunction/* in package.json). ' +
+            'Pass --major <N> to override.');
+    }
+    if (opts.Offline && !opts.FromPath) {
+        return errorResult(detectMJVersion(targetDir), '--offline requires --from <path>.');
+    }
+    onProgress(`resolving pack (major=v${major}${opts.FromPath ? `, from=${opts.FromPath}` : ''})`);
+    let manifest;
+    let files;
+    try {
+        ({ manifest, files } = await resolvePack(major, opts, onProgress));
+    }
+    catch (err) {
+        const installedMJ = detectMJVersion(targetDir);
+        if (err instanceof PackFetchError) {
+            return errorResult(installedMJ, `Failed to fetch pack: ${err.message}`);
+        }
+        return errorResult(installedMJ, `Failed to resolve pack: ${err.message}`);
+    }
+    const installedMJVersion = detectMJVersion(targetDir);
+    // --check: compare versions and return without writing.
+    if (opts.CheckOnly) {
+        return buildCheckResult(targetDir, manifest, installedMJVersion);
+    }
+    // Cross-major guardrail — pack's major must match local MJ unless explicitly allowed.
+    if (manifest.mjMajor !== major && !opts.AllowMajor) {
+        return errorResult(installedMJVersion, `Pack major v${manifest.mjMajor} doesn't match local MJ major v${major}. ` +
+            `Pass --allow-major to apply anyway.`);
+    }
+    // Inject MANIFEST.json into the files map so the merger writes it to disk.
+    // (The fetched MANIFEST.json itself is not in `files` because the manifest
+    // omits its own entry to avoid the self-reference.)
+    const manifestBytes = new TextEncoder().encode(JSON.stringify(manifest, null, 2) + '\n');
+    files.set('.claude/mj/MANIFEST.json', manifestBytes);
+    onProgress('merging pack into target');
+    const { Actions, Warnings } = mergePack({
+        TargetDir: targetDir,
+        PackFiles: files,
+        Manifest: manifest,
+        DryRun: opts.DryRun,
+        Force: opts.Force,
+        SkipCommands: opts.SkipCommands,
+        SkipSkills: opts.SkipSkills,
+        SkipSettings: opts.SkipSettings,
+        RefreshCommands: opts.RefreshCommands,
+        RefreshSkills: opts.RefreshSkills,
+    });
+    return {
+        ok: Actions.errors.length === 0,
+        packVersion: manifest.packVersion,
+        installedMJVersion,
+        actions: Actions,
+        warnings: Warnings,
+        notes: [],
+    };
+}
+// ---------------------------------------------------------------------------
+// Source resolution
+// ---------------------------------------------------------------------------
+async function resolvePack(major, opts, onProgress) {
+    if (opts.FromPath) {
+        const localRoot = resolveLocalPackRoot(opts.FromPath, major);
+        if (!localRoot) {
+            throw new Error(`Could not find a Claude pack at --from path: ${opts.FromPath}. ` +
+                `Expected either an MJ repo root (with templates/claude-pack/dist/v${major}/) or an unpacked dist directory.`);
+        }
+        return loadLocalPack(localRoot, opts.CheckOnly ?? false);
+    }
+    const fetched = await fetchPack({
+        Major: major,
+        Ref: opts.Ref,
+        HttpGet: opts.HttpGet,
+        OnProgress: onProgress,
+        ManifestOnly: opts.CheckOnly,
+    });
+    return { manifest: fetched.Manifest, files: fetched.Files };
+}
+/**
+ * Read a pack from a local directory, verifying every file's sha256 against
+ * the manifest (sanity check — guards against partial/corrupt local copies).
+ */
+function loadLocalPack(rootDir, manifestOnly) {
+    const manifestPath = path.join(rootDir, '.claude', 'mj', 'MANIFEST.json');
+    if (!existsSync(manifestPath)) {
+        throw new Error(`Local pack at ${rootDir} has no .claude/mj/MANIFEST.json`);
+    }
+    let manifest;
+    try {
+        manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+    }
+    catch (err) {
+        throw new Error(`Local pack manifest at ${manifestPath} is not valid JSON: ${err.message}`);
+    }
+    const files = new Map();
+    if (manifestOnly) {
+        return { manifest, files };
+    }
+    for (const entry of manifest.files) {
+        const abs = path.join(rootDir, ...entry.path.split('/'));
+        if (!existsSync(abs)) {
+            throw new Error(`Local pack missing file: ${entry.path}`);
+        }
+        // `new Uint8Array(readFileSync(...))` normalizes Buffer → Uint8Array
+        // for the strict @types/node generics (see PackFetcher.ts for context).
+        const bytes = new Uint8Array(readFileSync(abs));
+        const hash = createHash('sha256').update(bytes).digest('hex');
+        if (hash !== entry.sha256) {
+            throw new Error(`Local pack checksum mismatch for ${entry.path}: expected ${entry.sha256}, got ${hash}`);
+        }
+        files.set(entry.path, bytes);
+    }
+    return { manifest, files };
+}
+// ---------------------------------------------------------------------------
+// --check fast path
+// ---------------------------------------------------------------------------
+function buildCheckResult(targetDir, manifest, installedMJVersion) {
+    const localVersionFile = path.join(targetDir, '.claude', 'mj', 'VERSION');
+    const localVersion = existsSync(localVersionFile)
+        ? readFileSync(localVersionFile, 'utf8').trim()
+        : null;
+    const actions = emptyActionLog();
+    const warnings = [];
+    const notes = [];
+    if (!localVersion) {
+        // "No local pack" is a state worth flagging — the user ran --check
+        // expecting an installed pack and there isn't one.
+        warnings.push('No local pack found (.claude/mj/VERSION missing).');
+    }
+    else if (localVersion === manifest.packVersion) {
+        // "Up to date" is the success case for --check, not a warning.
+        notes.push(`Pack is up to date (v${localVersion}).`);
+    }
+    else {
+        // "Update available" is informational — there's an action the user
+        // *can* take, but nothing is wrong.
+        notes.push(`Update available: v${localVersion} → v${manifest.packVersion}. Run \`mj update:claude\` to apply.`);
+    }
+    return {
+        ok: true,
+        packVersion: manifest.packVersion,
+        installedMJVersion,
+        actions,
+        warnings,
+        notes,
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function errorResult(installedMJVersion, message) {
+    return {
+        ok: false,
+        packVersion: '',
+        installedMJVersion,
+        actions: { ...emptyActionLog(), errors: [message] },
+        warnings: [],
+        notes: [],
+    };
+}
+/**
+ * Detect the full MJ semver in the target dir (e.g. `5.33.0`). Delegates
+ * to {@link detectMJVersionString} in PackPaths so the workspace-walk
+ * behavior stays in sync with {@link detectMJMajor}.
+ */
+const detectMJVersion = detectMJVersionString;
+/** Re-export the default raw URL prefix for tests / verbose logging. */
+export { buildRemoteUrlPrefix };
+//# sourceMappingURL=PackInstaller.js.map

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

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

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

@@ -0,0 +1,61 @@
+/**
+ * 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 { ManagedBlockError } from './ManagedBlockEditor.js';
+import { type ActionLog, type Manifest } from './PackTypes.js';
+export interface PackMergeOptions {
+    /** Absolute path to the user's project. */
+    TargetDir: string;
+    /**
+     * Pack contents keyed by pack-relative POSIX path. Must include the
+     * MANIFEST.json under `.claude/mj/MANIFEST.json` (PackInstaller injects it).
+     */
+    PackFiles: Map<string, Uint8Array>;
+    Manifest: Manifest;
+    /** Don't write anything — just compute the action plan. */
+    DryRun?: boolean;
+    /** Overwrite user-modified commands/skills without prompting. */
+    Force?: boolean;
+    /** Skip the seed of `.claude/commands/`. */
+    SkipCommands?: boolean;
+    /** Skip the seed of `.claude/skills/`. */
+    SkipSkills?: boolean;
+    /** Skip the settings.json deep-merge. */
+    SkipSettings?: boolean;
+    /** Resync commands from pack (update:claude). Equivalent to per-file --force on commands. */
+    RefreshCommands?: boolean;
+    /** Resync skills from pack (update:claude). */
+    RefreshSkills?: boolean;
+}
+export interface PackMergeResult {
+    Actions: ActionLog;
+    Warnings: string[];
+}
+export declare function mergePack(opts: PackMergeOptions): PackMergeResult;
+declare function bytesEqual(a: Uint8Array, b: Uint8Array): boolean;
+declare function collectPackPathsByPrefix(files: Map<string, Uint8Array>, prefix: string): string[];
+/**
+ * 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.
+ */
+declare function walkRelativeFiles(dir: string, relativeTo: string): string[];
+/** Re-export for tests that want to exercise the walker in isolation. */
+export declare const _internals: {
+    walkRelativeFiles: typeof walkRelativeFiles;
+    bytesEqual: typeof bytesEqual;
+    collectPackPathsByPrefix: typeof collectPackPathsByPrefix;
+};
+export { ManagedBlockError };
+//# sourceMappingURL=PackMerger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PackMerger.d.ts","sourceRoot":"","sources":["../../../src/lib/claude-pack/PackMerger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAYH,OAAO,EAIH,iBAAiB,EACpB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAGH,KAAK,SAAS,EAEd,KAAK,QAAQ,EAChB,MAAM,gBAAgB,CAAC;AAMxB,MAAM,WAAW,gBAAgB;IAC7B,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,QAAQ,EAAE,QAAQ,CAAC;IACnB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yCAAyC;IACzC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6FAA6F;IAC7F,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,+CAA+C;IAC/C,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAMD,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAejE;AAoQD,iBAAS,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAMzD;AAED,iBAAS,wBAAwB,CAC7B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAC9B,MAAM,EAAE,MAAM,GACf,MAAM,EAAE,CAEV;AA8BD;;;;GAIG;AACH,iBAAS,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBpE;AAED,yEAAyE;AACzE,eAAO,MAAM,UAAU;;;;CAA8D,CAAC;AAGtF,OAAO,EAAE,iBAAiB,EAAE,CAAC"}