@memberjunction/cli 6.1.0-edge.1 → 6.1.0-edge.3

package/dist/commands/dev/workspace/doctor.js

@@ -0,0 +1,62 @@
+import { Command, Flags } from '@oclif/core';
+import path from 'node:path';
+import { ResolveDirSource, WORKSPACE_DIR_ENV_VAR } from '../../../lib/dev-workspace/dir-flag.js';
+import { CollectDoctorReport, DoctorHasFailures, RenderDoctor } from '../../../lib/dev-workspace/doctor.js';
+import { GetPnpmVersion } from '../../../lib/dev-workspace/pnpm.js';
+/**
+ * CLI command: `mj dev workspace doctor`.
+ *
+ * Read-only health check for a generated cross-repo workspace: prints one
+ * PASS/WARN/FAIL/SKIP line per check and exits non-zero when any check FAILS, so
+ * it can gate a script. It writes nothing, deletes nothing and makes no network
+ * call — every fix it finds is printed as a command for the user to run.
+ *
+ * The check `status` cannot do is the one-copy census: it reads the parent's pnpm
+ * virtual store and fails when more than one version of a must-be-single-copy
+ * package (Angular, RxJS, zone.js, MJ core/global) is installed there.
+ */
+export default class DevWorkspaceDoctor extends Command {
+    static { this.description = 'Health-check the generated cross-repo pnpm workspace at a parent directory: workspace files, sentinel, ' +
+        'pnpm pin vs. active version, member directories, detected-but-unlisted repos, members carrying a standalone ' +
+        'install, and a one-copy census of the parent package store (more than one @angular/core, rxjs, zone.js or ' +
+        'MJ core/global is a FAIL). Prints PASS/WARN/FAIL per check and exits non-zero on any FAIL. Read-only.'; }
+    static { this.examples = [
+        '<%= config.bin %> dev workspace doctor',
+        '<%= config.bin %> dev workspace doctor --dir ~/code/bluecypress',
+        `MJ_DEV_WORKSPACE_DIR=~/code/bluecypress <%= config.bin %> dev workspace doctor`,
+    ]; }
+    static { this.flags = {
+        dir: Flags.string({
+            description: `Parent directory holding the sibling repo clones (env: ${WORKSPACE_DIR_ENV_VAR})`,
+            env: WORKSPACE_DIR_ENV_VAR,
+            default: '.',
+        }),
+    }; }
+    async run() {
+        const { flags } = await this.parse(DevWorkspaceDoctor);
+        const parentDir = path.resolve(flags.dir);
+        const dirSource = ResolveDirSource(this.argv, process.env[WORKSPACE_DIR_ENV_VAR]);
+        const report = await this.collectReport(parentDir, dirSource);
+        this.log('');
+        this.log(RenderDoctor(report));
+        if (DoctorHasFailures(report)) {
+            this.exit(1);
+        }
+    }
+    /**
+     * Probes the active pnpm version (the one spawn in this command) and collects the
+     * report. Collection errors — an unreadable store, a parent that does not exist —
+     * become a clean CLI error rather than a stack trace; `this.error` never returns.
+     */
+    async collectReport(parentDir, dirSource) {
+        try {
+            const activePnpm = await GetPnpmVersion(parentDir);
+            return CollectDoctorReport(parentDir, activePnpm, dirSource);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return this.error(message);
+        }
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/dev/workspace/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../../src/commands/dev/workspace/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AACjG,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,YAAY,EAAqB,MAAM,sCAAsC,CAAC;AAC/H,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGpE;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,OAAO;aAC9C,gBAAW,GAChB,yGAAyG;QACzG,8GAA8G;QAC9G,4GAA4G;QAC5G,uGAAuG,CAAC;aAEnG,aAAQ,GAAG;QAChB,wCAAwC;QACxC,iEAAiE;QACjE,gFAAgF;KACjF,CAAC;aAEK,UAAK,GAAG;QACb,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC;YAChB,WAAW,EAAE,0DAA0D,qBAAqB,GAAG;YAC/F,GAAG,EAAE,qBAAqB;YAC1B,OAAO,EAAE,GAAG;SACb,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAElF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC9D,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/B,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,aAAa,CAAC,SAAiB,EAAE,SAAoB;QACjE,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC;YACnD,OAAO,mBAAmB,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC"}

package/dist/commands/dev/workspace/index.d.ts

@@ -0,0 +1,60 @@
+import { Command } from '@oclif/core';
+/**
+ * CLI command: `mj dev workspace`.
+ *
+ * Generates the four ephemeral files that join sibling repo checkouts into a
+ * single pnpm workspace at their common parent directory (pnpm-workspace.yaml,
+ * .npmrc, package.json, turbo.json), then runs `pnpm install` there.
+ *
+ * Automates what was previously a hand-run setup: writing those files yourself and
+ * keeping them in step as repos come and go.
+ * Linking only — app REGISTRATION into a running host is deliberately phase 2.
+ */
+export default class DevWorkspace extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        dir: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        include: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string[], import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        exclude: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string[], import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        install: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        force: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        'clean-members': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    /** Resolves the member set: detected candidates plus --include, minus --exclude. */
+    private selectMembers;
+    /**
+     * Builds every file's content (pure builders) and logs each resolution decision.
+     * The sentinel comes last and records the names of the files alongside it, so its
+     * inventory is true by construction rather than by a constant kept in step.
+     */
+    private buildFiles;
+    /**
+     * Logs where a member's workspace globs came from — and warns LOUDLY when the
+     * member has its own pnpm-workspace.yaml that yielded nothing usable, because a
+     * silent packages/* fallback is exactly the #3795 failure: an install that
+     * succeeds while the member's real packages resolve from the registry.
+     */
+    private reportMemberGlobs;
+    /**
+     * Detects members carrying standalone installs (root or nested node_modules —
+     * depth-independent, per the field's 290-trees lesson on #3795) and removes
+     * them before the parent install, honoring --clean-members/--no-clean-members
+     * or asking interactively. A skip always states the exact consequence.
+     */
+    private handleStandaloneInstalls;
+    /** Decides one member's cleanup: an explicit flag wins; otherwise ask when interactive, skip loudly when not. */
+    private shouldCleanMember;
+    /**
+     * Reports every absorption decision the manifest build made: pins, hoists,
+     * patches, family overrides, drops and skips — loud conflicts, dim counts,
+     * itemized detail behind --verbose. A derivation that dropped something and
+     * said nothing is the #3795 disease; this method is why it cannot recur.
+     */
+    private reportManifestAssembly;
+    /** The dropped/skipped half of the assembly report: @types, workspace: drops, superseded pins, lockfile skips. */
+    private reportManifestDrops;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/dev/workspace/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/dev/workspace/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAwB7C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,OAAO;IAC/C,MAAM,CAAC,WAAW,SAKgF;IAElG,MAAM,CAAC,QAAQ,WAMb;IAEF,MAAM,CAAC,KAAK;;;;;;;;MA8BV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAuC1B,oFAAoF;IACpF,OAAO,CAAC,aAAa;IA4BrB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAuBlB;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;;;;OAKG;YACW,wBAAwB;IA6BtC,iHAAiH;YACnG,iBAAiB;IAkB/B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAyB9B,kHAAkH;IAClH,OAAO,CAAC,mBAAmB;CAmB5B"}

package/dist/commands/dev/workspace/index.js

@@ -0,0 +1,279 @@
+import { confirm } from '@inquirer/prompts';
+import { Command, Flags } from '@oclif/core';
+import chalk from 'chalk';
+import path from 'node:path';
+import { BuildNpmrc, BuildRootPackageJson, BuildSentinel, BuildShellPeerGuidance, BuildWorkspaceYaml, PickTurboJson, } from '../../../lib/dev-workspace/build.js';
+import { DetectCandidates, LoadRepo } from '../../../lib/dev-workspace/detect.js';
+import { WORKSPACE_DIR_ENV_VAR } from '../../../lib/dev-workspace/dir-flag.js';
+import { FindMemberInstallTrees, IsInsideDirectory, RemoveMemberInstallTrees } from '../../../lib/dev-workspace/member-installs.js';
+import { RunPnpmInstall } from '../../../lib/dev-workspace/pnpm.js';
+import { AssertParentDirSafe, SENTINEL_FILE_NAME, WriteWorkspaceFiles } from '../../../lib/dev-workspace/write.js';
+/** Renders one conflict's decision for a warn line. */
+function describeConflict(conflict) {
+    const losers = conflict.Losers.map((l) => `${l.Version} (${l.Repo})`).join(', ');
+    return `kept ${conflict.Winner.Version} (${conflict.Winner.Repo}), dropped ${losers}`;
+}
+/**
+ * CLI command: `mj dev workspace`.
+ *
+ * Generates the four ephemeral files that join sibling repo checkouts into a
+ * single pnpm workspace at their common parent directory (pnpm-workspace.yaml,
+ * .npmrc, package.json, turbo.json), then runs `pnpm install` there.
+ *
+ * Automates what was previously a hand-run setup: writing those files yourself and
+ * keeping them in step as repos come and go.
+ * Linking only — app REGISTRATION into a running host is deliberately phase 2.
+ */
+export default class DevWorkspace extends Command {
+    static { this.description = 'Join sibling repo clones into one pnpm workspace: writes pnpm-workspace.yaml, .npmrc, package.json, ' +
+        'turbo.json and the .mj-dev-workspace.json sentinel at their common parent, then runs pnpm install there. ' +
+        'Members are the parent\'s immediate subdirectories carrying an mj-app.json, a @mj-biz-apps package, or the ' +
+        'MJ monorepo root name. Existing files are never overwritten without --force (which keeps a .bak of each). ' +
+        'Generated files are ephemeral — never commit them; tear them down with `dev workspace clean`.'; }
+    static { this.examples = [
+        '<%= config.bin %> dev workspace --dir ~/code/bluecypress',
+        '<%= config.bin %> dev workspace --dir ~/code/bluecypress --exclude bizapps-sonar',
+        '<%= config.bin %> dev workspace --dir ~/code/bluecypress --include bizapps-common --include bizapps-tasks',
+        '<%= config.bin %> dev workspace --dir ~/code/bluecypress --no-install --force',
+        'MJ_DEV_WORKSPACE_DIR=~/code/bluecypress <%= config.bin %> dev workspace',
+    ]; }
+    static { this.flags = {
+        dir: Flags.string({
+            description: `Parent directory holding the sibling repo clones (must NOT itself be a git repo; env: ${WORKSPACE_DIR_ENV_VAR})`,
+            env: WORKSPACE_DIR_ENV_VAR,
+            default: '.',
+        }),
+        include: Flags.string({
+            multiple: true,
+            description: 'Repo directory name to include as a member (repeatable; adds to the detected set)',
+        }),
+        exclude: Flags.string({
+            multiple: true,
+            description: 'Repo directory name to exclude from the members (repeatable)',
+        }),
+        install: Flags.boolean({
+            description: 'Run `pnpm install` at the parent after generating (disable with --no-install)',
+            default: true,
+            allowNo: true,
+        }),
+        force: Flags.boolean({
+            description: 'Overwrite existing workspace files at the parent (a .bak copy of each is kept)',
+            default: false,
+        }),
+        'clean-members': Flags.boolean({
+            description: 'Remove members\' standalone node_modules trees (root AND nested, depth-independent) before the parent ' +
+                'install; --no-clean-members keeps them. Without either flag, an interactive run asks per member.',
+            allowNo: true,
+        }),
+        verbose: Flags.boolean({ char: 'v', description: 'Show detailed output' }),
+    }; }
+    async run() {
+        const { flags } = await this.parse(DevWorkspace);
+        const parentDir = path.resolve(flags.dir);
+        try {
+            AssertParentDirSafe(parentDir);
+            const members = this.selectMembers(parentDir, flags.include ?? [], flags.exclude ?? []);
+            await this.handleStandaloneInstalls(parentDir, members, flags['clean-members']);
+            const files = this.buildFiles(parentDir, members, flags.verbose);
+            const result = WriteWorkspaceFiles(parentDir, files, flags.force);
+            for (const backup of result.BackedUp) {
+                this.log(chalk.yellow(`Backed up existing file to ${backup}`));
+            }
+            this.log(chalk.green(`Wrote ${result.Written.join(', ')} at ${parentDir}`));
+            for (const line of BuildShellPeerGuidance()) {
+                this.log(chalk.dim(line));
+            }
+            if (flags.install) {
+                this.log(chalk.bold('\nRunning pnpm install...'));
+                await RunPnpmInstall(parentDir);
+                this.log(chalk.green('pnpm install completed'));
+            }
+            else {
+                this.log(chalk.dim('Skipped pnpm install (--no-install); run `pnpm install` at the parent when ready.'));
+            }
+            this.log(chalk.dim(`\nBuild any package from the parent: pnpm --filter <package-name> run build`));
+            this.log(chalk.dim(`(members whose package.json pins npm refuse in-place pnpm runs — drive those from the parent with --filter until they migrate)`));
+            this.log(chalk.dim(`Check the result any time with:  ${this.config.bin} dev workspace status --dir ${parentDir}`));
+            this.log(chalk.dim(`Tear it back down with:          ${this.config.bin} dev workspace clean --dir ${parentDir}`));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.error(message);
+        }
+    }
+    /** Resolves the member set: detected candidates plus --include, minus --exclude. */
+    selectMembers(parentDir, include, exclude) {
+        const members = new Map();
+        for (const candidate of DetectCandidates(parentDir)) {
+            members.set(candidate.Name, candidate);
+        }
+        for (const name of include) {
+            if (members.has(name))
+                continue;
+            const repo = LoadRepo(parentDir, name);
+            if (repo === null) {
+                throw new Error(`--include ${name}: ${path.join(parentDir, name)} has no package.json — not a repo checkout`);
+            }
+            this.warn(`${name} was not detected as a candidate — including it anyway (--include)`);
+            members.set(name, repo);
+        }
+        for (const name of exclude) {
+            if (!members.delete(name))
+                this.warn(`--exclude ${name}: not in the member set, ignoring`);
+        }
+        if (members.size === 0) {
+            throw new Error(`No member repos at ${parentDir}. Candidates are sibling dirs with an mj-app.json, @mj-biz-apps packages, or the MJ monorepo; use --include to add others.`);
+        }
+        const selected = [...members.values()].sort((a, b) => a.Name.localeCompare(b.Name));
+        for (const member of selected) {
+            const why = member.Reasons.length > 0 ? member.Reasons.join(', ') : 'included via --include';
+            this.log(`${chalk.green('member')} ${member.Name} ${chalk.dim(`(${why})`)}`);
+        }
+        return selected;
+    }
+    /**
+     * Builds every file's content (pure builders) and logs each resolution decision.
+     * The sentinel comes last and records the names of the files alongside it, so its
+     * inventory is true by construction rather than by a constant kept in step.
+     */
+    buildFiles(parentDir, members, verbose) {
+        const memberNames = members.map((m) => m.Name);
+        const rootPkg = BuildRootPackageJson(path.basename(parentDir), members);
+        for (const conflict of rootPkg.Conflicts) {
+            this.warn(`devDependency conflict on ${conflict.Package}: ${describeConflict(conflict)}`);
+        }
+        this.log(chalk.dim(`packageManager pin ${rootPkg.Pin} from ${rootPkg.PinSource}`));
+        const turbo = PickTurboJson(members);
+        this.log(chalk.dim(`turbo.json copied from ${turbo.Source}`));
+        for (const member of members) {
+            this.reportMemberGlobs(member);
+        }
+        this.reportManifestAssembly(rootPkg.Report, verbose);
+        const workspaceFiles = [
+            { Name: 'pnpm-workspace.yaml', Content: BuildWorkspaceYaml(members) },
+            { Name: '.npmrc', Content: BuildNpmrc() },
+            { Name: 'package.json', Content: rootPkg.Content },
+            { Name: 'turbo.json', Content: turbo.Content },
+        ];
+        const written = [...workspaceFiles.map((f) => f.Name), SENTINEL_FILE_NAME];
+        return [...workspaceFiles, { Name: SENTINEL_FILE_NAME, Content: BuildSentinel(written, memberNames) }];
+    }
+    /**
+     * Logs where a member's workspace globs came from — and warns LOUDLY when the
+     * member has its own pnpm-workspace.yaml that yielded nothing usable, because a
+     * silent packages/* fallback is exactly the #3795 failure: an install that
+     * succeeds while the member's real packages resolve from the registry.
+     */
+    reportMemberGlobs(member) {
+        for (const glob of member.UnsupportedGlobs) {
+            this.warn(`${member.Name} glob '${glob}' has an unsupported shape (only fixed paths, trailing /* and trailing /** ` +
+                `are expanded) — its packages are NOT enumerated for workspace:* overrides`);
+        }
+        if (member.WorkspaceGlobsSource === 'workspace-yaml-without-packages-globs') {
+            this.warn(`${member.Name} has its own pnpm-workspace.yaml but it yielded NO globs rooted under packages/ — ` +
+                `assuming ${member.Name}/packages/*. If that repo keeps packages anywhere else, they will NOT be ` +
+                `linked into this workspace (they would resolve from the registry instead). Check ${member.Name}/pnpm-workspace.yaml.`);
+            return;
+        }
+        if (member.WorkspaceGlobsSource === 'member-workspace-yaml') {
+            this.log(chalk.dim(`${member.Name} contributes ${member.WorkspaceGlobs.length} workspace globs from its own pnpm-workspace.yaml`));
+        }
+    }
+    /**
+     * Detects members carrying standalone installs (root or nested node_modules —
+     * depth-independent, per the field's 290-trees lesson on #3795) and removes
+     * them before the parent install, honoring --clean-members/--no-clean-members
+     * or asking interactively. A skip always states the exact consequence.
+     */
+    async handleStandaloneInstalls(parentDir, members, cleanFlag) {
+        for (const member of members) {
+            if (!IsInsideDirectory(parentDir, member.Path)) {
+                // possible via --include with a path-like name; never enumerate such a member for deletion
+                this.warn(`${member.Name} lives outside the parent directory (${member.Path}) — excluded from standalone-install cleanup entirely.`);
+                continue;
+            }
+            const scan = FindMemberInstallTrees(member.Path);
+            for (const dir of scan.UnreadableDirs) {
+                this.warn(`${member.Name}: could not read ${dir} while scanning for standalone installs — skipped, anything under it was not scanned`);
+            }
+            if (scan.Trees.length === 0)
+                continue;
+            const clean = await this.shouldCleanMember(member.Name, scan.Trees.length, cleanFlag);
+            if (!clean) {
+                this.warn(`${member.Name}: keeping its standalone install (${scan.Trees.length} node_modules tree(s)). After the parent ` +
+                    `install those trees hold symlinks into a store the parent does not manage — expect dangling links and ` +
+                    `TS2307 'Cannot find module' errors that look like missing dependencies. Re-run with --clean-members to remove them.`);
+                continue;
+            }
+            const result = RemoveMemberInstallTrees(scan.Trees);
+            for (const skip of result.Skipped) {
+                this.warn(`${member.Name}: NOT removed — ${skip.Path}: ${skip.Reason}`);
+            }
+            this.log(chalk.green(`${member.Name}: removed ${result.Removed.length} standalone node_modules tree(s)`));
+        }
+    }
+    /** Decides one member's cleanup: an explicit flag wins; otherwise ask when interactive, skip loudly when not. */
+    async shouldCleanMember(name, treeCount, cleanFlag) {
+        if (cleanFlag !== undefined)
+            return cleanFlag;
+        if (!process.stdin.isTTY || !process.stdout.isTTY) {
+            this.warn(`${name} has a standalone install (${treeCount} node_modules tree(s)) and this run is non-interactive ` +
+                `with no --clean-members/--no-clean-members given — leaving it in place.`);
+            return false;
+        }
+        this.log(`${name} has a standalone install (${treeCount} node_modules tree${treeCount === 1 ? '' : 's'}).`);
+        this.log(`  keep it   → its old trees resolve against a store the parent install does not manage: two copies of shared packages, dangling symlinks, phantom 'Cannot find module' errors`);
+        this.log(`  remove it → ${name} builds only through this workspace until you run a plain install inside it again (one command to switch back)`);
+        return confirm({
+            message: `Remove ${name}'s standalone install before the parent install?`,
+            default: true,
+        });
+    }
+    /**
+     * Reports every absorption decision the manifest build made: pins, hoists,
+     * patches, family overrides, drops and skips — loud conflicts, dim counts,
+     * itemized detail behind --verbose. A derivation that dropped something and
+     * said nothing is the #3795 disease; this method is why it cannot recur.
+     */
+    reportManifestAssembly(report, verbose) {
+        this.log(chalk.dim(`pnpm.overrides: ${report.LockfilePinCount} lockfile-derived pin(s), ${report.HoistedOverrideCount} hoisted ` +
+            `member override(s), ${report.FamilyOverrideCount} workspace:* family override(s); ${report.Patches.length} patch(es) hoisted`));
+        for (const patch of report.Patches) {
+            this.log(chalk.dim(`  patch ${patch.Package} -> ${patch.Path} (from ${patch.Repo})`));
+        }
+        for (const conflict of [...report.PinConflicts, ...report.BlockConflicts]) {
+            this.warn(`override conflict on ${conflict.Package}: ${describeConflict(conflict)}`);
+        }
+        for (const unsupported of report.UnsupportedLockfiles) {
+            this.warn(`${unsupported.Repo} commits ${unsupported.File} with lockfileVersion ${unsupported.Version} — a format this ` +
+                `derivation cannot read, so that member contributes NO pins; its ranges resolve freshly at the parent`);
+        }
+        for (const dup of report.DuplicateFamilyPackages) {
+            this.warn(`package ${dup.Package} is provided by ${dup.Repos.join(' AND ')} — the link target is decided by sort order; use --exclude to drop one`);
+        }
+        this.reportManifestDrops(report, verbose);
+    }
+    /** The dropped/skipped half of the assembly report: @types, workspace: drops, superseded pins, lockfile skips. */
+    reportManifestDrops(report, verbose) {
+        if (report.SkippedTypesDevDeps.length > 0) {
+            const detail = verbose ? `: ${report.SkippedTypesDevDeps.join(', ')}` : '';
+            this.log(chalk.dim(`devDependency union: skipped ${report.SkippedTypesDevDeps.length} @types/* package(s) — duplicate @types are a nominal-type break${detail}`));
+        }
+        for (const dropped of report.DroppedWorkspaceDevDeps) {
+            this.warn(`devDependency ${dropped.Package} (${dropped.Repo}) uses workspace: but NO member provides it — dropped from the parent manifest`);
+        }
+        if (report.SupersededPins.length > 0) {
+            const detail = verbose ? `: ${report.SupersededPins.join(', ')}` : '';
+            this.log(chalk.dim(`${report.SupersededPins.length} lockfile-derived pin(s) superseded by member overrides or workspace:* family overrides${detail}`));
+        }
+        if (report.LockfileSkips.length === 0)
+            return;
+        this.log(chalk.dim(`lockfile pin derivation skipped ${report.LockfileSkips.length} entr(y/ies) (workspace links / non-semver)${verbose ? ':' : ' — --verbose lists them'}`));
+        if (!verbose)
+            return;
+        for (const { Repo, Skip } of report.LockfileSkips) {
+            this.log(chalk.dim(`  ${Repo}: ${Skip.Name}@${Skip.Version} — ${Skip.Reason}`));
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/dev/workspace/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/dev/workspace/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/dev/workspace/status.d.ts

@@ -0,0 +1,19 @@
+import { Command } from '@oclif/core';
+/**
+ * CLI command: `mj dev workspace status`.
+ *
+ * Reports the state of a generated cross-repo workspace at the parent
+ * directory: which of the four generated files exist, whether a lockfile and
+ * node_modules exist, whether the sentinel manifest is present, the member list
+ * versus the candidates detected on disk, how `--dir` was resolved, and whether
+ * the active pnpm version matches the generated pin. Read-only — writes nothing.
+ */
+export default class DevWorkspaceStatus extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        dir: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/dev/workspace/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../../src/commands/dev/workspace/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAM7C;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,OAAO;IACrD,MAAM,CAAC,WAAW,SAE2F;IAE7G,MAAM,CAAC,QAAQ,WAIb;IAEF,MAAM,CAAC,KAAK;;MAMV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAe3B"}

package/dist/commands/dev/workspace/status.js

@@ -0,0 +1,46 @@
+import { Command, Flags } from '@oclif/core';
+import path from 'node:path';
+import { ResolveDirSource, WORKSPACE_DIR_ENV_VAR } from '../../../lib/dev-workspace/dir-flag.js';
+import { GetPnpmVersion } from '../../../lib/dev-workspace/pnpm.js';
+import { CollectWorkspaceStatus, RenderStatus } from '../../../lib/dev-workspace/status.js';
+/**
+ * CLI command: `mj dev workspace status`.
+ *
+ * Reports the state of a generated cross-repo workspace at the parent
+ * directory: which of the four generated files exist, whether a lockfile and
+ * node_modules exist, whether the sentinel manifest is present, the member list
+ * versus the candidates detected on disk, how `--dir` was resolved, and whether
+ * the active pnpm version matches the generated pin. Read-only — writes nothing.
+ */
+export default class DevWorkspaceStatus extends Command {
+    static { this.description = 'Report the state of the generated cross-repo pnpm workspace at a parent directory: generated files, ' +
+        'lockfile, node_modules, sentinel presence, members vs. detected candidates, and the pnpm pin. Read-only.'; }
+    static { this.examples = [
+        '<%= config.bin %> dev workspace status',
+        '<%= config.bin %> dev workspace status --dir ~/code/bluecypress',
+        `MJ_DEV_WORKSPACE_DIR=~/code/bluecypress <%= config.bin %> dev workspace status`,
+    ]; }
+    static { this.flags = {
+        dir: Flags.string({
+            description: `Parent directory holding the sibling repo clones (env: ${WORKSPACE_DIR_ENV_VAR})`,
+            env: WORKSPACE_DIR_ENV_VAR,
+            default: '.',
+        }),
+    }; }
+    async run() {
+        const { flags } = await this.parse(DevWorkspaceStatus);
+        const parentDir = path.resolve(flags.dir);
+        const dirSource = ResolveDirSource(this.argv, process.env[WORKSPACE_DIR_ENV_VAR]);
+        try {
+            const activePnpm = await GetPnpmVersion(parentDir);
+            const status = CollectWorkspaceStatus(parentDir, activePnpm, dirSource);
+            this.log('');
+            this.log(RenderStatus(status));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.error(message);
+        }
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/dev/workspace/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../../src/commands/dev/workspace/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AACjG,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAE5F;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,OAAO;aAC9C,gBAAW,GAChB,sGAAsG;QACtG,0GAA0G,CAAC;aAEtG,aAAQ,GAAG;QAChB,wCAAwC;QACxC,iEAAiE;QACjE,gFAAgF;KACjF,CAAC;aAEK,UAAK,GAAG;QACb,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC;YAChB,WAAW,EAAE,0DAA0D,qBAAqB,GAAG;YAC/F,GAAG,EAAE,qBAAqB;YAC1B,OAAO,EAAE,GAAG;SACb,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAElF,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC;YACnD,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;YACxE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;IACH,CAAC"}

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

@@ -1 +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"}
+{"version":3,"file":"cli-plugins.d.ts","sourceRoot":"","sources":["../../src/lib/cli-plugins.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAazF"}

package/dist/lib/cli-plugins.js

@@ -1,4 +1,5 @@
 import { CLIPluginRegistry } from '@memberjunction/cli-core';
+import { RegisterDevWorkspaceUsage } from './dev-workspace/usage.js';
 /**
  * Loads all CLI plugins so their `@RegisterClass(BaseCLIPlugin, …)` decorators
  * populate the ClassFactory — the basis for the `mj usage` / `mj <domain> usage`
@@ -16,6 +17,10 @@ import { CLIPluginRegistry } from '@memberjunction/cli-core';
 export async function loadAllCliPlugins(searchFrom = process.cwd()) {
     await import('@memberjunction/metadata-sync/plugins');
     await import('@memberjunction/codegen-lib/plugins');
+    // The `dev` domain ships inside this CLI as plain oclif commands (they must stay
+    // bootstrap-free), so it declares its usage through CLIPluginRegistry.RegisterUsage
+    // on import rather than through a plugin's `static Usage`.
+    RegisterDevWorkspaceUsage();
     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.

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

@@ -1 +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"}
+{"version":3,"file":"cli-plugins.js","sourceRoot":"","sources":["../../src/lib/cli-plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAErE;;;;;;;;;;;;;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,iFAAiF;IACjF,oFAAoF;IACpF,2DAA2D;IAC3D,yBAAyB,EAAE,CAAC;IAC5B,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"}