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

package/dist/lib/dev-workspace/build.js

@@ -0,0 +1,570 @@
+/**
+ * Pure content builders for the four generated workspace files.
+ *
+ * NO SIDE EFFECTS in this module: every function maps member metadata (already
+ * loaded by `detect.ts`) to file content strings. Writing is `write.ts`'s job.
+ *
+ * Content rules reproduce the manual setup this command replaces — each one was
+ * proven by joining these repos by hand before any of it was automated:
+ *  - pnpm-workspace.yaml: `linkWorkspacePackages: true`, the 16-name build-scripts
+ *    allowlist, and per member the repo root plus the member's OWN packages-rooted
+ *    workspace globs re-prefixed with its directory name (producer packages only —
+ *    `apps/*` globs collide because every repo names its apps `mj_api`/`mj_explorer`,
+ *    so detection filters them out before they reach this module). A member with no
+ *    workspace file of its own contributes the proven `packages/*` default; the MJ
+ *    monorepo contributes its 42 nested globs (#3795).
+ *  - .npmrc: exactly three settings lines. There is deliberately no
+ *    `public-hoist-pattern[]` block — see "Why no hoist block" below.
+ *  - package.json: private root manifest, pnpm `packageManager` pin, the
+ *    devDependency union of member roots (highest version wins, every conflict
+ *    reported), and the proven peerDependencyRules bridge block.
+ *  - turbo.json: copied verbatim from a member, with a minimal fallback.
+ *
+ * Why no hoist block: the 78-entry `public-hoist-pattern[]` set the manual setup
+ * carried was written for the npm-hoisted era, when a library could import a
+ * package it never declared and hoisting silently covered for it. An attribution
+ * audit of all 78 entries against the MJ monorepo (2026-08-13) found no entry that
+ * still needs hoisting: every package an MJ library imports is declared by it, and
+ * every third-party peer relationship in the set (`@foblex/flow`'s siblings,
+ * `rete-*-plugin` -> `rete`, `marked-*` -> `marked`, `date-fns-tz` -> `date-fns`,
+ * `ajv-formats` -> `ajv`, radix/expo -> `react`) is satisfied by a real
+ * declaration. pnpm's strict layout is what forced that: a package that imports
+ * what it does not declare fails to resolve rather than falling through to a
+ * hoisted copy, so the pnpm conversion had to fix them all.
+ *
+ * The one residual class is genuinely the shell's own choice rather than a layout
+ * problem — see {@link SHELL_PROVIDED_PEERS}.
+ *
+ * @module lib/dev-workspace/build
+ */
+import { DeriveLockfilePins } from './lockfile.js';
+/** Build-scripts allowlist proven on the core-monorepo spike. */
+export const ONLY_BUILT_DEPENDENCIES = [
+    '@apollo/protobufjs',
+    '@google/genai',
+    '@parcel/watcher',
+    '@zoom/rtms',
+    'browser-tabs-lock',
+    'core-js',
+    'core-js-pure',
+    'esbuild',
+    'isolated-vm',
+    'lmdb',
+    'msgpackr-extract',
+    'oracledb',
+    'protobufjs',
+    'rete',
+    'sharp',
+    'tesseract.js',
+];
+/** The three .npmrc settings lines — strict peers has been the standard since 2026-08-07. */
+export const NPMRC_BASE_LINES = [
+    'package-manager-strict=false',
+    'strict-peer-dependencies=true',
+    'auto-install-peers=true',
+];
+/**
+ * Packages an MJ library declares as a `peerDependency` because the choice belongs
+ * to the app shell, not the library — the auth SDK family especially, where a shell
+ * picks exactly one provider out of five. These are NOT a layout problem and no
+ * pnpm setting fixes them: a shell that serves one of these features declares the
+ * package in its own `package.json`, the same as any other direct dependency.
+ *
+ * Kept here (rather than as prose) so the command's guidance text has one source of
+ * truth. Grouped by the MJ package whose peer declaration creates the requirement.
+ */
+export const SHELL_PROVIDED_PEERS = [
+    {
+        Library: '@memberjunction/ng-auth-services',
+        Peers: [
+            '@auth0/auth0-angular',
+            '@azure/msal-angular',
+            '@azure/msal-browser',
+            '@azure/msal-common',
+            '@okta/okta-auth-js',
+            '@workos-inc/authkit-js',
+            'aws-amplify',
+        ],
+    },
+    {
+        Library: '@memberjunction/ng-explorer-service-worker',
+        Peers: ['@angular/service-worker'],
+    },
+];
+/**
+ * Peer bridge baseline for older published MJ copies still in the tree.
+ *
+ * Verified 2026-08-13 against the MJ monorepo root: the five `allowedVersions`
+ * rules match MJ's own `pnpm.peerDependencyRules` exactly; `ignoreMissing:
+ * ['axios']` is generator-only, for older published MJ copies a parent may still
+ * resolve. The baseline stays hardcoded (rather than read from MJ) because a
+ * parent whose members declare no rules still needs the proven bridge — and any
+ * member-declared `peerDependencyRules` are UNIONED ON TOP of it by
+ * {@link ResolveMemberPnpmBlocks}, so MJ's rules can evolve without a generator
+ * release as long as MJ is a member.
+ */
+export const PEER_DEPENDENCY_RULES = {
+    allowedVersions: {
+        'nunjucks>chokidar': '5',
+        '@modelcontextprotocol/sdk>zod': '^3.24',
+        'zod-to-json-schema>zod': '^3.24',
+        'openai>zod': '^3.24',
+        '@anthropic-ai/sdk>zod': '^3.24',
+    },
+    ignoreMissing: ['axios'],
+};
+/** Used only when no member pins pnpm — the proven pin (== the MJ monorepo's pin today). */
+export const FALLBACK_PNPM_PIN = 'pnpm@10.33.0';
+/** The proven root-manifest devDependency baseline; fills gaps the union leaves. */
+export const BASELINE_DEV_DEPENDENCIES = {
+    turbo: '^2.5.0',
+    'tsc-alias': '^1.8.16',
+};
+/** Minimal parent turbo.json used only when no member carries one. */
+const FALLBACK_TURBO_JSON = `${JSON.stringify({
+    $schema: 'https://turbo.build/schema.json',
+    tasks: { build: { dependsOn: ['^build'], outputs: ['dist/**', 'build/**'] } },
+}, null, 2)}\n`;
+const GENERATED_HEADER = 'Generated by `mj dev workspace` — never commit to any repo; teardown = delete.';
+/** Quotes a YAML list entry the proven way: scoped names quoted, bare names not. */
+function yamlListEntry(name) {
+    return name.startsWith('@') ? `  - '${name}'` : `  - ${name}`;
+}
+/**
+ * One member's glob lines: the repo root plus each of its workspace globs
+ * re-prefixed with its directory name (negations keep the `!` outside the prefix,
+ * as pnpm requires). Preconditions — enforced, since violating them silently
+ * drops packages from the workspace or admits colliding app shells (#3795): the
+ * member has at least one glob, and every POSITIVE glob is packages-rooted.
+ * Negations are exempt (a `!**\/dist\/**` guard survives verbatim): they only
+ * subtract, so re-prefixing one can never admit anything.
+ */
+function memberGlobLines(member) {
+    if (member.WorkspaceGlobs.length === 0) {
+        throw new Error(`Member ${member.Name} has no workspace globs — detection must supply at least the packages/* default`);
+    }
+    const lines = [`  - '${member.Name}'`];
+    for (const glob of member.WorkspaceGlobs) {
+        const negated = glob.startsWith('!');
+        const body = negated ? glob.slice(1) : glob;
+        if (!negated && !body.startsWith('packages/')) {
+            throw new Error(`Member ${member.Name} glob '${glob}' is not rooted under packages/ — detection must filter app-shell globs out`);
+        }
+        lines.push(negated ? `  - '!${member.Name}/${body}'` : `  - '${member.Name}/${glob}'`);
+    }
+    return lines;
+}
+/**
+ * Builds `pnpm-workspace.yaml`: per member (sorted by name) the repo root plus the
+ * member's own packages-rooted workspace globs re-prefixed with its directory name.
+ * Producer packages only — never `apps/*` (app-shell names collide across repos).
+ */
+export function BuildWorkspaceYaml(members) {
+    if (members.length === 0) {
+        throw new Error('BuildWorkspaceYaml requires at least one member repo');
+    }
+    const lines = [`# ${GENERATED_HEADER}`, 'linkWorkspacePackages: true', ''];
+    lines.push('onlyBuiltDependencies:');
+    for (const dep of ONLY_BUILT_DEPENDENCIES) {
+        lines.push(yamlListEntry(dep));
+    }
+    lines.push('', 'packages:');
+    // Plain codepoint order (what Array.prototype.sort did on the old name list) —
+    // keeps regenerated output byte-identical for pre-existing workspaces.
+    for (const member of [...members].sort((a, b) => (a.Name < b.Name ? -1 : a.Name > b.Name ? 1 : 0))) {
+        lines.push(...memberGlobLines(member));
+    }
+    return `${lines.join('\n')}\n`;
+}
+/**
+ * Renders the shell-dependency guidance the command prints — the replacement for
+ * the deleted hoist block. Derived from {@link SHELL_PROVIDED_PEERS} so the advice
+ * and the data cannot drift apart.
+ */
+export function BuildShellPeerGuidance() {
+    const lines = ['Serving an app shell from inside the workspace? Declare its own runtime picks in the shell\'s package.json:'];
+    for (const { Library, Peers } of SHELL_PROVIDED_PEERS) {
+        lines.push(`  ${Library} peers -> ${Peers.join(', ')}`);
+    }
+    lines.push('  (only the ones your shell actually uses — these are choices, not a layout fix)');
+    return lines;
+}
+/**
+ * Builds `.npmrc`: exactly the three proven settings lines.
+ *
+ * No `public-hoist-pattern[]` block by design — see the "Why no hoist block" note
+ * at the top of this module.
+ */
+export function BuildNpmrc() {
+    return `${[`# ${GENERATED_HEADER}`, ...NPMRC_BASE_LINES].join('\n')}\n`;
+}
+/** Parses the leading numeric triple out of a version/range string, or null. */
+function parseVersionTriple(version) {
+    const match = /^[\^~>=<\s v]*(\d+)\.(\d+)\.(\d+)/.exec(version.trim());
+    if (!match)
+        return null;
+    return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+/**
+ * Compares two version/range strings by their base numeric triple.
+ * Returns >0 when `a` is higher, <0 when `b` is higher, 0 on a tie or when
+ * either side has no parseable triple (caller keeps the incumbent and reports).
+ */
+export function CompareVersionStrings(a, b) {
+    const ta = parseVersionTriple(a);
+    const tb = parseVersionTriple(b);
+    if (ta === null || tb === null)
+        return 0;
+    for (let i = 0; i < 3; i++) {
+        if (ta[i] !== tb[i])
+            return ta[i] - tb[i];
+    }
+    return 0;
+}
+/**
+ * Classifies one member devDep for the union: kept as-is, rewritten to
+ * `workspace:*` (member-provided names — local source beats registry pins), or
+ * dropped (`@types/*`; `workspace:` on a package no member provides).
+ */
+function classifyDevDep(name, version, repo, familyNames, result) {
+    if (name.startsWith('@types/')) {
+        if (!result.SkippedTypes.includes(name))
+            result.SkippedTypes.push(name);
+        return null; // the field's @types/mssql 9.1.8+9.1.11 nominal-type break — never union @types
+    }
+    if (familyNames.has(name)) {
+        return { Repo: `workspace member (declared by ${repo})`, Version: 'workspace:*' };
+    }
+    if (version.startsWith('workspace:')) {
+        result.DroppedWorkspace.push({ Package: name, Repo: repo });
+        return null; // meaningless at the parent when nothing provides the package
+    }
+    return { Repo: repo, Version: version };
+}
+/**
+ * Unions every member repo's root devDependencies. Conflict rule: highest base
+ * version wins; ties keep the first seen. EVERY conflict, skip, and drop is
+ * returned so the command can log it — the resolver never decides silently.
+ * `familyNames` = package names provided by workspace members; those become
+ * `workspace:*` (local ALWAYS beats a registry pin — field finding on #3795).
+ */
+export function ResolveDevDependencyUnion(members, familyNames = new Set()) {
+    const chosen = new Map();
+    const conflicts = new Map();
+    const result = { SkippedTypes: [], DroppedWorkspace: [] };
+    for (const member of [...members].sort((a, b) => a.Name.localeCompare(b.Name))) {
+        for (const [name, version] of Object.entries(member.RootPackageJson.devDependencies ?? {})) {
+            const candidate = classifyDevDep(name, version, member.Name, familyNames, result);
+            if (candidate !== null)
+                recordDevDep(chosen, conflicts, name, candidate);
+        }
+    }
+    for (const [name, version] of Object.entries(BASELINE_DEV_DEPENDENCIES)) {
+        if (!chosen.has(name))
+            chosen.set(name, { Repo: 'generator baseline', Version: version });
+    }
+    const union = {};
+    for (const name of [...chosen.keys()].sort()) {
+        union[name] = chosen.get(name).Version;
+    }
+    return { DevDependencies: union, Conflicts: [...conflicts.values()], ...result };
+}
+/** Applies one member's devDep declaration to the union, recording any conflict. */
+function recordDevDep(chosen, conflicts, name, candidate) {
+    const incumbent = chosen.get(name);
+    if (!incumbent) {
+        chosen.set(name, candidate);
+        return;
+    }
+    if (incumbent.Version === candidate.Version)
+        return;
+    const winner = CompareVersionStrings(candidate.Version, incumbent.Version) > 0 ? candidate : incumbent;
+    const loser = winner === candidate ? incumbent : candidate;
+    chosen.set(name, winner);
+    const existing = conflicts.get(name);
+    if (existing) {
+        existing.Winner = winner;
+        existing.Losers.push(loser);
+    }
+    else {
+        conflicts.set(name, { Package: name, Winner: winner, Losers: [loser] });
+    }
+}
+/**
+ * Resolves the pnpm `packageManager` pin for the parent manifest: the highest
+ * pnpm pin any member carries (the MJ monorepo pins pnpm, so with MJ as a member
+ * this matches the MJ repo's pin); otherwise the proven fallback pin.
+ */
+export function ResolvePnpmPin(members) {
+    let best = null;
+    for (const member of [...members].sort((a, b) => a.Name.localeCompare(b.Name))) {
+        const pin = member.RootPackageJson.packageManager;
+        if (!pin || !pin.startsWith('pnpm@'))
+            continue;
+        if (best === null || CompareVersionStrings(pin.slice('pnpm@'.length), best.Pin.slice('pnpm@'.length)) > 0) {
+            best = { Pin: pin, Source: member.Name };
+        }
+    }
+    return best ?? { Pin: FALLBACK_PNPM_PIN, Source: 'generator fallback (proven pin)' };
+}
+/** npm-safe workspace name derived from the parent directory basename. */
+function workspaceName(parentDirName) {
+    const cleaned = parentDirName.toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/^-+|-+$/g, '');
+    return `${cleaned.length > 0 ? cleaned : 'mj'}-dev-workspace`;
+}
+/**
+ * Collects every package name the workspace members provide, from the members'
+ * OWN package enumerations. These names get `workspace:*` overrides in the
+ * parent manifest so local source ALWAYS beats registry copies — the field
+ * measured 1,898 registry shadow copies of family packages before forcing local
+ * with 367 `workspace:*` overrides (#3795 addendum). Duplicate providers are
+ * returned for loud reporting: the link target for a duplicated name is decided
+ * by sort order, silently.
+ */
+export function CollectFamilyPackages(members) {
+    const providers = new Map();
+    for (const member of [...members].sort((a, b) => (a.Name < b.Name ? -1 : a.Name > b.Name ? 1 : 0))) {
+        for (const pkg of member.Packages) {
+            const name = pkg.PackageJson.name;
+            if (name === undefined || name.length === 0)
+                continue;
+            const repos = providers.get(name) ?? new Set();
+            repos.add(member.Name);
+            providers.set(name, repos);
+        }
+    }
+    const duplicates = [];
+    for (const [name, repos] of providers) {
+        if (repos.size > 1)
+            duplicates.push({ Package: name, Repos: [...repos].sort() });
+    }
+    return { Names: [...providers.keys()].sort(), Duplicates: duplicates.sort((a, b) => (a.Package < b.Package ? -1 : 1)) };
+}
+/** Records a first-member-wins value, reporting any differing later declaration as a conflict. */
+function recordFirstWins(chosen, conflicts, key, candidate) {
+    const incumbent = chosen.get(key);
+    if (!incumbent) {
+        chosen.set(key, candidate);
+        return;
+    }
+    if (incumbent.Version === candidate.Version)
+        return;
+    const existing = conflicts.get(key);
+    if (existing) {
+        existing.Losers.push(candidate);
+    }
+    else {
+        conflicts.set(key, { Package: key, Winner: incumbent, Losers: [candidate] });
+    }
+}
+/** Sorted shallow copy of a record by key (codepoint order — deterministic across locales). */
+function sortedRecord(record) {
+    const sorted = {};
+    for (const key of Object.keys(record).sort())
+        sorted[key] = record[key];
+    return sorted;
+}
+/**
+ * Hoists every member's `pnpm` block into one parent-manifest block. pnpm honors
+ * NONE of these at a member (finding 2 on #3795: the field workspace ran
+ * unpatched type-graphql and lost MJ's 26 pins until this was done by hand).
+ * Rules, all deterministic over codepoint-sorted member names:
+ *  - overrides: higher base version wins where comparable, first member wins
+ *    otherwise (npm-alias values never parse) — every conflict reported;
+ *  - patchedDependencies: paths re-rooted to `<member>/<path>`; first member
+ *    wins a same-key conflict (two patches cannot merge) — reported;
+ *  - packageExtensions: first member wins a differing same-key block — reported;
+ *  - peerDependencyRules: allowedVersions first-wins with conflicts reported,
+ *    ignoreMissing set-unioned.
+ */
+export function ResolveMemberPnpmBlocks(members) {
+    const overrides = new Map();
+    const patches = new Map();
+    const extensionMeta = new Map();
+    const extensionValues = new Map();
+    const peerAllowed = new Map();
+    const conflicts = new Map();
+    const ignoreMissing = new Set();
+    for (const member of [...members].sort((a, b) => (a.Name < b.Name ? -1 : a.Name > b.Name ? 1 : 0))) {
+        const block = member.RootPackageJson.pnpm ?? {};
+        for (const [name, version] of Object.entries(block.overrides ?? {})) {
+            recordDevDep(overrides, conflicts, name, { Repo: member.Name, Version: version });
+        }
+        for (const [pkg, patchPath] of Object.entries(block.patchedDependencies ?? {})) {
+            recordFirstWins(patches, conflicts, pkg, { Repo: member.Name, Version: `${member.Name}/${patchPath}` });
+        }
+        for (const [pkg, extension] of Object.entries(block.packageExtensions ?? {})) {
+            recordFirstWins(extensionMeta, conflicts, pkg, { Repo: member.Name, Version: JSON.stringify(extension) });
+            if (!extensionValues.has(pkg))
+                extensionValues.set(pkg, extension); // mirrors first-wins
+        }
+        for (const [rule, range] of Object.entries(block.peerDependencyRules?.allowedVersions ?? {})) {
+            recordFirstWins(peerAllowed, conflicts, rule, { Repo: member.Name, Version: range });
+        }
+        for (const name of block.peerDependencyRules?.ignoreMissing ?? []) {
+            ignoreMissing.add(name);
+        }
+    }
+    return {
+        Overrides: sortedRecord(Object.fromEntries([...overrides].map(([k, v]) => [k, v.Version]))),
+        PatchedDependencies: sortedRecord(Object.fromEntries([...patches].map(([k, v]) => [k, v.Version]))),
+        PackageExtensions: sortedRecord(Object.fromEntries(extensionValues)),
+        PeerAllowedVersions: sortedRecord(Object.fromEntries([...peerAllowed].map(([k, v]) => [k, v.Version]))),
+        PeerIgnoreMissing: [...ignoreMissing].sort(),
+        Conflicts: [...conflicts.values()],
+        Patches: [...patches].map(([pkg, v]) => ({ Package: pkg, Path: v.Version, Repo: v.Repo })).sort((a, b) => (a.Package < b.Package ? -1 : 1)),
+    };
+}
+/** The bare package name of an override key: `chalk@^5` -> `chalk`, `@types/node@^4` -> `@types/node`. */
+function overrideKeyName(key) {
+    const at = key.lastIndexOf('@');
+    return at <= 0 ? key : key.slice(0, at);
+}
+/** Removes every pin entry (plain or per-major selector) for a name; records what was displaced. */
+function displacePinsForName(overrides, name, newValue, superseded) {
+    for (const key of Object.keys(overrides)) {
+        if (overrideKeyName(key) !== name && key !== name)
+            continue;
+        if (overrides[key] !== newValue)
+            superseded.add(key);
+        delete overrides[key];
+    }
+}
+/**
+ * Layers the three override sources into the parent `pnpm.overrides`, weakest
+ * first: lockfile-derived pins < explicit member overrides < family
+ * `workspace:*` (local source always wins). A member's or family's whole-name
+ * entry displaces every per-major pin selector for that name (a plain key and
+ * a `name@^N` selector must not fight). Displacements are returned so the
+ * command reports them — nothing is overwritten silently.
+ */
+export function AssembleParentOverrides(lockfilePins, memberOverrides, familyNames) {
+    const overrides = { ...lockfilePins };
+    const superseded = new Set();
+    for (const [key, version] of Object.entries(memberOverrides)) {
+        if (overrideKeyName(key) === key) {
+            // whole-name member override displaces every per-major pin selector for the name
+            displacePinsForName(overrides, key, version, superseded);
+        }
+        else if (key in overrides && overrides[key] !== version) {
+            superseded.add(key); // range-scoped member override displaces only its own selector
+        }
+        overrides[key] = version;
+    }
+    for (const name of familyNames) {
+        displacePinsForName(overrides, name, 'workspace:*', superseded);
+        overrides[name] = 'workspace:*';
+    }
+    return { Overrides: sortedRecord(overrides), SupersededPins: [...superseded].sort() };
+}
+/** Builds the manifest's `pnpm` block from the assembled parts, omitting empty sections. */
+function buildPnpmBlock(overrides, blocks) {
+    const peerDependencyRules = {
+        allowedVersions: sortedRecord({ ...PEER_DEPENDENCY_RULES.allowedVersions, ...blocks.PeerAllowedVersions }),
+        ignoreMissing: [...new Set([...PEER_DEPENDENCY_RULES.ignoreMissing, ...blocks.PeerIgnoreMissing])].sort(),
+    };
+    const block = { peerDependencyRules };
+    if (Object.keys(overrides).length > 0)
+        block.overrides = overrides;
+    if (Object.keys(blocks.PatchedDependencies).length > 0) {
+        block.patchedDependencies = blocks.PatchedDependencies;
+        // A member patch is keyed to pkg@version; when the parent graph never resolves
+        // that exact version, pnpm hard-fails the WHOLE install with ERR_PNPM_UNUSED_PATCH.
+        // One member's stale patch must not brick every member's workspace — allow it,
+        // and rely on the assembly report, which names every hoisted patch.
+        block.allowUnusedPatches = true;
+    }
+    if (Object.keys(blocks.PackageExtensions).length > 0)
+        block.packageExtensions = blocks.PackageExtensions;
+    return block;
+}
+/**
+ * Builds the private parent `package.json`: pnpm pin, the cleaned member
+ * devDependency union, and the full absorbed `pnpm` block — member overrides and
+ * patches hoisted, lockfile-derived pins, and `workspace:*` overrides for every
+ * member-provided package. Every decision lands in the returned Report.
+ */
+export function BuildRootPackageJson(parentDirName, members) {
+    if (members.length === 0) {
+        throw new Error('BuildRootPackageJson requires at least one member repo');
+    }
+    const family = CollectFamilyPackages(members);
+    const union = ResolveDevDependencyUnion(members, new Set(family.Names));
+    const pins = DeriveLockfilePins(members.flatMap((m) => (m.Lockfile !== null && m.Lockfile.Kind !== 'unsupported' ? [{ Repo: m.Name, Lockfile: m.Lockfile }] : [])), new Set(family.Names));
+    const blocks = ResolveMemberPnpmBlocks(members);
+    const assembled = AssembleParentOverrides(pins.Pins, blocks.Overrides, family.Names);
+    const { Pin, Source } = ResolvePnpmPin(members);
+    const manifest = {
+        name: workspaceName(parentDirName),
+        private: true,
+        packageManager: Pin,
+        devDependencies: union.DevDependencies,
+        pnpm: buildPnpmBlock(assembled.Overrides, blocks),
+    };
+    return {
+        Content: `${JSON.stringify(manifest, null, 2)}\n`,
+        Conflicts: union.Conflicts,
+        PinSource: Source,
+        Pin,
+        Report: buildManifestReport(members, family, union, pins, blocks, assembled.SupersededPins),
+    };
+}
+/** Assembles the absorption report — one place, so nothing the build decided goes unreported. */
+function buildManifestReport(members, family, union, pins, blocks, supersededPins) {
+    const lockfileSkips = members.flatMap((m) => m.Lockfile !== null && m.Lockfile.Kind !== 'unsupported' ? m.Lockfile.Skipped.map((skip) => ({ Repo: m.Name, Skip: skip })) : []);
+    const unsupportedLockfiles = members.flatMap((m) => m.Lockfile !== null && m.Lockfile.Kind === 'unsupported' ? [{ Repo: m.Name, File: m.Lockfile.File, Version: m.Lockfile.Version }] : []);
+    return {
+        LockfilePinCount: Object.keys(pins.Pins).length,
+        PinConflicts: pins.Conflicts,
+        LockfileSkips: lockfileSkips,
+        UnsupportedLockfiles: unsupportedLockfiles,
+        HoistedOverrideCount: Object.keys(blocks.Overrides).length,
+        BlockConflicts: blocks.Conflicts,
+        Patches: blocks.Patches,
+        FamilyOverrideCount: family.Names.length,
+        DuplicateFamilyPackages: family.Duplicates,
+        SkippedTypesDevDeps: [...union.SkippedTypes].sort(),
+        DroppedWorkspaceDevDeps: union.DroppedWorkspace,
+        SupersededPins: supersededPins,
+    };
+}
+/**
+ * Marker value the sentinel carries. `mj dev workspace clean` refuses to delete a
+ * workspace whose sentinel does not carry exactly this string, so it is the proof
+ * that the residue at a parent directory is this tool's own output.
+ */
+export const SENTINEL_MARKER = 'mj dev workspace';
+/**
+ * Builds the `.mj-dev-workspace.json` sentinel manifest: the marker `clean`
+ * checks, the files the generator wrote, and the members it wrote them for.
+ *
+ * Both lists are sorted and no timestamp is recorded — regenerating an unchanged
+ * workspace must produce a byte-identical sentinel.
+ */
+export function BuildSentinel(fileNames, memberNames) {
+    if (fileNames.length === 0) {
+        throw new Error('BuildSentinel requires at least one generated file name');
+    }
+    if (memberNames.length === 0) {
+        throw new Error('BuildSentinel requires at least one member repo');
+    }
+    const sentinel = {
+        generatedBy: SENTINEL_MARKER,
+        files: [...fileNames].sort(),
+        members: [...memberNames].sort(),
+    };
+    return `${JSON.stringify(sentinel, null, 2)}\n`;
+}
+/**
+ * Picks the parent `turbo.json`: copied verbatim from the first member (sorted by
+ * name) that carries one; a minimal proven config otherwise.
+ */
+export function PickTurboJson(members) {
+    for (const member of [...members].sort((a, b) => a.Name.localeCompare(b.Name))) {
+        if (member.TurboJson !== null) {
+            return { Content: member.TurboJson, Source: member.Name };
+        }
+    }
+    return { Content: FALLBACK_TURBO_JSON, Source: 'generator fallback' };
+}
+//# sourceMappingURL=build.js.map

