@memberjunction/cli 6.1.0-edge.2 → 6.1.0-edge.4

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

@@ -0,0 +1,14 @@
+/**
+ * Shared types for the `mj dev workspace` generator.
+ *
+ * The generator creates 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`.
+ *
+ * The generated contents reproduce the manual setup this command replaces: every
+ * value was proven by joining these repos by hand before it was automated.
+ *
+ * @module lib/dev-workspace/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/dev-workspace/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

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

@@ -0,0 +1,30 @@
+/**
+ * Progressive-disclosure usage metadata for the `dev` domain (`mj dev usage`).
+ *
+ * SIDE EFFECT ON IMPORT: {@link RegisterDevWorkspaceUsage} is called at the bottom
+ * of this module, so importing it declares the domain. `lib/cli-plugins.ts` imports
+ * it alongside the built-in plugin modules — the single funnel both `mj usage` and
+ * `mj <domain> usage` go through.
+ *
+ * Why declared here rather than as `static Usage` on a BaseCLIPlugin: the dev
+ * commands are plain oclif Commands that ship inside the CLI and must stay
+ * bootstrap-free (they are in LIGHT_COMMANDS), so they are not plugin-backed. The
+ * text below is the ONLY place an agent learns these rules before invoking, so it
+ * states them outright rather than pointing at the commands' help.
+ *
+ * @module lib/dev-workspace/usage
+ */
+import { type PluginUsage } from '@memberjunction/cli-core';
+/** Usage for `mj dev workspace` — the generator. */
+export declare const DEV_WORKSPACE_USAGE: PluginUsage;
+/** Usage for `mj dev workspace status` — the read-only report. */
+export declare const DEV_WORKSPACE_STATUS_USAGE: PluginUsage;
+/** Usage for `mj dev workspace doctor` — the read-only health check. */
+export declare const DEV_WORKSPACE_DOCTOR_USAGE: PluginUsage;
+/** Usage for `mj dev workspace clean` — the teardown. */
+export declare const DEV_WORKSPACE_CLEAN_USAGE: PluginUsage;
+/** Every dev-domain usage declaration, in the order `mj dev usage` should teach them. */
+export declare const DEV_DOMAIN_USAGE: readonly PluginUsage[];
+/** Declares the dev domain with the usage registry. Idempotent — safe to call repeatedly. */
+export declare function RegisterDevWorkspaceUsage(): void;
+//# sourceMappingURL=usage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/lib/dev-workspace/usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAmB/E,oDAAoD;AACpD,eAAO,MAAM,mBAAmB,EAAE,WAsDjC,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,0BAA0B,EAAE,WAmBxC,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,0BAA0B,EAAE,WA2BxC,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,yBAAyB,EAAE,WA2BvC,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,gBAAgB,EAAE,SAAS,WAAW,EAKlD,CAAC;AAEF,6FAA6F;AAC7F,wBAAgB,yBAAyB,IAAI,IAAI,CAIhD"}

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

