@memberjunction/cli 5.41.0 → 5.42.0

package/dist/commands/usage.js

@@ -0,0 +1,29 @@
+import { Command, Flags } from '@oclif/core';
+import { CLIPluginRegistry } from '@memberjunction/cli-core';
+import { loadAllCliPlugins } from '../lib/cli-plugins.js';
+import { emitUsage, renderDomainMap } from '../lib/usage-render.js';
+/**
+ * Tier-1 progressive disclosure (plan §5, the linearis model). Returns a compact
+ * domain map — each domain + one-line summary + runtime class — so an agent
+ * discovers the CLI's surface in ~200 tokens instead of pulling the full ~13k
+ * command tree. The guidance string tells the agent to run `mj <domain> usage`
+ * before invoking, rather than guessing flags.
+ */
+export default class Usage extends Command {
+    static { this.description = 'List mj command domains (AI-agent-friendly, tier-1 progressive disclosure). Then run `mj <domain> usage`.'; }
+    static { this.examples = [
+        `<%= config.bin %> <%= command.id %>`,
+        `<%= config.bin %> <%= command.id %> --format=json`,
+    ]; }
+    static { this.flags = {
+        format: Flags.string({ options: ['text', 'json', 'md'], default: 'text', description: 'Output format' }),
+    }; }
+    async run() {
+        const { flags } = await this.parse(Usage);
+        await loadAllCliPlugins(process.cwd());
+        const map = CLIPluginRegistry.BuildDomainMap();
+        const result = CLIPluginRegistry.AsResult('usage', { guidance: map.guidance, domains: map.domains });
+        emitUsage((m) => this.log(m), flags.format, result, renderDomainMap(map));
+    }
+}
+//# sourceMappingURL=usage.js.map

package/dist/commands/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/commands/usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEpE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,OAAO;aACjC,gBAAW,GAAG,2GAA2G,CAAC;aAE1H,aAAQ,GAAG;QAChB,qCAAqC;QACrC,mDAAmD;KACpD,CAAC;aAEK,UAAK,GAAG;QACb,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC;KACzG,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,iBAAiB,CAAC,cAAc,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACrG,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,MAAgB,EAAE,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;IACtF,CAAC"}

package/dist/hooks/prerun.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prerun.d.ts","sourceRoot":"","sources":["../../src/hooks/prerun.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAInC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,QAAQ,CAoCxB,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"prerun.d.ts","sourceRoot":"","sources":["../../src/hooks/prerun.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAInC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,QAAQ,CAoExB,CAAC;AAcF,eAAe,IAAI,CAAC"}

package/dist/hooks/prerun.js

