@smoothbricks/cli 0.1.0 → 0.2.0

package/dist/cli.js

@@ -1,4 +1,5 @@
 import { Command, CommanderError } from 'commander';
+import { cliPackageVersion } from './lib/cli-package.js';
 import { findRepoRoot } from './lib/run.js';
 export async function runCli(argv = process.argv.slice(2)) {
     const program = buildProgram();
@@ -19,7 +20,12 @@ export async function runCli(argv = process.argv.slice(2)) {
 }
 function buildProgram() {
     const program = new Command();
-    program.name('smoo').description('SmoothBricks monorepo tooling').exitOverride().showHelpAfterError();
+    program
+        .name('smoo')
+        .description('SmoothBricks monorepo tooling')
+        .version(cliPackageVersion, '-v, --version', 'print smoo version')
+        .exitOverride()
+        .showHelpAfterError();
     const monorepo = program.command('monorepo').description('Manage SmoothBricks-style monorepos');
     monorepo
         .command('init')
@@ -31,7 +37,10 @@ function buildProgram() {
     });
     monorepo
         .command('validate')
+        .option('--fix', 'apply safe monorepo policy fixes before validation')
         .option('--fail-fast', 'stop after the first failing validation pack')
+        .option('--only-if-new-workspace-package', 'skip validation unless a new workspace package manifest is staged')
+        .option('--verbose', 'print validation progress and successful checks')
         .action(async (options) => {
         const { validateMonorepo } = await import('./monorepo/index.js');
         await validateMonorepo(await findRepoRoot(), options);
@@ -48,70 +57,175 @@ function buildProgram() {
         const { diffManagedFiles } = await import('./monorepo/index.js');
         diffManagedFiles(await findRepoRoot());
     });
-    monorepo.command('validate-commit-msg <commitMsgFile>').action(async (commitMsgFile) => {
+    monorepo
+        .command('validate-commit-msg <commitMsgFile>')
+        .option('--fix', 'format the commit message before validation')
+        .action(async (commitMsgFile, options) => {
         const { validateCommitMessageFile } = await import('./monorepo/index.js');
-        validateCommitMessageFile(commitMsgFile);
+        validateCommitMessageFile(commitMsgFile, options, await findRepoRoot());
     });
     monorepo.command('sync-bun-lockfile-versions').action(async () => {
         const { syncBunLockfileVersions } = await import('./monorepo/index.js');
         syncBunLockfileVersions(await findRepoRoot());
     });
-    monorepo.command('list-public-projects').action(async () => {
-        const { listPublicProjects } = await import('./monorepo/index.js');
-        console.log(listPublicProjects(await findRepoRoot()));
+    monorepo
+        .command('list-release-packages')
+        .option('--fail-empty', 'fail when no owned release packages are found')
+        .option('--github-output <path>', 'append projects=<nx-projects> to a GitHub Actions output file')
+        .action(async (options) => {
+        const { listReleaseProjectNamesForNx } = await import('./monorepo/index.js');
+        const packages = listReleaseProjectNamesForNx(await findRepoRoot(), options);
+        if (!options.githubOutput) {
+            console.log(packages);
+        }
     });
     monorepo.command('validate-public-tags').action(async () => {
         const { validatePublicPackageTags } = await import('./monorepo/index.js');
         validatePublicPackageTags(await findRepoRoot());
     });
-    monorepo.command('release-state').action(async () => {
+    monorepo
+        .command('setup-test-tracing')
+        .description('Configure LMAO Bun test tracing for workspace packages')
+        .option('--all', 'configure every workspace package')
+        .option('--projects <projects>', 'comma-separated Nx project names, package names, or package roots')
+        .option('--op-context-export <exportName>', 'named op context export imported by test-suite-tracer', 'opContext')
+        .option('--tracer-module <module>', 'module specifier that exports defineTestTracer', '@smoothbricks/lmao/testing/bun')
+        .option('--dry-run', 'print generator invocations without writing files')
+        .action(async (options) => {
+        const { setupTestTracing } = await import('./monorepo/index.js');
+        await setupTestTracing(await findRepoRoot(), options);
+    });
+    const release = program.command('release').description('Version, publish, and create GitHub Releases');
+    release.command('npm-status').action(async () => {
         const { printReleaseState } = await import('./release/index.js');
         await printReleaseState(await findRepoRoot());
     });
-    const release = program.command('release').description('Version, publish, and create GitHub Releases');
+    release
+        .command('repair-pending')
+        .description('Repair incomplete older release commits before releasing the current HEAD')
+        .option('--dry-run [dryRun]', 'run without pushing, publishing, or writing GitHub Releases')
+        .action(async (options) => {
+        const { releaseRepairPending } = await import('./release/index.js');
+        await releaseRepairPending(await findRepoRoot(), { ...options, dryRun: booleanOption(options.dryRun) });
+    });
     release
         .command('version')
         .option('--bump <bump>', 'auto, patch, minor, major, or prerelease', 'auto')
-        .option('--dry-run [dryRun]', 'run without writing versions, tags, or pushes')
+        .option('--dry-run [dryRun]', 'run without writing versions or tags')
+        .option('--github-output <path>', 'append mode=<mode> and projects=<nx-projects> to a GitHub Actions output file')
         .action(async (options) => {
         const { releaseVersion } = await import('./release/index.js');
-        await releaseVersion(await findRepoRoot(), { bump: options.bump, dryRun: booleanOption(options.dryRun) });
+        await releaseVersion(await findRepoRoot(), {
+            bump: options.bump,
+            dryRun: booleanOption(options.dryRun),
+            githubOutput: options.githubOutput,
+        });
     });
     release
         .command('publish')
         .option('--bump <bump>', 'auto, patch, minor, major, or prerelease', 'auto')
-        .option('--tag <tag>', 'explicit npm dist-tag; must match bump-derived tag')
-        .option('--npm-tag <npmTag>', 'explicit npm dist-tag; must match bump-derived tag')
-        .option('--dry-run [dryRun]', 'run without publishing')
+        .option('--dry-run [dryRun]', 'run without pushing, publishing, or writing GitHub Releases')
         .action(async (options) => {
         const { releasePublish } = await import('./release/index.js');
         await releasePublish(await findRepoRoot(), { ...options, dryRun: booleanOption(options.dryRun) });
     });
     release
-        .command('github-release')
-        .option('--tags <tags>', 'space-separated release tags')
-        .option('--bump <bump>', 'auto, patch, minor, major, or prerelease', 'auto')
-        .option('--tag <tag>', 'explicit npm dist-tag; must match bump-derived tag')
-        .option('--npm-tag <npmTag>', 'explicit npm dist-tag; must match bump-derived tag')
-        .option('--dry-run [dryRun]', 'skip GitHub Release writes')
+        .command('retag-unpublished')
+        .description('Move unpublished owned release tags to a later commit without bumping versions')
+        .argument('<tag...>', 'owned release tags to move, for example @scope/pkg@1.2.3')
+        .option('--to <ref>', 'commit or ref to move tags to', 'HEAD')
+        .option('--push', 'push moved tags with force-with-lease')
+        .option('--dispatch', 'push moved tags and start publish.yml with bump=auto')
+        .option('--remote <remote>', 'git remote used for pushed tags')
+        .option('--branch <branch>', 'branch used for publish workflow dispatch')
+        .option('--dry-run [dryRun]', 'validate and print the retag operation without mutating refs')
+        .action(async (tags, options) => {
+        const { releaseRetagUnpublished } = await import('./release/index.js');
+        await releaseRetagUnpublished(await findRepoRoot(), {
+            tags,
+            to: options.to,
+            push: options.push === true,
+            dispatch: options.dispatch === true,
+            remote: options.remote,
+            branch: options.branch,
+            dryRun: booleanOption(options.dryRun),
+        });
+    });
+    release
+        .command('bootstrap-npm-packages')
+        .alias('bootstrap')
+        .description('Publish minimal npm placeholder packages so trusted publishing can be configured')
+        .option('--dry-run [dryRun]', 'show placeholder publishes without logging in or publishing')
+        .option('--skip-login', 'skip npm browser login before publishing placeholders')
+        .option('--otp <otp>', 'npm one-time password for placeholder publish operations')
+        .option('--package <name...>', 'only bootstrap the selected owned release package names')
         .action(async (options) => {
-        const { releaseGithubRelease } = await import('./release/index.js');
-        await releaseGithubRelease(await findRepoRoot(), { ...options, dryRun: booleanOption(options.dryRun) });
+        const { releaseBootstrapNpmPackages } = await import('./release/index.js');
+        await releaseBootstrapNpmPackages(await findRepoRoot(), {
+            dryRun: booleanOption(options.dryRun),
+            skipLogin: options.skipLogin === true,
+            otp: options.otp,
+            packages: options.package ?? [],
+        });
     });
     release
         .command('trust-publisher')
-        .description('Configure npm trusted publishing for public packages')
+        .description('Configure npm trusted publishing for owned release packages')
         .option('--dry-run [dryRun]', 'show npm trust changes without saving them')
+        .option('--bootstrap', 'publish missing npm placeholder packages before configuring trust')
         .option('--otp <otp>', 'npm one-time password for trust operations')
+        .option('--bootstrap-otp <otp>', 'npm one-time password for placeholder publishes during --bootstrap')
         .option('--skip-login', 'skip npm browser login before configuring trust')
         .action(async (options) => {
         const { releaseTrustPublisher } = await import('./release/index.js');
         await releaseTrustPublisher(await findRepoRoot(), {
             dryRun: booleanOption(options.dryRun),
+            bootstrap: options.bootstrap === true,
             otp: options.otp,
+            bootstrapOtp: options.bootstrapOtp,
             skipLogin: options.skipLogin === true,
         });
     });
+    const devenv = program.command('devenv').description('Manage the repository devenv shell');
+    devenv.command('update').action(async () => {
+        const { updateDevenv } = await import('./devenv/index.js');
+        await updateDevenv(await findRepoRoot());
+    });
+    devenv.command('reload').action(async () => {
+        const { reloadDevenv } = await import('./devenv/index.js');
+        await reloadDevenv(await findRepoRoot());
+    });
+    const nixpkgsOverlay = program.command('nixpkgs-overlay').description('Manage the repository nixpkgs overlay');
+    nixpkgsOverlay.command('update').action(async () => {
+        const { updateNixpkgsOverlay } = await import('./devenv/index.js');
+        await updateNixpkgsOverlay(await findRepoRoot());
+    });
+    const nx = program.command('nx').description('Nx workspace helpers');
+    nx.command('list-targets')
+        .description('List project:target entries for every Nx project')
+        .action(async () => {
+        const { listTargets } = await import('./nx/index.js');
+        await listTargets(await findRepoRoot());
+    });
+    nx.command('list-projects')
+        .description('List Nx projects matching filters')
+        .requiredOption('--with-target <target>', 'only include projects defining this target')
+        .action(async (options) => {
+        const { listProjects } = await import('./nx/index.js');
+        await listProjects(await findRepoRoot(), options);
+    });
+    nx.command('reset-cache')
+        .description('Run nx reset to clear Nx daemon and cache state')
+        .action(async () => {
+        const { resetCache } = await import('./nx/index.js');
+        await resetCache(await findRepoRoot());
+    });
+    nx.command('clean-cache')
+        .description('Remove local Nx cache directories when present')
+        .action(async () => {
+        const { cleanCache } = await import('./nx/index.js');
+        await cleanCache(await findRepoRoot());
+    });
     const githubCi = program.command('github-ci').description('GitHub Actions helpers');
     githubCi.command('cleanup-cache').action(async () => {
         const { cleanupGithubCiCache } = await import('./github-ci/index.js');

package/dist/devenv/index.d.ts

@@ -0,0 +1,10 @@
+export interface DevenvCommandShell {
+    run(command: string, args: string[], cwd: string): Promise<void>;
+    remove(path: string): Promise<void>;
+}
+export declare function updateDevenv(root: string, shell?: DevenvCommandShell): Promise<void>;
+export declare function reloadDevenv(root: string, shell?: DevenvCommandShell): Promise<void>;
+export declare function updateNixpkgsOverlay(root: string, shell?: DevenvCommandShell): Promise<void>;
+export declare function direnvRoot(root: string): string;
+export declare function nixpkgsOverlayRoot(root: string): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/devenv/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/devenv/index.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AASD,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,kBAAiC,GAAG,OAAO,CAAC,IAAI,CAAC,CAExG;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,kBAAiC,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxG;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,kBAAiC,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhH;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/devenv/index.js

@@ -0,0 +1,27 @@
+import { rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { run } from '../lib/run.js';
+const defaultShell = {
+    run,
+    async remove(path) {
+        await rm(path, { recursive: true, force: true });
+    },
+};
+export async function updateDevenv(root, shell = defaultShell) {
+    await shell.run('devenv', ['update'], direnvRoot(root));
+}
+export async function reloadDevenv(root, shell = defaultShell) {
+    const cwd = direnvRoot(root);
+    await shell.remove(join(cwd, '.direnv'));
+    await shell.remove(join(cwd, '.devenv'));
+    await shell.run('direnv', ['reload'], cwd);
+}
+export async function updateNixpkgsOverlay(root, shell = defaultShell) {
+    await shell.run('nix', ['shell', 'nixpkgs#nvfetcher', '-c', 'nvfetcher', '-o', '_sources'], nixpkgsOverlayRoot(root));
+}
+export function direnvRoot(root) {
+    return join(root, 'tooling', 'direnv');
+}
+export function nixpkgsOverlayRoot(root) {
+    return join(direnvRoot(root), 'nixpkgs-overlay');
+}

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

@@ -0,0 +1,4 @@
+export declare const smoothBricksCodebasePackageName = "@smoothbricks/codebase";
+export declare const cliPackageVersion: string;
+export declare function isSmoothBricksCodebasePackageName(name: string | undefined): boolean;
+//# sourceMappingURL=cli-package.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-package.d.ts","sourceRoot":"","sources":["../../src/lib/cli-package.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,+BAA+B,2BAA2B,CAAC;AACxE,eAAO,MAAM,iBAAiB,QAA0B,CAAC;AAWzD,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEnF"}

package/dist/lib/cli-package.js

@@ -0,0 +1,15 @@
+import { fileURLToPath } from 'node:url';
+import { readJsonObject, stringProperty } from './json.js';
+export const smoothBricksCodebasePackageName = '@smoothbricks/codebase';
+export const cliPackageVersion = readCliPackageVersion();
+function readCliPackageVersion() {
+    const pkg = readJsonObject(fileURLToPath(new URL('../../package.json', import.meta.url)));
+    const version = pkg ? stringProperty(pkg, 'version') : null;
+    if (!version) {
+        throw new Error('Unable to read @smoothbricks/cli package version.');
+    }
+    return version;
+}
+export function isSmoothBricksCodebasePackageName(name) {
+    return name === smoothBricksCodebasePackageName;
+}

package/dist/lib/devenv.d.ts

@@ -0,0 +1,6 @@
+type EnvSnapshot = Record<string, string>;
+export declare function withDevenvEnv<T>(root: string, runWithEnv: () => Promise<T>): Promise<T>;
+export declare function parseNulEnv(bytes: Uint8Array): EnvSnapshot;
+export declare function mergeDevenvEnv(baseEnv: EnvSnapshot, devenvEnv: EnvSnapshot): EnvSnapshot;
+export {};
+//# sourceMappingURL=devenv.d.ts.map

package/dist/lib/devenv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devenv.d.ts","sourceRoot":"","sources":["../../src/lib/devenv.ts"],"names":[],"mappings":"AAMA,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE1C,wBAAsB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAS7F;AAmBD,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CAoB1D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,GAAG,WAAW,CAExF"}

package/dist/lib/devenv.js

@@ -0,0 +1,82 @@
+import { mkdtemp, readFile, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { $ } from 'bun';
+import { decode } from './run.js';
+export async function withDevenvEnv(root, runWithEnv) {
+    const snapshot = snapshotProcessEnv();
+    const env = await loadDevenvEnv(root);
+    replaceProcessEnv(mergeDevenvEnv(snapshot, env));
+    try {
+        return await runWithEnv();
+    }
+    finally {
+        restoreProcessEnv(snapshot);
+    }
+}
+async function loadDevenvEnv(root) {
+    const tempDir = await mkdtemp(join(tmpdir(), 'smoo-devenv-env-'));
+    const envPath = join(tempDir, 'env');
+    try {
+        const result = await $ `devenv shell -- bash -lc ${'env -0 > "$1"'} bash ${envPath}`
+            .cwd(join(root, 'tooling', 'direnv'))
+            .quiet()
+            .nothrow();
+        if (result.exitCode !== 0) {
+            throw new Error('devenv shell failed. Ensure devenv is installed and the tooling/direnv shell is valid.');
+        }
+        return parseNulEnv(await readFile(envPath));
+    }
+    finally {
+        await rm(tempDir, { recursive: true, force: true });
+    }
+}
+export function parseNulEnv(bytes) {
+    const env = {};
+    let entryStart = 0;
+    for (let index = 0; index <= bytes.length; index += 1) {
+        if (index !== bytes.length && bytes[index] !== 0) {
+            continue;
+        }
+        if (index === entryStart) {
+            entryStart = index + 1;
+            continue;
+        }
+        const entry = decode(bytes.subarray(entryStart, index));
+        const separator = entry.indexOf('=');
+        if (separator <= 0) {
+            throw new Error('devenv shell produced an invalid environment entry.');
+        }
+        env[entry.slice(0, separator)] = entry.slice(separator + 1);
+        entryStart = index + 1;
+    }
+    return env;
+}
+export function mergeDevenvEnv(baseEnv, devenvEnv) {
+    return { ...baseEnv, ...devenvEnv };
+}
+function snapshotProcessEnv() {
+    const snapshot = {};
+    for (const [key, value] of Object.entries(process.env)) {
+        if (value !== undefined) {
+            snapshot[key] = value;
+        }
+    }
+    return snapshot;
+}
+function replaceProcessEnv(env) {
+    for (const key of Object.keys(process.env)) {
+        delete process.env[key];
+    }
+    for (const [key, value] of Object.entries(env)) {
+        process.env[key] = value;
+    }
+}
+function restoreProcessEnv(snapshot) {
+    for (const key of Object.keys(process.env)) {
+        delete process.env[key];
+    }
+    for (const [key, value] of Object.entries(snapshot)) {
+        process.env[key] = value;
+    }
+}

package/dist/lib/run.d.ts

@@ -1,5 +1,10 @@
 export declare function run(command: string, args: string[], cwd: string, env?: Record<string, string>): Promise<void>;
 export declare function runStatus(command: string, args: string[], cwd: string, quiet?: boolean, env?: Record<string, string>): Promise<number>;
+export declare function runResult(command: string, args: string[], cwd: string, env?: Record<string, string>): Promise<{
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}>;
 export declare function findRepoRoot(): Promise<string>;
 export declare function decode(bytes: Uint8Array): string;
 //# sourceMappingURL=run.d.ts.map

package/dist/lib/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/lib/run.ts"],"names":[],"mappings":"AAKA,wBAAsB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAKnH;AAED,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,KAAK,UAAQ,EACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,OAAO,CAAC,MAAM,CAAC,CAQjB;AAuCD,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAMpD;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEhD"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/lib/run.ts"],"names":[],"mappings":"AAKA,wBAAsB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAKnH;AAED,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,KAAK,UAAQ,EACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAY/D;AAuCD,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAMpD;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEhD"}

package/dist/lib/run.js

@@ -17,6 +17,19 @@ export async function runStatus(command, args, cwd, quiet = false, env) {
     const result = quiet ? await shell.quiet() : await shell;
     return result.exitCode;
 }
+export async function runResult(command, args, cwd, env) {
+    const invocation = resolveCommandInvocation(cwd, command, args);
+    let shell = $ `${invocation.command} ${invocation.args}`.cwd(cwd).nothrow().quiet();
+    if (env) {
+        shell = shell.env(mergeEnv(env));
+    }
+    const result = await shell;
+    return {
+        exitCode: result.exitCode,
+        stdout: decode(result.stdout),
+        stderr: decode(result.stderr),
+    };
+}
 function mergeEnv(env) {
     const merged = {};
     for (const [key, value] of Object.entries(process.env)) {

package/dist/lib/workspace.d.ts

@@ -1,5 +1,6 @@
 export interface PackageInfo {
     name: string;
+    projectName: string;
     version: string;
     private: boolean;
     tags: string[];
@@ -7,17 +8,35 @@ export interface PackageInfo {
     packageJsonPath: string;
     json: Record<string, unknown>;
 }
+export interface PackageJson extends Record<string, unknown> {
+    name?: string;
+    version?: string;
+    private?: boolean;
+    workspaces?: unknown;
+    devDependencies?: unknown;
+    dependencies?: unknown;
+    nx?: unknown;
+    repository?: unknown;
+}
 export interface RepositoryInfo {
     type: string;
     url: string;
 }
-export declare const workspaceDependencyFields: readonly ["dependencies", "devDependencies", "optionalDependencies"];
+export declare const workspaceDependencyFields: readonly ["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"];
 export declare function listPublicPackages(root: string): PackageInfo[];
+export declare function listReleasePackages(root: string, rootPackage?: PackageInfo | null): PackageInfo[];
+export declare function rootRepositoryInfo(root: string): RepositoryInfo | null;
+export declare function rootPackageName(root: string): string | null;
+export declare function isSmoothBricksCodebase(root: string): boolean;
+export declare function packageRepositoryInfo(pkg: PackageInfo): RepositoryInfo | null;
+export declare function isOwnedPackage(rootRepository: RepositoryInfo, pkg: PackageInfo): boolean;
 export declare function getWorkspacePackages(root: string): PackageInfo[];
 export declare function listPackageJsonRecords(root: string): PackageInfo[];
 export declare function getWorkspacePatterns(root: string): string[];
 export declare function readPackageJson(path: string): PackageInfo | null;
+export declare function readPackageJsonObject(path: string): PackageJson | null;
 export declare function getNxTags(pkg: Record<string, unknown>): string[];
 export declare function repositoryInfo(pkg: Record<string, unknown>): RepositoryInfo | null;
+export declare function sameRepositoryAfterNormalization(left: string, right: string): boolean;
 export declare function escapeRegex(value: string): string;
 //# sourceMappingURL=workspace.d.ts.map

package/dist/lib/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/lib/workspace.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,eAAO,MAAM,yBAAyB,sEAAuE,CAAC;AAE9G,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAE9D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAgChE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAMlE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAa3D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAgBhE;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAKhE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,GAAG,IAAI,CAalF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/lib/workspace.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,WAAY,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,eAAO,MAAM,yBAAyB,0FAK5B,CAAC;AAEX,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAE9D;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,WAAW,qBAA8C,GACxD,WAAW,EAAE,CAWf;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAGtE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG3D;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,WAAW,GAAG,cAAc,GAAG,IAAI,CAE7E;AAED,wBAAgB,cAAc,CAAC,cAAc,EAAE,cAAc,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAGxF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAMhE;AAiCD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CASlE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAG3D;AAgBD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAiBhE;AAOD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAGtE;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAKhE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,GAAG,IAAI,CAalF;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAErF;AA4BD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/lib/workspace.js

@@ -1,15 +1,52 @@
 import { readdirSync, statSync } from 'node:fs';
 import { dirname, join, relative } from 'node:path';
+import { isSmoothBricksCodebasePackageName } from './cli-package.js';
 import { hasOwn, hasOwnString, isRecord, readJson, readJsonObject, stringProperty } from './json.js';
-export const workspaceDependencyFields = ['dependencies', 'devDependencies', 'optionalDependencies'];
+export const workspaceDependencyFields = [
+    'dependencies',
+    'devDependencies',
+    'peerDependencies',
+    'optionalDependencies',
+];
 export function listPublicPackages(root) {
     return getWorkspacePackages(root).filter((pkg) => !pkg.private && pkg.tags.includes('npm:public'));
 }
+export function listReleasePackages(root, rootPackage = readPackageJson(join(root, 'package.json'))) {
+    if (!rootPackage) {
+        return [];
+    }
+    const rootRepository = repositoryInfo(rootPackage.json);
+    if (!rootRepository) {
+        return [];
+    }
+    return getWorkspacePackagesForPatterns(root, getWorkspacePatternsFromPackageJson(rootPackage.json)).filter((pkg) => !pkg.private && pkg.tags.includes('npm:public') && isOwnedPackage(rootRepository, pkg));
+}
+export function rootRepositoryInfo(root) {
+    const rootPackage = readJsonObject(join(root, 'package.json'));
+    return rootPackage ? repositoryInfo(rootPackage) : null;
+}
+export function rootPackageName(root) {
+    const rootPackage = readPackageJsonObject(join(root, 'package.json'));
+    return rootPackage ? stringProperty(rootPackage, 'name') : null;
+}
+export function isSmoothBricksCodebase(root) {
+    return isSmoothBricksCodebasePackageName(rootPackageName(root) ?? undefined);
+}
+export function packageRepositoryInfo(pkg) {
+    return repositoryInfo(pkg.json);
+}
+export function isOwnedPackage(rootRepository, pkg) {
+    const packageRepository = packageRepositoryInfo(pkg);
+    return packageRepository !== null && packageRepository.url === rootRepository.url;
+}
 export function getWorkspacePackages(root) {
-    if (!readPackageJson(join(root, 'package.json'))) {
+    const rootPackage = readPackageJson(join(root, 'package.json'));
+    if (!rootPackage) {
         throw new Error('package.json not found or invalid');
     }
-    const workspacePatterns = getWorkspacePatterns(root);
+    return getWorkspacePackagesForPatterns(root, getWorkspacePatternsFromPackageJson(rootPackage.json));
+}
+function getWorkspacePackagesForPatterns(root, workspacePatterns) {
     const packages = [];
     for (const pattern of workspacePatterns) {
         if (!pattern.endsWith('/*')) {
@@ -27,6 +64,7 @@ export function getWorkspacePackages(root) {
             }
             packages.push({
                 name: pkg.name,
+                projectName: pkg.projectName,
                 version: pkg.version,
                 private: pkg.private,
                 tags: pkg.tags,
@@ -43,14 +81,20 @@ export function listPackageJsonRecords(root) {
     if (!rootPackage) {
         throw new Error('package.json not found or invalid');
     }
-    return [{ ...rootPackage, path: '.' }, ...getWorkspacePackages(root)];
+    return [
+        { ...rootPackage, path: '.' },
+        ...getWorkspacePackagesForPatterns(root, getWorkspacePatternsFromPackageJson(rootPackage.json)),
+    ];
 }
 export function getWorkspacePatterns(root) {
     const raw = readJson(join(root, 'package.json'));
-    if (!isRecord(raw) || !hasOwn(raw, 'workspaces')) {
+    return isRecord(raw) ? getWorkspacePatternsFromPackageJson(raw) : ['packages/*'];
+}
+function getWorkspacePatternsFromPackageJson(pkg) {
+    if (!hasOwn(pkg, 'workspaces')) {
         return ['packages/*'];
     }
-    const workspaces = raw.workspaces;
+    const workspaces = pkg.workspaces;
     if (Array.isArray(workspaces)) {
         return workspaces.filter((entry) => typeof entry === 'string');
     }
@@ -60,7 +104,7 @@ export function getWorkspacePatterns(root) {
     return ['packages/*'];
 }
 export function readPackageJson(path) {
-    const parsed = readJsonObject(path);
+    const parsed = readPackageJsonObject(path);
     if (!isRecord(parsed) || !hasOwnString(parsed, 'name') || !hasOwnString(parsed, 'version')) {
         return null;
     }
@@ -68,6 +112,7 @@ export function readPackageJson(path) {
     const tags = getNxTags(parsed);
     return {
         name: parsed.name,
+        projectName: packageNxProjectName(parsed),
         version: parsed.version,
         private: privateValue,
         tags,
@@ -76,6 +121,14 @@ export function readPackageJson(path) {
         json: parsed,
     };
 }
+function packageNxProjectName(pkg) {
+    const nx = isRecord(pkg.nx) ? pkg.nx : null;
+    return (nx ? stringProperty(nx, 'name') : null) ?? stringProperty(pkg, 'name') ?? '';
+}
+export function readPackageJsonObject(path) {
+    const parsed = readJsonObject(path);
+    return parsed;
+}
 export function getNxTags(pkg) {
     if (!hasOwn(pkg, 'nx') || !isRecord(pkg.nx) || !hasOwn(pkg.nx, 'tags') || !Array.isArray(pkg.nx.tags)) {
         return [];
@@ -96,6 +149,33 @@ export function repositoryInfo(pkg) {
     }
     return { type: stringProperty(repository, 'type') ?? 'git', url };
 }
+export function sameRepositoryAfterNormalization(left, right) {
+    return normalizedRepositoryUrl(left) === normalizedRepositoryUrl(right);
+}
+function normalizedRepositoryUrl(url) {
+    const trimmed = url
+        .trim()
+        .replace(/^git\+/, '')
+        .replace(/#.*$/, '')
+        .replace(/\/$/, '')
+        .replace(/\.git$/, '');
+    const https = /^https:\/\/github\.com\/([^/]+)\/([^/]+)$/i.exec(trimmed);
+    if (https?.[1] && https[2]) {
+        return githubRepositoryKey(https[1], https[2]);
+    }
+    const ssh = /^git@github\.com:([^/]+)\/([^/]+)$/i.exec(trimmed);
+    if (ssh?.[1] && ssh[2]) {
+        return githubRepositoryKey(ssh[1], ssh[2]);
+    }
+    const shorthand = /^github:([^/]+)\/([^/]+)$/i.exec(trimmed);
+    if (shorthand?.[1] && shorthand[2]) {
+        return githubRepositoryKey(shorthand[1], shorthand[2]);
+    }
+    return trimmed;
+}
+function githubRepositoryKey(owner, repo) {
+    return `github:${owner.toLowerCase()}/${repo.toLowerCase()}`;
+}
 export function escapeRegex(value) {
     return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }

package/dist/monorepo/commit-msg.d.ts

@@ -1,2 +1,9 @@
-export declare function validateCommitMessage(message: string): string | null;
+export interface FormatCommitMessageOptions {
+    wrapBody?: (paragraph: string) => string;
+}
+export interface ValidateCommitMessageOptions {
+    validScopes?: ReadonlySet<string>;
+}
+export declare function validateCommitMessage(message: string, options?: ValidateCommitMessageOptions): string | null;
+export declare function formatCommitMessage(message: string, options?: FormatCommitMessageOptions): string;
 //# sourceMappingURL=commit-msg.d.ts.map