@@ -0,0 +1,177 @@
+/**
+ * Progressive-disclosure usage metadata for the `dev` domain (`mj dev usage`).
+ *
+ * SIDE EFFECT ON IMPORT: {@link RegisterDevWorkspaceUsage} is called at the bottom
+ * of this module, so importing it declares the domain. `lib/cli-plugins.ts` imports
+ * it alongside the built-in plugin modules — the single funnel both `mj usage` and
+ * `mj <domain> usage` go through.
+ *
+ * Why declared here rather than as `static Usage` on a BaseCLIPlugin: the dev
+ * commands are plain oclif Commands that ship inside the CLI and must stay
+ * bootstrap-free (they are in LIGHT_COMMANDS), so they are not plugin-backed. The
+ * text below is the ONLY place an agent learns these rules before invoking, so it
+ * states them outright rather than pointing at the commands' help.
+ *
+ * @module lib/dev-workspace/usage
+ */
+import { CLIPluginRegistry } from '@memberjunction/cli-core';
+import { LOCKFILE_NAME, NODE_MODULES_NAME } from './clean.js';
+import { WORKSPACE_DIR_ENV_VAR } from './dir-flag.js';
+import { SENTINEL_FILE_NAME, WORKSPACE_FILE_NAMES } from './write.js';
+/** The parent-directory contract, stated once — every command's description ends with it. */
+const PARENT_DIR_RULE = `--dir must be the PLAIN directory that HOLDS the sibling repo clones, never a git repo root itself: a parent ` +
+    `carrying a .git entry (directory or worktree file) is refused. The member clones underneath it are of course ` +
+    `git repos — only the parent must not be. Defaults to the current directory, or $${WORKSPACE_DIR_ENV_VAR} when ` +
+    `set (an explicit --dir always wins over the environment).`;
+/** Shared `--dir` flag documentation. */
+const DIR_FLAG = {
+    name: '--dir',
+    type: 'string',
+    description: `Parent directory holding the sibling clones (default '.', or $${WORKSPACE_DIR_ENV_VAR}; must not be a git repo root)`,
+};
+/** Usage for `mj dev workspace` — the generator. */
+export const DEV_WORKSPACE_USAGE = {
+    domain: 'dev',
+    command: 'dev:workspace',
+    summary: 'Join sibling repo clones into one pnpm workspace at their common parent directory.',
+    description: `Writes ${WORKSPACE_FILE_NAMES.join(', ')} plus the ${SENTINEL_FILE_NAME} sentinel manifest at the parent, then ` +
+        `runs pnpm install there (disable with --no-install). Members are detected among the parent's immediate ` +
+        `subdirectories: a sibling qualifies when it has a root package.json AND any of (a) an mj-app.json marker, ` +
+        `(b) a package its workspace globs enumerate naming or depending on the @mj-biz-apps scope, (c) a root package ` +
+        `name of memberjunction-workspace (the MJ monorepo). Use --include to add a repo detection missed and --exclude ` +
+        `to drop one. Existing files are NEVER overwritten silently — the run refuses unless --force, which keeps a ` +
+        `<name>.bak copy of each. Workspace globs cover each member's repo root plus the packages-rooted globs of the ` +
+        `member's own pnpm-workspace.yaml (packages/* when it has none) — never apps/*, ` +
+        `because app-shell names collide across repos. The generated parent package.json ABSORBS what each member's own ` +
+        `config would otherwise lose at a workspace root: member pnpm.overrides/patchedDependencies/packageExtensions/` +
+        `peerDependencyRules are hoisted (patch paths re-rooted to <member>/...); every member-provided package name gets ` +
+        `a workspace:* override so local source always beats registry copies; and pnpm.overrides pins every direct ` +
+        `dependency of each member's importers (plus every @types/* at any depth) to the member's COMMITTED lockfile ` +
+        `resolution — EXACT versions, with per-major override selectors (name@^N) when the committed graphs hold more ` +
+        `than one major of a name — pure file derivation, no network (unsupported lockfile formats are warned about ` +
+        `per member, never a silent zero). @types/* ` +
+        `are excluded from the devDependency union (duplicate @types break nominal typing) and workspace: specifiers on ` +
+        `packages no member provides are dropped — every drop, conflict and skip is reported. Members carrying a ` +
+        `standalone install (root or nested node_modules, detected depth-independently) are offered cleanup before the ` +
+        `parent install (--clean-members / --no-clean-members for non-interactive runs); skipping leaves overlapping ` +
+        `stores that surface as dangling symlinks. Auth SDKs and @angular/service-worker are peerDependencies of ` +
+        `the MJ libraries that expose them: a shell serving those features declares its own picks in its own ` +
+        `package.json — the command prints that guidance instead of hoisting them. Light command: no MJ bootstrap, ` +
+        `no database. Generated files are ephemeral — never commit them; remove them with dev workspace clean. ` +
+        PARENT_DIR_RULE,
+    flags: [
+        DIR_FLAG,
+        { name: '--include', type: 'string (repeatable)', description: 'Repo directory name to add to the detected member set' },
+        { name: '--exclude', type: 'string (repeatable)', description: 'Repo directory name to drop from the member set' },
+        { name: '--no-install', type: 'boolean', description: 'Generate the files but skip pnpm install' },
+        { name: '--force', type: 'boolean', description: 'Overwrite existing generated files, keeping a .bak of each' },
+        {
+            name: '--clean-members / --no-clean-members',
+            type: 'boolean',
+            description: 'Remove (or keep) members\' standalone node_modules trees before installing; omit both to be asked interactively',
+        },
+        { name: '--verbose', type: 'boolean', description: 'Show detailed output (per-entry lockfile skips, superseded pins, skipped @types)' },
+    ],
+    examples: [
+        'mj dev workspace --dir ~/code/bluecypress',
+        'mj dev workspace --dir ~/code/bluecypress --no-install',
+        'mj dev workspace --dir ~/code/bluecypress --include bizapps-common --exclude bizapps-sonar',
+        `${WORKSPACE_DIR_ENV_VAR}=~/code/bluecypress mj dev workspace --force`,
+    ],
+    runtime: {
+        class: 'variable',
+        typicalSeconds: 90,
+        note: 'file generation is under a second; pnpm install dominates and scales with the members\' dependency graph (--no-install skips it)',
+    },
+};
+/** Usage for `mj dev workspace status` — the read-only report. */
+export const DEV_WORKSPACE_STATUS_USAGE = {
+    domain: 'dev',
+    command: 'dev:workspace:status',
+    summary: 'Report the state of a generated cross-repo workspace at a parent directory.',
+    description: `Read-only: writes nothing. Reports which generated files exist, whether ${LOCKFILE_NAME} and ` +
+        `${NODE_MODULES_NAME} are present, whether the ${SENTINEL_FILE_NAME} sentinel is there (proof the workspace ` +
+        `came from this generator, and what dev workspace clean requires), the members parsed from ` +
+        `pnpm-workspace.yaml versus the candidates detected on disk right now, which members are missing from disk, ` +
+        `how --dir was resolved (flag, environment, or default), and whether the active pnpm version matches the ` +
+        `generated pin. Run it before clean to see what a teardown would touch. Light command: no MJ bootstrap. ` +
+        PARENT_DIR_RULE,
+    flags: [DIR_FLAG],
+    examples: [
+        'mj dev workspace status',
+        'mj dev workspace status --dir ~/code/bluecypress',
+        `${WORKSPACE_DIR_ENV_VAR}=~/code/bluecypress mj dev workspace status`,
+    ],
+    runtime: { class: 'fast', typicalSeconds: 1, note: 'one `pnpm --version` probe plus directory reads' },
+};
+/** Usage for `mj dev workspace doctor` — the read-only health check. */
+export const DEV_WORKSPACE_DOCTOR_USAGE = {
+    domain: 'dev',
+    command: 'dev:workspace:doctor',
+    summary: 'Health-check a generated cross-repo workspace and exit non-zero on any failure.',
+    description: `Read-only: writes nothing, deletes nothing, no network. Prints one [PASS]/[WARN]/[FAIL]/[SKIP] line per check ` +
+        `and EXITS NON-ZERO when any check FAILS, so it can gate a script (status never exits non-zero — that is the ` +
+        `difference between the two). FAIL: the parent is itself a git repo root; a generated file is missing; a member ` +
+        `named in pnpm-workspace.yaml has no directory on disk (the parent manifest overrides that member's packages to ` +
+        `workspace:*, so pnpm install fails outright); a member carries a STANDALONE INSTALL — a member-root ` +
+        `${NODE_MODULES_NAME}/.pnpm store or npm .package-lock.json marker, NOT the plain ${NODE_MODULES_NAME} a healthy ` +
+        `parent install leaves inside every member; or the one-copy census finds more than one version of a package that ` +
+        `must be single-copy. WARN: not installed yet, no valid ${SENTINEL_FILE_NAME}, a pnpm pin/active mismatch, or a ` +
+        `detected repo that is not a workspace member. The one-copy census reads the DIRECTORY NAMES in the parent's ` +
+        `${NODE_MODULES_NAME}/.pnpm store (each already encodes name@version) and counts distinct versions of ` +
+        `@angular/core, @angular/common, @angular/compiler, rxjs, zone.js, @memberjunction/core and ` +
+        `@memberjunction/global — two copies of any of them is a second, mutually invisible runtime (Angular DI throws ` +
+        `NG0203; two Global Object Stores make every BaseSingleton two singletons), which is why it is a FAIL and not a ` +
+        `warning. Packages absent from the store are skipped, not failed. Light command: no MJ bootstrap. ` +
+        PARENT_DIR_RULE,
+    flags: [DIR_FLAG],
+    examples: [
+        'mj dev workspace doctor',
+        'mj dev workspace doctor --dir ~/code/bluecypress',
+        `${WORKSPACE_DIR_ENV_VAR}=~/code/bluecypress mj dev workspace doctor`,
+    ],
+    runtime: { class: 'fast', typicalSeconds: 1, note: 'one `pnpm --version` probe, directory reads, and one listing of the parent store' },
+};
+/** Usage for `mj dev workspace clean` — the teardown. */
+export const DEV_WORKSPACE_CLEAN_USAGE = {
+    domain: 'dev',
+    command: 'dev:workspace:clean',
+    summary: 'Remove the generated workspace files, lockfile and node_modules at a parent directory.',
+    description: `Deletes exactly what the generator owns — ${WORKSPACE_FILE_NAMES.join(', ')}, ${LOCKFILE_NAME}, the ` +
+        `${NODE_MODULES_NAME} tree, and ${SENTINEL_FILE_NAME} last — and nothing else: member repo checkouts and any ` +
+        `.bak backups are left alone and reported. Without --force a valid ${SENTINEL_FILE_NAME} must be present, so ` +
+        `clean refuses to tear down a workspace it cannot prove it generated (hand-made or pre-sentinel ones need ` +
+        `--force). Use --dry-run first: it lists the paths that exist and exits 0 without deleting, and combines with ` +
+        `--force to preview a sentinel-less parent. Paths already gone are reported, not errors, so a repeat run is ` +
+        `safe. Light command: no MJ bootstrap. ` + PARENT_DIR_RULE,
+    flags: [
+        DIR_FLAG,
+        { name: '--dry-run', type: 'boolean', description: 'List what would be removed and exit without deleting' },
+        { name: '--force', type: 'boolean', description: `Clean even without a valid ${SENTINEL_FILE_NAME} sentinel` },
+    ],
+    examples: [
+        'mj dev workspace clean --dir ~/code/bluecypress --dry-run',
+        'mj dev workspace clean --dir ~/code/bluecypress',
+        'mj dev workspace clean --dir ~/code/bluecypress --dry-run --force',
+    ],
+    runtime: {
+        class: 'moderate',
+        typicalSeconds: 10,
+        note: `removing the ${NODE_MODULES_NAME} tree dominates; --dry-run is instant`,
+    },
+};
+/** Every dev-domain usage declaration, in the order `mj dev usage` should teach them. */
+export const DEV_DOMAIN_USAGE = [
+    DEV_WORKSPACE_USAGE,
+    DEV_WORKSPACE_STATUS_USAGE,
+    DEV_WORKSPACE_DOCTOR_USAGE,
+    DEV_WORKSPACE_CLEAN_USAGE,
+];
+/** Declares the dev domain with the usage registry. Idempotent — safe to call repeatedly. */
+export function RegisterDevWorkspaceUsage() {
+    for (const usage of DEV_DOMAIN_USAGE) {
+        CLIPluginRegistry.RegisterUsage(usage);
+    }
+}
+RegisterDevWorkspaceUsage();
+//# sourceMappingURL=usage.js.map

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

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

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

