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

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

@@ -0,0 +1,180 @@
+import type { CandidateRepo, DevDepConflict, DuplicateFamilyPackage, PackageExtension, RootPackageJsonResult, TurboJsonResult } from './types.js';
+/** Build-scripts allowlist proven on the core-monorepo spike. */
+export declare const ONLY_BUILT_DEPENDENCIES: readonly string[];
+/** The three .npmrc settings lines — strict peers has been the standard since 2026-08-07. */
+export declare const NPMRC_BASE_LINES: readonly string[];
+/**
+ * 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 declare const SHELL_PROVIDED_PEERS: ReadonlyArray<{
+    Library: string;
+    Peers: readonly string[];
+}>;
+/**
+ * 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 declare const PEER_DEPENDENCY_RULES: {
+    readonly allowedVersions: {
+        readonly 'nunjucks>chokidar': "5";
+        readonly '@modelcontextprotocol/sdk>zod': "^3.24";
+        readonly 'zod-to-json-schema>zod': "^3.24";
+        readonly 'openai>zod': "^3.24";
+        readonly '@anthropic-ai/sdk>zod': "^3.24";
+    };
+    readonly ignoreMissing: readonly ["axios"];
+};
+/** Used only when no member pins pnpm — the proven pin (== the MJ monorepo's pin today). */
+export declare const FALLBACK_PNPM_PIN = "pnpm@10.33.0";
+/** The proven root-manifest devDependency baseline; fills gaps the union leaves. */
+export declare const BASELINE_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
+/**
+ * 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 declare function BuildWorkspaceYaml(members: ReadonlyArray<Pick<CandidateRepo, 'Name' | 'WorkspaceGlobs'>>): string;
+/**
+ * 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 declare function BuildShellPeerGuidance(): string[];
+/**
+ * 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 declare function BuildNpmrc(): string;
+/**
+ * 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 declare function CompareVersionStrings(a: string, b: string): number;
+/** Result of the devDependency union: the deps plus everything it dropped or transformed. */
+export interface DevDependencyUnionResult {
+    DevDependencies: Record<string, string>;
+    Conflicts: DevDepConflict[];
+    /** `@types/*` names excluded entirely — two copies of one @types package is a guaranteed nominal-type break. */
+    SkippedTypes: string[];
+    /** `workspace:` specifiers on packages NO member provides — unresolvable at the parent, dropped. */
+    DroppedWorkspace: Array<{
+        Package: string;
+        Repo: string;
+    }>;
+}
+/**
+ * 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 declare function ResolveDevDependencyUnion(members: readonly CandidateRepo[], familyNames?: ReadonlySet<string>): DevDependencyUnionResult;
+/**
+ * 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 declare function ResolvePnpmPin(members: readonly CandidateRepo[]): {
+    Pin: string;
+    Source: string;
+};
+/**
+ * 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 declare function CollectFamilyPackages(members: readonly CandidateRepo[]): {
+    Names: string[];
+    Duplicates: DuplicateFamilyPackage[];
+};
+/** The unioned member pnpm blocks, ready for the parent manifest. */
+export interface MemberPnpmBlocksResult {
+    Overrides: Record<string, string>;
+    /** `pkg@version` -> patch path RE-ROOTED to `<member>/<path>`. */
+    PatchedDependencies: Record<string, string>;
+    PackageExtensions: Record<string, PackageExtension>;
+    PeerAllowedVersions: Record<string, string>;
+    PeerIgnoreMissing: string[];
+    Conflicts: DevDepConflict[];
+    Patches: Array<{
+        Package: string;
+        Path: string;
+        Repo: string;
+    }>;
+}
+/**
+ * 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 declare function ResolveMemberPnpmBlocks(members: readonly CandidateRepo[]): MemberPnpmBlocksResult;
+/**
+ * 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 declare function AssembleParentOverrides(lockfilePins: Record<string, string>, memberOverrides: Record<string, string>, familyNames: readonly string[]): {
+    Overrides: Record<string, string>;
+    SupersededPins: string[];
+};
+/**
+ * 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 declare function BuildRootPackageJson(parentDirName: string, members: readonly CandidateRepo[]): RootPackageJsonResult;
+/**
+ * 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 declare 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 declare function BuildSentinel(fileNames: readonly string[], memberNames: readonly string[]): string;
+/**
+ * Picks the parent `turbo.json`: copied verbatim from the first member (sorted by
+ * name) that carries one; a minimal proven config otherwise.
+ */
+export declare function PickTurboJson(members: readonly CandidateRepo[]): TurboJsonResult;
+//# sourceMappingURL=build.d.ts.map

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

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