@@ -1,14 +1,48 @@
 import figlet from 'figlet';
 import { LIGHT_COMMANDS } from '../light-commands.js';
 const hook = async function (options) {
+    const argv = options.argv ?? [];
+    // Machine-readable output must keep stdout clean — suppress the banner AND the
+    // userAgent line entirely for `--format=json|md` and `--no-banner` (plan §1a/D4).
+    const formatArg = (() => {
+        const eq = argv.find((a) => a.startsWith('--format='));
+        if (eq)
+            return eq.slice('--format='.length);
+        const i = argv.indexOf('--format');
+        return i >= 0 ? argv[i + 1] : undefined;
+    })();
+    const machineFormat = formatArg === 'json' || formatArg === 'md';
+    const noBanner = argv.includes('--no-banner');
+    // `--no-banner` is global chrome — every command renders the banner, so suppressing
+    // it must work on ANY command, including those not yet migrated to BaseCLIPlugin
+    // (which don't declare the flag and would otherwise fail oclif's strict parser with
+    // "Nonexistent flag"). Signal suppression to MJCLIRuntimeHost via env (so migrated
+    // commands still gate their runtime advisory) and strip the flag from argv in place
+    // so the per-command parser never sees an undeclared flag.
+    if (noBanner) {
+        process.env.MJ_CLI_NO_BANNER = '1';
+        for (let i = argv.length - 1; i >= 0; i--) {
+            if (argv[i] === '--no-banner')
+                argv.splice(i, 1);
+        }
+    }
     // Skip banners if --quiet flag is present (or appears to be present)
-    if (options.argv?.some((arg) => arg === '--quiet' || (/^-[^-]+/.test(arg) && arg.includes('q')))) {
+    if (machineFormat || noBanner || argv.some((arg) => arg === '--quiet' || (/^-[^-]+/.test(arg) && arg.includes('q')))) {
+        // Still conditionally load bootstrap below — just no decorative output.
+        return await maybeLoadBootstrap(options);
+    }
+    // Skip banners entirely when --json is requested — the contract for --json
+    // is that stdout is parseable JSON, and any banner above it breaks
+    // `mj … --json | jq`. This early-return also skips the userAgent line below.
+    if (options.argv?.some((arg) => arg === '--json')) {
         return;
     }
     // Suppress the large figlet banner for hot-path, frequently-run commands (e.g. `mj sync *`)
-    // where it's pure scrollback cost. The compact userAgent line below still prints.
+    // and the agent-facing usage commands, where it's pure scrollback cost. The
+    // compact userAgent line below still prints.
     const commandIdForBanner = options.Command.id ?? '';
-    const showFiglet = !commandIdForBanner.startsWith('sync');
+    const isUsageCommand = commandIdForBanner === 'usage' || commandIdForBanner.endsWith('usage');
+    const showFiglet = !commandIdForBanner.startsWith('sync') && !isUsageCommand;
     if (showFiglet) {
         options.context.log(process.stdout.columns >= 81
             ? figlet.textSync('MemberJunction', {
@@ -20,16 +54,23 @@ const hook = async function (options) {
             })
             : '~ M e m b e r J u n c t i o n ~');
     }
-    if (options.Command.id !== 'version') {
+    // The agent-facing usage commands (`mj usage`, `mj <domain> usage`) are meant to
+    // be a terse domain map — skip the userAgent line so text-mode stdout stays clean.
+    if (options.Command.id !== 'version' && !isUsageCommand) {
         options.context.log(options.config.userAgent + '\n');
     }
-    // Conditionally load MJ bootstrap for heavy commands.
-    // Light commands (version, help, bump, migrate, clean, install, dbdoc/*)
-    // skip the ~1,400 class registrations for instant startup.
+    await maybeLoadBootstrap(options);
+};
+/**
+ * Conditionally load MJ bootstrap for heavy commands. Light commands (version,
+ * help, bump, migrate, clean, install, dbdoc/*, usage/*) skip the ~1,400 class
+ * registrations for instant startup.
+ */
+async function maybeLoadBootstrap(options) {
     const commandId = options.Command.id ?? '';
     if (!LIGHT_COMMANDS.has(commandId)) {
         await import('@memberjunction/server-bootstrap-lite/mj-class-registrations');
     }
-};
+}
 export default hook;
 //# sourceMappingURL=prerun.js.map

package/dist/hooks/prerun.js.map

@@ -1 +1 @@
-{"version":3,"file":"prerun.js","sourceRoot":"","sources":["../../src/hooks/prerun.ts"],"names":[],"mappings":"AACA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,IAAI,GAAmB,KAAK,WAAW,OAAO;IAClD,qEAAqE;IACrE,IAAI,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACjG,OAAO;IACT,CAAC;IAED,4FAA4F;IAC5F,kFAAkF;IAClF,MAAM,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC;IACpD,MAAM,UAAU,GAAG,CAAC,kBAAkB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAE1D,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,OAAO,CAAC,GAAG,CACjB,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE;YAC1B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,EAAE;gBAChC,IAAI,EAAE,UAAU;gBAChB,gBAAgB,EAAE,SAAS;gBAC3B,cAAc,EAAE,SAAS;gBACzB,KAAK,EAAE,GAAG;gBACV,eAAe,EAAE,IAAI;aACtB,CAAC;YACJ,CAAC,CAAC,iCAAiC,CACtC,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACvD,CAAC;IAED,sDAAsD;IACtD,yEAAyE;IACzE,2DAA2D;IAC3D,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACnC,MAAM,MAAM,CAAC,8DAA8D,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"prerun.js","sourceRoot":"","sources":["../../src/hooks/prerun.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,40 @@
+/**
+ * Parse + rewrite the MJ-managed block in a user's `CLAUDE.md`.
+ *
+ * The block is delimited by HTML comment markers:
+ *   <!-- MJ-MANAGED:CLAUDE-PACK START key=value key=value -->
+ *   ... managed content ...
+ *   <!-- MJ-MANAGED:CLAUDE-PACK END -->
+ *
+ * Everything before and after the block is the user's free section and must
+ * never be touched.
+ *
+ * @see plans/claude-install-pack.md §3.3, §6.4 (CLAUDE.md row), §10.4
+ */
+import type { ManagedBlock } from './PackTypes.js';
+export declare class ManagedBlockError extends Error {
+    constructor(message: string);
+}
+/**
+ * Find the managed block in a CLAUDE.md file. Returns `null` when no markers
+ * are present (caller should handle the "file exists but unmanaged" case).
+ * Throws `ManagedBlockError` when markers are malformed (e.g. END before
+ * START, only one marker present, multiple START markers).
+ */
+export declare function parseManagedBlock(content: string): ManagedBlock | null;
+/**
+ * Replace the managed block in `content` with `newBody`, updating attributes
+ * on the START marker.
+ *
+ * Throws `ManagedBlockError` if no managed block is present — callers should
+ * use `wrapWithManagedBlock` for the first-install case.
+ */
+export declare function rewriteManagedBlock(content: string, newBody: string, newAttrs: Record<string, string>): string;
+/**
+ * Wrap arbitrary `content` with a managed block, placing the block at the
+ * top and the original content below (as the user's free section).
+ *
+ * If `content` is empty, the result is just the rendered managed block.
+ */
+export declare function wrapWithManagedBlock(content: string, body: string, attrs: Record<string, string>): string;
+//# sourceMappingURL=ManagedBlockEditor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ManagedBlockEditor.d.ts","sourceRoot":"","sources":["../../../src/lib/claude-pack/ManagedBlockEditor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAenD,qBAAa,iBAAkB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI9B;AAMD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAiCtE;AA0BD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,MAAM,CAMR;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,CAKR"}

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

@@ -0,0 +1,127 @@
+/**
+ * Parse + rewrite the MJ-managed block in a user's `CLAUDE.md`.
+ *
+ * The block is delimited by HTML comment markers:
+ *   <!-- MJ-MANAGED:CLAUDE-PACK START key=value key=value -->
+ *   ... managed content ...
+ *   <!-- MJ-MANAGED:CLAUDE-PACK END -->
+ *
+ * Everything before and after the block is the user's free section and must
+ * never be touched.
+ *
+ * @see plans/claude-install-pack.md §3.3, §6.4 (CLAUDE.md row), §10.4
+ */
+// ---------------------------------------------------------------------------
+// Marker constants
+// ---------------------------------------------------------------------------
+/** Match a START marker line and capture the attribute string. */
+const START_RE = /<!--\s*MJ-MANAGED:CLAUDE-PACK\s+START\s*([^>]*?)\s*-->/;
+/** Match an END marker line. */
+const END_RE = /<!--\s*MJ-MANAGED:CLAUDE-PACK\s+END\s*-->/;
+// ---------------------------------------------------------------------------
+// Errors
+// ---------------------------------------------------------------------------
+export class ManagedBlockError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ManagedBlockError';
+    }
+}
+// ---------------------------------------------------------------------------
+// Parse
+// ---------------------------------------------------------------------------
+/**
+ * Find the managed block in a CLAUDE.md file. Returns `null` when no markers
+ * are present (caller should handle the "file exists but unmanaged" case).
+ * Throws `ManagedBlockError` when markers are malformed (e.g. END before
+ * START, only one marker present, multiple START markers).
+ */
+export function parseManagedBlock(content) {
+    const startMatch = START_RE.exec(content);
+    const endMatch = END_RE.exec(content);
+    if (!startMatch && !endMatch)
+        return null;
+    if (!startMatch) {
+        throw new ManagedBlockError('CLAUDE.md has MJ-MANAGED END marker without a matching START.');
+    }
+    if (!endMatch) {
+        throw new ManagedBlockError('CLAUDE.md has MJ-MANAGED START marker without a matching END.');
+    }
+    if (endMatch.index < startMatch.index) {
+        throw new ManagedBlockError('CLAUDE.md has MJ-MANAGED END marker before its START marker.');
+    }
+    // Detect a second START marker — that's a corrupted file we won't auto-fix.
+    const secondStart = START_RE.exec(content.slice(startMatch.index + startMatch[0].length));
+    if (secondStart) {
+        throw new ManagedBlockError('CLAUDE.md has multiple MJ-MANAGED START markers; expected exactly one.');
+    }
+    const before = content.slice(0, startMatch.index);
+    const bodyStart = startMatch.index + startMatch[0].length;
+    const bodyEnd = endMatch.index;
+    const body = content.slice(bodyStart, bodyEnd);
+    const after = content.slice(endMatch.index + endMatch[0].length);
+    const attrs = parseAttrs(startMatch[1]);
+    return { before, body, after, attrs };
+}
+/**
+ * Parse `key=value key2=value2` attribute strings from a START marker.
+ *
+ * Supports unquoted values without spaces (which is what build-pack.mjs emits).
+ * Returns an empty record for an empty attribute string.
+ */
+function parseAttrs(raw) {
+    const out = {};
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return out;
+    for (const pair of trimmed.split(/\s+/)) {
+        const eq = pair.indexOf('=');
+        if (eq <= 0)
+            continue; // skip malformed pairs silently
+        const key = pair.slice(0, eq);
+        const value = pair.slice(eq + 1);
+        out[key] = value;
+    }
+    return out;
+}
+// ---------------------------------------------------------------------------
+// Rewrite
+// ---------------------------------------------------------------------------
+/**
+ * Replace the managed block in `content` with `newBody`, updating attributes
+ * on the START marker.
+ *
+ * Throws `ManagedBlockError` if no managed block is present — callers should
+ * use `wrapWithManagedBlock` for the first-install case.
+ */
+export function rewriteManagedBlock(content, newBody, newAttrs) {
+    const block = parseManagedBlock(content);
+    if (!block) {
+        throw new ManagedBlockError('Cannot rewrite — no managed block found in content.');
+    }
+    return block.before + formatStartMarker(newAttrs) + newBody + formatEndMarker() + block.after;
+}
+/**
+ * Wrap arbitrary `content` with a managed block, placing the block at the
+ * top and the original content below (as the user's free section).
+ *
+ * If `content` is empty, the result is just the rendered managed block.
+ */
+export function wrapWithManagedBlock(content, body, attrs) {
+    const startMarker = formatStartMarker(attrs);
+    const endMarker = formatEndMarker();
+    const trailing = content.length > 0 ? '\n\n' + content : '\n';
+    return startMarker + body + endMarker + trailing;
+}
+function formatStartMarker(attrs) {
+    const attrString = Object.entries(attrs)
+        .map(([k, v]) => `${k}=${v}`)
+        .join(' ');
+    return attrString
+        ? `<!-- MJ-MANAGED:CLAUDE-PACK START ${attrString} -->`
+        : `<!-- MJ-MANAGED:CLAUDE-PACK START -->`;
+}
+function formatEndMarker() {
+    return `<!-- MJ-MANAGED:CLAUDE-PACK END -->`;
+}
+//# sourceMappingURL=ManagedBlockEditor.js.map

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

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

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

@@ -0,0 +1,86 @@
+/**
+ * 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 type { Manifest } from './PackTypes.js';
+/**
+ * Response body is typed as `Uint8Array` (Buffer's superclass) so this type
+ * stays portable across Node typings versions that vary in how strictly they
+ * model Buffer's ArrayBuffer parameter. `Buffer.concat` and `createHash`
+ * both accept `Uint8Array` directly.
+ */
+export interface HttpResponse {
+    statusCode: number;
+    body: Uint8Array;
+}
+/** Promise-based GET. Production = node:https; tests = mock. */
+export type HttpGetter = (url: string) => Promise<HttpResponse>;
+/**
+ * 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 declare const realHttpGet: HttpGetter;
+export declare class PackFetchError extends Error {
+    url?: string;
+    statusCode?: number;
+    constructor(message: string, url?: string, statusCode?: number);
+}
+export declare class PackChecksumError extends Error {
+    path: string;
+    expected: string;
+    actual: string;
+    constructor(message: string, path: string, expected: string, actual: string);
+}
+export interface FetchPackOptions {
+    /** MJ major version (e.g. `5`). Required — used to locate `dist/v{N}/`. */
+    Major: string;
+    /**
+     * Git ref to fetch from. Defaults to `'main'`. If a specific tag is given
+     * and it 404s, the fetcher transparently falls back to `'main'`.
+     */
+    Ref?: string;
+    /** Injected HTTP getter — test seam. Defaults to `realHttpGet`. */
+    HttpGet?: HttpGetter;
+    /** Progress callback for verbose mode. */
+    OnProgress?: (message: string) => void;
+    /**
+     * When true, fetch only the manifest and skip the per-file downloads.
+     * Used by `mj update:claude --check` to compare versions without paying
+     * for content the caller won't write. The returned `Files` map is empty.
+     */
+    ManifestOnly?: boolean;
+}
+export interface FetchedPack {
+    /** Parsed MANIFEST.json. */
+    Manifest: Manifest;
+    /**
+     * Pack file contents keyed by manifest path (e.g. `.claude/mj/core.md`).
+     * Bytes verified against the manifest's sha256 before insertion.
+     */
+    Files: Map<string, Uint8Array>;
+    /** Which ref was actually used (after fallback). */
+    RefUsed: string;
+    /** The full base URL the fetcher ultimately read from. */
+    BaseUrl: string;
+}
+/**
+ * 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 declare function fetchPack(opts: FetchPackOptions): Promise<FetchedPack>;
+//# sourceMappingURL=PackFetcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PackFetcher.d.ts","sourceRoot":"","sources":["../../../src/lib/claude-pack/PackFetcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,gBAAgB,CAAC;AAO9D;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;CACpB;AAED,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAEhE;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,UAcpB,CAAC;AAiBP,qBAAa,cAAe,SAAQ,KAAK;IACD,GAAG,CAAC,EAAE,MAAM;IAAS,UAAU,CAAC,EAAE,MAAM;gBAAhE,OAAO,EAAE,MAAM,EAAS,GAAG,CAAC,EAAE,MAAM,EAAS,UAAU,CAAC,EAAE,MAAM;CAI/E;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAG7B,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,MAAM;gBAHrB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM;CAK5B;AAMD,MAAM,WAAW,gBAAgB;IAC7B,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IACxB,4BAA4B;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB;;;OAGG;IACH,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC/B,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;CACnB;AAMD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAiC5E"}

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