@memberjunction/cli 5.41.0 → 5.42.0

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"}

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"}