@smoothbricks/cli 0.1.1 → 0.3.0

package/dist/generate/index.js

@@ -0,0 +1,47 @@
+import { run } from '../lib/run.js';
+const plugin = '@smoothbricks/nx-plugin';
+export const variants = {
+    'ts-lib': {
+        generator: 'create-package',
+        description: 'Create a TypeScript library package',
+        args: (name) => ['--name', name, '--variant', 'ts-lib'],
+        options: [{ flag: '--public', description: 'configure for npm publication' }],
+    },
+    'ts-zig': {
+        generator: 'create-package',
+        description: 'Create a TypeScript + Zig/WASM hybrid package',
+        args: (name) => ['--name', name, '--variant', 'ts-zig'],
+        options: [{ flag: '--public', description: 'configure for npm publication' }],
+    },
+    'make-public': {
+        generator: 'make-public',
+        description: 'Promote a private package to npm publication',
+        args: (name) => ['--project', name],
+    },
+};
+// ---------------------------------------------------------------------------
+// Dispatch
+// ---------------------------------------------------------------------------
+export async function generate(root, variantName, name, options) {
+    const variant = variants[variantName];
+    if (!variant) {
+        const known = Object.keys(variants).join(', ');
+        throw new Error(`Unknown generator variant "${variantName}". Available: ${known}`);
+    }
+    const args = ['g', `${plugin}:${variant.generator}`, ...variant.args(name)];
+    for (const opt of variant.options ?? []) {
+        const key = opt.flag.replace(/^--/, '');
+        if (options[key]) {
+            args.push(opt.flag);
+        }
+    }
+    if (options.dryRun) {
+        args.push('--dry-run');
+    }
+    await run('nx', args, root);
+    // Sync TypeScript project references so the new package is immediately
+    // visible in the build graph without a manual `nx sync` step.
+    if (!options.dryRun) {
+        await run('nx', ['sync'], root);
+    }
+}

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/run.d.ts

@@ -1,5 +1,11 @@
 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 runInteractiveStatus(command: string, args: string[], cwd: string, 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":"AAMA,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,oBAAoB,CACxC,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,MAAM,CAAC,CAiBjB;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

@@ -1,3 +1,4 @@
+import { spawn } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -17,6 +18,37 @@ export async function runStatus(command, args, cwd, quiet = false, env) {
     const result = quiet ? await shell.quiet() : await shell;
     return result.exitCode;
 }
+export async function runInteractiveStatus(command, args, cwd, env) {
+    const invocation = resolveCommandInvocation(cwd, command, args);
+    return new Promise((resolve, reject) => {
+        const child = spawn(invocation.command, invocation.args, {
+            cwd,
+            env: env ? mergeEnv(env) : process.env,
+            stdio: 'inherit',
+        });
+        child.on('error', reject);
+        child.on('close', (code, signal) => {
+            if (signal) {
+                reject(new Error(`${command} ${args.join(' ')} terminated by signal ${signal}`));
+                return;
+            }
+            resolve(code ?? 1);
+        });
+    });
+}
+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,20 +8,43 @@ export interface PackageInfo {
     packageJsonPath: string;
     json: Record<string, unknown>;
 }
+export interface WorkspacePackageManifest {
+    name: string;
+    projectName: string;
+    private: boolean;
+    path: string;
+    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 getWorkspacePackageManifests(root: string): WorkspacePackageManifest[];
 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 readWorkspacePackageManifest(path: string): WorkspacePackageManifest | 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;

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,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,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;AAgCD,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,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,gCAAgC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAErF;AA4BD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/lib/workspace.ts"],"names":[],"mappings":"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"}

package/dist/lib/workspace.js

@@ -1,7 +1,13 @@
 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'));
 }
@@ -19,6 +25,13 @@ 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);
 }
@@ -33,10 +46,48 @@ export function getWorkspacePackages(root) {
     }
     return getWorkspacePackagesForPatterns(root, getWorkspacePatternsFromPackageJson(rootPackage.json));
 }