package/dist/lib/dev-workspace/build.js.map

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

package/dist/lib/dev-workspace/clean.d.ts

@@ -0,0 +1,40 @@
+import type { CleanPlan, CleanResult, SentinelReadResult } from './types.js';
+/** Lockfile `pnpm install` produces at the parent. */
+export declare const LOCKFILE_NAME = "pnpm-lock.yaml";
+/** Dependency tree `pnpm install` produces at the parent. */
+export declare const NODE_MODULES_NAME = "node_modules";
+/**
+ * Number of paths clean owns: the four workspace files, the lockfile, the
+ * node_modules tree, and the sentinel. Asserted in {@link PlanClean} so editing a
+ * file-name constant can never silently widen or narrow what clean deletes.
+ */
+export declare const CLEAN_TARGET_COUNT: number;
+/**
+ * Reads the sentinel at a parent directory. Read-only, and never throws for a
+ * malformed file: a sentinel that is absent or not ours is a decision the caller
+ * makes (refuse, or proceed under `--force`), not a crash.
+ */
+export declare function ReadSentinel(parentDir: string): SentinelReadResult;
+/**
+ * Applies the pre-deletion safety ladder and returns what the sentinel said.
+ * Throws when the parent is not a safe workspace parent, or when no valid
+ * sentinel is present and `force` was not given.
+ */
+export declare function AssertCleanAllowed(parentDir: string, force: boolean): SentinelReadResult;
+/**
+ * Builds the removal plan for a parent directory: every owned path with whether it
+ * exists right now, plus the `.bak` files that will be left alone. Read-only.
+ */
+export declare function PlanClean(parentDir: string): CleanPlan;
+/**
+ * Deletes every existing target in plan order. Targets that are already absent
+ * are reported, not treated as failures. A failed removal aborts and names what
+ * had already gone — the sentinel is removed last, so a re-run resumes.
+ */
+export declare function ExecuteClean(plan: CleanPlan): CleanResult;
+/**
+ * Renders the `--dry-run` report: only the paths that actually exist (so the list
+ * is what a real clean would delete), plus the `.bak` files it would leave. Pure.
+ */
+export declare function RenderCleanPlan(plan: CleanPlan): string[];
+//# sourceMappingURL=clean.d.ts.map

package/dist/lib/dev-workspace/clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../../src/lib/dev-workspace/clean.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAe,kBAAkB,EAAqB,MAAM,YAAY,CAAC;AAE7G,sDAAsD;AACtD,eAAO,MAAM,aAAa,mBAAmB,CAAC;AAE9C,6DAA6D;AAC7D,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAQhD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAAkC,CAAC;AA6BlE;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,CAQlE;AAiBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAKxF;AAqBD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAYtD;AAeD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,WAAW,CAoBzD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,CAazD"}