@@ -0,0 +1,25 @@
+import type { GeneratedFile, WriteResult } from './types.js';
+/** The four workspace files `mj dev workspace` owns at the parent directory. */
+export declare const WORKSPACE_FILE_NAMES: readonly string[];
+/**
+ * The sentinel manifest, written through this module like any other generated
+ * file (so the never-overwrite-silently rule covers it too). Its presence is what
+ * lets `mj dev workspace clean` prove the residue at a parent is its own.
+ */
+export declare const SENTINEL_FILE_NAME = ".mj-dev-workspace.json";
+/** Every file `mj dev workspace` writes at the parent: the four plus the sentinel. */
+export declare const GENERATED_FILE_NAMES: readonly string[];
+/**
+ * Throws unless the parent directory is a plain directory that is NOT a git repo
+ * root (`.git` may be a directory or a worktree file — both disqualify).
+ */
+export declare function AssertParentDirSafe(parentDir: string): void;
+/** Names among the generated files that already exist at the parent. */
+export declare function FindExistingFiles(parentDir: string, fileNames: readonly string[]): string[];
+/**
+ * Writes the generated files at the parent directory.
+ * Without `force`, refuses (throws) if ANY of the files already exists.
+ * With `force`, each existing file is first copied to `<name>.bak`.
+ */
+export declare function WriteWorkspaceFiles(parentDir: string, files: readonly GeneratedFile[], force: boolean): WriteResult;
+//# sourceMappingURL=write.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../src/lib/dev-workspace/write.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7D,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAKjD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,2BAA2B,CAAC;AAE3D,sFAAsF;AACtF,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAkD,CAAC;AAErG;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAa3D;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAE3F;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,aAAa,EAAE,EAAE,KAAK,EAAE,OAAO,GAAG,WAAW,CAqBnH"}

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