+export function getWorkspacePackageManifests(root) {
+    const rootPackage = readPackageJsonObject(join(root, 'package.json'));
+    if (!rootPackage) {
+        throw new Error('package.json not found or invalid');
+    }
+    return getWorkspacePackageManifestsForPatterns(root, getWorkspacePatternsFromPackageJson(rootPackage));
+}
 function getWorkspacePackagesForPatterns(root, workspacePatterns) {
     const packages = [];
+    for (const pkgPath of listWorkspacePackageJsonPaths(root, workspacePatterns)) {
+        const pkg = readPackageJson(pkgPath);
+        if (!pkg?.name || !pkg.version) {
+            continue;
+        }
+        packages.push({
+            name: pkg.name,
+            projectName: pkg.projectName,
+            version: pkg.version,
+            private: pkg.private,
+            tags: pkg.tags,
+            path: relative(root, dirname(pkgPath)),
+            packageJsonPath: pkg.packageJsonPath,
+            json: pkg.json,
+        });
+    }
+    return packages.sort((a, b) => a.name.localeCompare(b.name));
+}
+function getWorkspacePackageManifestsForPatterns(root, workspacePatterns) {
+    const manifests = [];
+    for (const pkgPath of listWorkspacePackageJsonPaths(root, workspacePatterns)) {
+        const pkg = readWorkspacePackageManifest(pkgPath);
+        if (pkg) {
+            manifests.push(pkg);
+        }
+    }
+    return manifests.sort((a, b) => a.name.localeCompare(b.name));
+}
+function listWorkspacePackageJsonPaths(root, workspacePatterns) {
+    const paths = [];
     for (const pattern of workspacePatterns) {
         if (!pattern.endsWith('/*')) {
+            paths.push(join(root, pattern, 'package.json'));
             continue;
         }
         const parent = join(root, pattern.slice(0, -2));
@@ -44,23 +95,10 @@ function getWorkspacePackagesForPatterns(root, workspacePatterns) {
             continue;
         }
         for (const entry of readdirSync(parent)) {
-            const pkgPath = join(parent, entry, 'package.json');
-            const pkg = readPackageJson(pkgPath);
-            if (!pkg?.name || !pkg.version) {
-                continue;
-            }
-            packages.push({
-                name: pkg.name,
-                version: pkg.version,
-                private: pkg.private,
-                tags: pkg.tags,
-                path: relative(root, dirname(pkgPath)),
-                packageJsonPath: pkg.packageJsonPath,
-                json: pkg.json,
-            });
+            paths.push(join(parent, entry, 'package.json'));
         }
     }
-    return packages.sort((a, b) => a.name.localeCompare(b.name));
+    return paths;
 }
 export function listPackageJsonRecords(root) {
     const rootPackage = readPackageJson(join(root, 'package.json'));
@@ -90,7 +128,7 @@ function getWorkspacePatternsFromPackageJson(pkg) {
     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;
     }
@@ -98,6 +136,7 @@ export function readPackageJson(path) {
     const tags = getNxTags(parsed);
     return {
         name: parsed.name,
+        projectName: packageNxProjectName(parsed),
         version: parsed.version,
         private: privateValue,
         tags,
@@ -106,6 +145,29 @@ export function readPackageJson(path) {
         json: parsed,
     };
 }
+export function readWorkspacePackageManifest(path) {
+    const parsed = readPackageJsonObject(path);
+    if (!isRecord(parsed) || !hasOwnString(parsed, 'name')) {
+        return null;
+    }
+    const privateValue = hasOwn(parsed, 'private') && typeof parsed.private === 'boolean' ? parsed.private : false;
+    return {
+        name: parsed.name,
+        projectName: packageNxProjectName(parsed),
+        private: privateValue,
+        path: dirname(path),
+        packageJsonPath: 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 [];

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

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

@@ -1 +1 @@
-{"version":3,"file":"commit-msg.d.ts","sourceRoot":"","sources":["../../src/monorepo/commit-msg.ts"],"names":[],"mappings":"AAcA,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoBpE"}
+{"version":3,"file":"commit-msg.d.ts","sourceRoot":"","sources":["../../src/monorepo/commit-msg.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CAC1C;AAED,MAAM,WAAW,4BAA4B;IAC3C,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACnC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,4BAAiC,GAAG,MAAM,GAAG,IAAI,CA+BhH;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,0BAA+B,GAAG,MAAM,CA2CrG"}

package/dist/monorepo/commit-msg.js

@@ -1,3 +1,4 @@
+import { spawnSync } from 'node:child_process';
 const validCommitTypes = new Set([
     'build',
     'chore',
@@ -10,25 +11,102 @@ const validCommitTypes = new Set([
     'revert',
     'style',
     'test',
+    'types',
 ]);
-export function validateCommitMessage(message) {
+export function validateCommitMessage(message, options = {}) {
     const subject = message.split('\n', 1)[0]?.trim() ?? '';
     if (!subject) {
         return 'Commit message subject is empty.';
     }
-    if (/^(Merge|Revert ")/.test(subject) || /^(fixup|squash)! /.test(subject)) {
+    if (isGitGeneratedSubject(subject)) {
         return null;
     }
-    const match = /^(?<type>[a-z]+)(\([a-z0-9._/-]+\))?(?<breaking>!)?: .+$/.exec(subject);
+    const match = /^(?<type>[a-z]+)(\((?<scope>[a-z0-9._/@-]+(?:,[a-z0-9._/@-]+)*)\))?(?<breaking>!)?: .+$/.exec(subject);
     const type = match?.groups?.type;
-    if (type && validCommitTypes.has(type)) {
-        return null;
-    }
-    return `Invalid conventional commit subject: ${subject}
+    if (!type || !validCommitTypes.has(type)) {
+        return `Invalid conventional commit subject: ${subject}
 
 Expected examples:
   feat(statebus-core): add optimistic transactions
   fix(money): round negative amounts consistently
   chore(release): publish 1.2.3
   feat!: remove deprecated API`;
+    }
+    const scope = match.groups?.scope;
+    if (scope && options.validScopes) {
+        const invalidScopes = scope.split(',').filter((entry) => !options.validScopes?.has(entry));
+        if (invalidScopes.length > 0) {
+            return `Invalid conventional commit scope: ${invalidScopes.join(',')}
+
+Use package.json nx.name values, for example:
+  feat(statebus-core): add optimistic transactions
+  fix(money): round negative amounts consistently`;
+        }
+    }
+    return null;
+}
+export function formatCommitMessage(message, options = {}) {
+    const wrapBody = options.wrapBody ?? wrapBodyWithFmt;
+    const normalized = message.replace(/\r\n?/g, '\n');
+    const lines = normalized.split('\n');
+    const subject = lines.shift()?.trimEnd() ?? '';
+    const formatted = [subject];
+    let paragraph = [];
+    let inFence = false;
+    const flushParagraph = () => {
+        if (paragraph.length === 0) {
+            return;
+        }
+        formatted.push(wrapBody(paragraph.join('\n')).trimEnd());
+        paragraph = [];
+    };
+    for (const line of lines) {
+        const trimmedEnd = line.trimEnd();
+        if (trimmedEnd.startsWith('```') || trimmedEnd.startsWith('~~~')) {
+            flushParagraph();
+            inFence = !inFence;
+            formatted.push(trimmedEnd);
+            continue;
+        }
+        if (inFence || shouldPreserveLine(trimmedEnd)) {
+            flushParagraph();
+            formatted.push(trimmedEnd);
+            continue;
+        }
+        if (trimmedEnd === '') {
+            flushParagraph();
+            formatted.push('');
+            continue;
+        }
+        paragraph.push(trimmedEnd);
+    }
+    flushParagraph();
+    while (formatted.length > 1 && formatted.at(-1) === '') {
+        formatted.pop();
+    }
+    return `${formatted.join('\n')}\n`;
+}
+function wrapBodyWithFmt(paragraph) {
+    const result = spawnSync('fmt', ['-w', '72'], { input: `${paragraph}\n`, encoding: 'utf8' });
+    if (result.error) {
+        throw new Error(`fmt is required to format commit messages. Install it through devenv and retry.\n${result.error.message}`);
+    }
+    if (result.status !== 0) {
+        throw new Error([result.stderr.trim(), result.stdout.trim()].filter(Boolean).join('\n') ||
+            'fmt failed to wrap commit message body.');
+    }
+    return result.stdout;
+}
+function shouldPreserveLine(line) {
+    return (line.startsWith('#') ||
+        line.startsWith('>') ||
+        /^\s/.test(line) ||
+        /^[-*+]\s+/.test(line) ||
+        /^\d+\.\s+/.test(line) ||
+        /^https?:\/\//.test(line) ||
+        /^[A-Za-z][A-Za-z0-9-]*: /.test(line) ||
+        /^BREAKING CHANGE: /.test(line));
+}
+function isGitGeneratedSubject(subject) {
+    return /^(Merge|Revert ")/.test(subject) || /^(fixup|squash)! /.test(subject);
 }

package/dist/monorepo/index.d.ts

@@ -7,18 +7,35 @@ export interface InitOptions {
 export interface ValidateOptions {
     failFast?: boolean;
     onlyIfNewWorkspacePackage?: boolean;
+    fix?: boolean;
+    verbose?: boolean;
+}
+export interface ValidateCommitMessageOptions {
+    fix?: boolean;
 }
 export interface ListReleasePackagesOptions {
     failEmpty?: boolean;
     githubOutput?: string;
 }
+export interface SetupTestTracingOptions {
+    all?: boolean;
+    projects?: string;
+    opContextExport?: string;
+    tracerModule?: string;
+    dryRun?: boolean;
+}
+export interface SetupTestTracingShell {
+    run(command: string, args: string[], cwd: string): Promise<void>;
+    log(message: string): void;
+}
 export declare function initMonorepo(root: string, options: InitOptions): Promise<void>;
 export declare function validateMonorepo(root: string, options?: ValidateOptions): Promise<void>;
 export declare function updateManagedFiles(root: string): void;
 export declare function checkManagedFiles(root: string): void;
 export declare function diffManagedFiles(root: string): void;
-export declare function validateCommitMessageFile(path: string | undefined): void;
-export declare function listReleasePackagesForNx(root: string, options?: ListReleasePackagesOptions): string;
+export declare function validateCommitMessageFile(path: string | undefined, options?: ValidateCommitMessageOptions, root?: string): void;
+export declare function listReleaseProjectNamesForNx(root: string, options?: ListReleasePackagesOptions): string;
 export declare function validatePublicPackageTags(root: string): void;
+export declare function setupTestTracing(root: string, options: SetupTestTracingOptions, shell?: SetupTestTracingShell): Promise<void>;
 export { applyWorkspaceGitConfig, syncBunLockfileVersions };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/monorepo/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAMxD,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAQpF;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAWjG;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAErD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAMpD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CASxE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,0BAA+B,GAAG,MAAM,CAWvG;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI5D;AAED,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/monorepo/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAMxD,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,4BAA4B;IAC3C,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAQpF;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBjG;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAErD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAMpD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,GAAE,4BAAiC,EAC1C,IAAI,SAAgB,GACnB,IAAI,CAgBN;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,0BAA+B,GAAG,MAAM,CAW3G;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI5D;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,uBAAuB,EAChC,KAAK,GAAE,qBAAoD,GAC1D,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,CAAC"}