@@ -0,0 +1,75 @@
+/**
+ * File writing (and the safety gates around it) for `mj dev workspace`.
+ *
+ * SIDE EFFECTS: writes the generated files at the parent directory. Two hard
+ * safety rules, both from the program brief:
+ *  1. NEVER overwrite an existing parent file silently — refuse with a clear
+ *     message unless forced, and when forced save a `<name>.bak` copy first.
+ *  2. Refuse to operate when the parent directory is itself a git repo root —
+ *     the workspace parent must be a plain directory holding sibling clones.
+ *
+ * @module lib/dev-workspace/write
+ */
+import { copyFileSync, existsSync, statSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+/** The four workspace files `mj dev workspace` owns at the parent directory. */
+export const WORKSPACE_FILE_NAMES = [
+    'pnpm-workspace.yaml',
+    '.npmrc',
+    'package.json',
+    'turbo.json',
+];
+/**
+ * The sentinel manifest, written through this module like any other generated
+ * file (so the never-overwrite-silently rule covers it too). Its presence is what
+ * lets `mj dev workspace clean` prove the residue at a parent is its own.
+ */
+export const SENTINEL_FILE_NAME = '.mj-dev-workspace.json';
+/** Every file `mj dev workspace` writes at the parent: the four plus the sentinel. */
+export const GENERATED_FILE_NAMES = [...WORKSPACE_FILE_NAMES, SENTINEL_FILE_NAME];
+/**
+ * Throws unless the parent directory is a plain directory that is NOT a git repo
+ * root (`.git` may be a directory or a worktree file — both disqualify).
+ */
+export function AssertParentDirSafe(parentDir) {
+    if (!path.isAbsolute(parentDir)) {
+        throw new Error(`Parent directory must be an absolute path, got: ${parentDir}`);
+    }
+    if (!existsSync(parentDir) || !statSync(parentDir).isDirectory()) {
+        throw new Error(`Parent directory does not exist or is not a directory: ${parentDir}`);
+    }
+    if (existsSync(path.join(parentDir, '.git'))) {
+        throw new Error(`${parentDir} looks like a git repo root (.git present). The workspace parent must be the plain ` +
+            `directory that HOLDS your sibling clones — run again with --dir pointing at the repos' common parent.`);
+    }
+}
+/** Names among the generated files that already exist at the parent. */
+export function FindExistingFiles(parentDir, fileNames) {
+    return fileNames.filter((name) => existsSync(path.join(parentDir, name)));
+}
+/**
+ * Writes the generated files at the parent directory.
+ * Without `force`, refuses (throws) if ANY of the files already exists.
+ * With `force`, each existing file is first copied to `<name>.bak`.
+ */
+export function WriteWorkspaceFiles(parentDir, files, force) {
+    AssertParentDirSafe(parentDir);
+    const existing = FindExistingFiles(parentDir, files.map((f) => f.Name));
+    if (existing.length > 0 && !force) {
+        throw new Error(`Refusing to overwrite existing file(s) at ${parentDir}: ${existing.join(', ')}. ` +
+            `Re-run with --force to overwrite (a .bak copy of each will be kept).`);
+    }
+    const backedUp = [];
+    for (const name of existing) {
+        const target = path.join(parentDir, name);
+        copyFileSync(target, `${target}.bak`);
+        backedUp.push(`${name}.bak`);
+    }
+    const written = [];
+    for (const file of files) {
+        writeFileSync(path.join(parentDir, file.Name), file.Content, 'utf8');
+        written.push(file.Name);
+    }
+    return { Written: written, BackedUp: backedUp };
+}
+//# sourceMappingURL=write.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../../src/lib/dev-workspace/write.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC5E,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,gFAAgF;AAChF,MAAM,CAAC,MAAM,oBAAoB,GAAsB;IACrD,qBAAqB;IACrB,QAAQ;IACR,cAAc;IACd,YAAY;CACb,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,wBAAwB,CAAC;AAE3D,sFAAsF;AACtF,MAAM,CAAC,MAAM,oBAAoB,GAAsB,CAAC,GAAG,oBAAoB,EAAE,kBAAkB,CAAC,CAAC;AAErG;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,mDAAmD,SAAS,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,0DAA0D,SAAS,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACb,GAAG,SAAS,qFAAqF;YAC/F,uGAAuG,CAC1G,CAAC;IACJ,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,SAA4B;IAC/E,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAE,KAA+B,EAAE,KAAc;IACpG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACxE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,6CAA6C,SAAS,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAChF,sEAAsE,CACzE,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC1C,YAAY,CAAC,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,CAAC;QACtC,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC;IAC/B,CAAC;IACD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAClD,CAAC"}

package/dist/light-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"light-commands.d.ts","sourceRoot":"","sources":["../src/light-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CA4D7C,CAAC"}
+{"version":3,"file":"light-commands.d.ts","sourceRoot":"","sources":["../src/light-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CAoE7C,CAAC"}

package/dist/light-commands.js

@@ -22,6 +22,7 @@ export const LIGHT_COMMANDS = new Set([
     'usage',
     'sync usage',
     'codegen usage',
+    'dev usage',
     // Plugin registry editing — just writes mj-cli-plugins.json
     'plugin add',
     // Bump - uses zod, fast-glob, fs only
@@ -42,6 +43,12 @@ export const LIGHT_COMMANDS = new Set([
     'ai audit',
     'test',
     'dbdoc',
+    'dev',
+    // Dev workspace generator - node stdlib + chalk only, no bootstrap
+    'dev workspace',
+    'dev workspace status',
+    'dev workspace doctor',
+    'dev workspace clean',
     // SQL conversion commands - use @memberjunction/sql-converter + sqlglot-ts only
     'sql-convert',
     'sql-audit',

package/dist/light-commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"light-commands.js","sourceRoot":"","sources":["../src/light-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC;IACzD,yBAAyB;IACzB,SAAS;IACT,MAAM;IAEN,0EAA0E;IAC1E,qEAAqE;IACrE,OAAO;IACP,YAAY;IACZ,eAAe;IAEf,4DAA4D;IAC5D,YAAY;IAEZ,sCAAsC;IACtC,MAAM;IAEN,oEAAoE;IACpE,OAAO;IACP,SAAS;IACT,iBAAiB;IACjB,gBAAgB;IAEhB,qFAAqF;IACrF,SAAS;IAET,6EAA6E;IAC7E,QAAQ;IAER,4FAA4F;IAC5F,QAAQ;IAER,kEAAkE;IAClE,IAAI;IACJ,UAAU;IACV,MAAM;IACN,OAAO;IAEP,gFAAgF;IAChF,aAAa;IACb,WAAW;IAEX,8EAA8E;IAC9E,oCAAoC;IACpC,gBAAgB;IAChB,eAAe;IAEf,kGAAkG;IAClG,yFAAyF;IACzF,+FAA+F;IAC/F,kBAAkB;IAElB,0DAA0D;IAC1D,YAAY;IACZ,eAAe;IACf,cAAc;IACd,6BAA6B;IAC7B,wBAAwB;IACxB,aAAa;IACb,cAAc;CACf,CAAC,CAAC"}
+{"version":3,"file":"light-commands.js","sourceRoot":"","sources":["../src/light-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC;IACzD,yBAAyB;IACzB,SAAS;IACT,MAAM;IAEN,0EAA0E;IAC1E,qEAAqE;IACrE,OAAO;IACP,YAAY;IACZ,eAAe;IACf,WAAW;IAEX,4DAA4D;IAC5D,YAAY;IAEZ,sCAAsC;IACtC,MAAM;IAEN,oEAAoE;IACpE,OAAO;IACP,SAAS;IACT,iBAAiB;IACjB,gBAAgB;IAEhB,qFAAqF;IACrF,SAAS;IAET,6EAA6E;IAC7E,QAAQ;IAER,4FAA4F;IAC5F,QAAQ;IAER,kEAAkE;IAClE,IAAI;IACJ,UAAU;IACV,MAAM;IACN,OAAO;IACP,KAAK;IAEL,mEAAmE;IACnE,eAAe;IACf,sBAAsB;IACtB,sBAAsB;IACtB,qBAAqB;IAErB,gFAAgF;IAChF,aAAa;IACb,WAAW;IAEX,8EAA8E;IAC9E,oCAAoC;IACpC,gBAAgB;IAChB,eAAe;IAEf,kGAAkG;IAClG,yFAAyF;IACzF,+FAA+F;IAC/F,kBAAkB;IAElB,0DAA0D;IAC1D,YAAY;IACZ,eAAe;IACf,cAAc;IACd,6BAA6B;IAC7B,wBAAwB;IACxB,aAAa;IACb,cAAc;CACf,CAAC,CAAC"}