@smoothbricks/cli 0.1.1 → 0.3.0

package/dist/release/npm-auth.d.ts

@@ -1,6 +1,5 @@
 import type { ReleasePackageInfo } from './core.js';
 export interface NpmPublishAuthFailureOptions {
-    useBootstrapToken: boolean;
     tokenPresent: boolean;
     repository?: string;
 }

package/dist/release/npm-auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"npm-auth.d.ts","sourceRoot":"","sources":["../../src/release/npm-auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,WAAW,4BAA4B;IAC3C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC,EACjD,KAAK,EAAE,yBAAyB,EAChC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC,EACjD,OAAO,EAAE,4BAA4B,GACpC,MAAM,CAuCR;AAED,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC,EACjD,OAAO,EAAE,4BAA4B,GACpC,MAAM,CAgCR"}
+{"version":3,"file":"npm-auth.d.ts","sourceRoot":"","sources":["../../src/release/npm-auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,WAAW,4BAA4B;IAC3C,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC,EACjD,KAAK,EAAE,yBAAyB,EAChC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC,EACjD,OAAO,EAAE,4BAA4B,GACpC,MAAM,CAwBR;AAED,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC,EACjD,OAAO,EAAE,4BAA4B,GACpC,MAAM,CAmBR"}

package/dist/release/npm-auth.js

@@ -10,40 +10,28 @@ export async function publishWithAuthDiagnostics(pkg, shell, options) {
         }
         shell.error(npmPublishAuthFailureMessage(pkg, options));
         await shell.appendSummary(npmPublishAuthFailureMarkdown(pkg, options));
-        throw new Error(`${packageVersion}: npm publish authentication failed. Run smoo release trust-publisher after the package exists on npm; see the warning banner above for details.`, { cause: error });
+        throw new Error(`${packageVersion}: npm publish authentication failed. Run smoo release trust-publisher; see the warning banner above for details.`, { cause: error });
     }
 }
 export function npmPublishAuthFailureMessage(pkg, options) {
     const packageVersion = `${pkg.name}@${pkg.version}`;
     const lines = [
-        `::error title=npm publish authentication failed::${packageVersion} could not be published. This usually means npm trusted publishing is not configured for this package/workflow/repo, or the bootstrap NPM_TOKEN is missing/invalid.`,
+        `::error title=npm publish authentication failed::${packageVersion} could not be published. This usually means npm trusted publishing is not configured for this package/workflow/repo.`,
         '',
         `🚨 npm publish authentication failed for ${packageVersion}`,
         '',
     ];
-    if (options.useBootstrapToken) {
-        lines.push('smoo expected a temporary npm automation token because this package does not exist on npm yet.', options.tokenPresent
-            ? 'NODE_AUTH_TOKEN/NPM_TOKEN is set, but npm still rejected the bootstrap publish. Check that the token is valid, has publish rights for this scope, and is available to this workflow.'
-            : 'NODE_AUTH_TOKEN/NPM_TOKEN is not set. Add a temporary NPM_TOKEN repository secret and rerun the Publish workflow.', '', 'After the first successful publish, run:', '  smoo release trust-publisher', '', 'Then remove the temporary bootstrap token path for future releases.');
-        return lines.join('\n');
-    }
     lines.push('smoo expected npm trusted publishing/OIDC because this package already exists on npm.', options.tokenPresent
         ? 'NODE_AUTH_TOKEN/NPM_TOKEN is set but unused: smoo intentionally clears token auth for existing packages; npm must authenticate through trusted publishing instead.'
-        : 'NODE_AUTH_TOKEN/NPM_TOKEN is not set, which is expected for trusted publishing; npm did not authenticate the workflow as a trusted publisher.', '', 'Fix:', '1. Run locally: smoo release trust-publisher', '2. Ensure the npm trusted publisher uses:', `   repository: ${trustedPublisherRepository(options)}`, '   workflow: publish.yml', '3. Rerun the Publish workflow.', '', 'For first-ever package publishes, add a temporary NPM_TOKEN repository secret, publish once, then run smoo release trust-publisher.');
+        : 'NODE_AUTH_TOKEN/NPM_TOKEN is not set, which is expected for trusted publishing; npm did not authenticate the workflow as a trusted publisher.', '', 'Fix:', '1. Run locally: smoo release trust-publisher', '2. Ensure the npm trusted publisher uses:', `   repository: ${trustedPublisherRepository(options)}`, '   workflow: publish.yml', '3. Rerun the Publish workflow.', '', 'For first-ever package publishes, run locally: smoo release trust-publisher --bootstrap.');
     return lines.join('\n');
 }
 export function npmPublishAuthFailureMarkdown(pkg, options) {
     const packageVersion = `${pkg.name}@${pkg.version}`;
     const lines = ['## 🚨 npm Publish Authentication Failed', '', `Package: \`${packageVersion}\``, ''];
-    if (options.useBootstrapToken) {
-        lines.push('smoo expected a temporary npm automation token because this package does not exist on npm yet.', '', options.tokenPresent
-            ? '`NODE_AUTH_TOKEN`/`NPM_TOKEN` is set, but npm still rejected the bootstrap publish. Check that the token is valid, has publish rights for this scope, and is available to this workflow.'
-            : '`NODE_AUTH_TOKEN`/`NPM_TOKEN` is not set. Add a temporary `NPM_TOKEN` repository secret and rerun the Publish workflow.', '', 'After the first successful publish, run `smoo release trust-publisher`, then remove the temporary bootstrap token path for future releases.');
-        return lines.join('\n');
-    }
     lines.push('smoo expected npm trusted publishing/OIDC because this package already exists on npm.', '', options.tokenPresent
         ? '`NODE_AUTH_TOKEN`/`NPM_TOKEN` is set but unused: smoo intentionally clears token auth for existing packages; npm must authenticate through trusted publishing instead.'
-        : '`NODE_AUTH_TOKEN`/`NPM_TOKEN` is not set, which is expected for trusted publishing; npm did not authenticate the workflow as a trusted publisher.', '', 'Fix:', '', '1. Run locally: `smoo release trust-publisher`', `2. Ensure the npm trusted publisher uses repository \`${trustedPublisherRepository(options)}\` and workflow \`publish.yml\``, '3. Rerun the Publish workflow.', '', 'For first-ever package publishes, add a temporary `NPM_TOKEN` repository secret, publish once, then run `smoo release trust-publisher`.');
+        : '`NODE_AUTH_TOKEN`/`NPM_TOKEN` is not set, which is expected for trusted publishing; npm did not authenticate the workflow as a trusted publisher.', '', 'Fix:', '', '1. Run locally: `smoo release trust-publisher`', `2. Ensure the npm trusted publisher uses repository \`${trustedPublisherRepository(options)}\` and workflow \`publish.yml\``, '3. Rerun the Publish workflow.', '', 'For first-ever package publishes, run `smoo release trust-publisher --bootstrap` locally.');
     return lines.join('\n');
 }
 function trustedPublisherRepository(options) {

package/dist/release/orchestration.d.ts

@@ -8,6 +8,10 @@ export interface ReleaseSummary<Package extends ReleasePackageInfo = ReleasePack
     published: Package[];
     alreadyPublished: Package[];
     githubReleases: Package[];
+    githubReleaseLinks: Array<{
+        pkg: Package;
+        url: string;
+    }>;
     rerunRequired: boolean;
     noRelease: boolean;
 }
@@ -18,7 +22,10 @@ export interface ReleaseCompletionShell<Package extends ReleasePackageInfo = Rel
     buildReleaseCandidate(packages: Package[]): Promise<void>;
     publishPackage(pkg: Package, distTag: string, dryRun: boolean): Promise<void>;
     listGithubMissingPackages(packages: Package[]): Promise<Package[]>;
-    createGithubRelease(pkg: Package, dryRun: boolean): Promise<void>;
+    createGithubRelease(pkg: Package, dryRun: boolean): Promise<string | null>;
+}
+export interface ReleaseNextShell<Package extends ReleasePackageInfo = ReleasePackageInfo> {
+    bumpStablePackagesToNext(packages: Package[]): Promise<void>;
 }
 export interface ReleaseRepairShell<Package extends ReleasePackageInfo = ReleasePackageInfo> extends ReleaseCompletionShell<Package> {
     checkout(ref: string): Promise<void>;
@@ -28,9 +35,10 @@ export interface ReleaseRepairShell<Package extends ReleasePackageInfo = Release
 }
 export interface ReleaseVersionShell<Package extends ReleasePackageInfo = ReleasePackageInfo> {
     releasePackagesAtHead(): Promise<Package[]>;
+    releaseVersionPackages(bump: string): Promise<Package[]>;
     ensureLocalReleaseTags(packages: Package[]): Promise<void>;
     gitHead(): Promise<string>;
-    runNxReleaseVersion(bump: string, dryRun: boolean): Promise<void>;
+    runNxReleaseVersion(packages: Package[], bump: string, dryRun: boolean): Promise<Package[]>;
     assertCleanGitTree(): Promise<void>;
 }
 export interface ReleaseVersionResult<Package extends ReleasePackageInfo = ReleasePackageInfo> {
@@ -43,6 +51,7 @@ export declare function runReleaseVersion<Package extends ReleasePackageInfo>(sh
     dryRun: boolean;
 }): Promise<ReleaseVersionResult<Package>>;
 export declare function completeReleaseAtHead<Package extends ReleasePackageInfo>(shell: ReleaseCompletionShell<Package>, packages: Package[], dryRun: boolean, rerunRequired: boolean): Promise<ReleaseSummary<Package>>;
+export declare function bumpStableReleaseToNext<Package extends ReleasePackageInfo>(shell: ReleaseNextShell<Package>, packages: Package[], dryRun: boolean, rerunRequired: boolean): Promise<Package[]>;
 export declare function repairPendingTargets<Package extends ReleasePackageInfo>(shell: ReleaseRepairShell<Package>, targets: Array<ReleaseTarget<Package>>, restoreRef: string, dryRun: boolean): Promise<Array<ReleaseSummary<Package>>>;
 export declare function completeRepairTargetAtHead<Package extends ReleasePackageInfo>(shell: ReleaseCompletionShell<Package>, target: ReleaseTarget<Package>, dryRun: boolean): Promise<ReleaseSummary<Package>>;
 //# sourceMappingURL=orchestration.d.ts.map

package/dist/release/orchestration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestration.d.ts","sourceRoot":"","sources":["../../src/release/orchestration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAGnE,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,CAAC;AAEhD,MAAM,WAAW,cAAc,CAAC,OAAO,SAAS,kBAAkB,GAAG,kBAAkB;IACrF,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB,gBAAgB,EAAE,OAAO,EAAE,CAAC;IAC5B,cAAc,EAAE,OAAO,EAAE,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB,CAAC,OAAO,SAAS,kBAAkB,GAAG,kBAAkB;IAC7F,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAChE,qBAAqB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,yBAAyB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACnE,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,kBAAkB,CAAC,OAAO,SAAS,kBAAkB,GAAG,kBAAkB,CACzF,SAAQ,sBAAsB,CAAC,OAAO,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,aAAa,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3D,kBAAkB,CAAC,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1D,iBAAiB,CAAC,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,mBAAmB,CAAC,OAAO,SAAS,kBAAkB,GAAG,kBAAkB;IAC1F,qBAAqB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5C,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB,CAAC,OAAO,SAAS,kBAAkB,GAAG,kBAAkB;IAC3F,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,wBAAwB,GAAG,SAAS,GAAG,aAAa,GAAG,mBAAmB,CAAC;CACpF;AAED,wBAAsB,iBAAiB,CAAC,OAAO,SAAS,kBAAkB,EACxE,KAAK,EAAE,mBAAmB,CAAC,OAAO,CAAC,EACnC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACzC,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAgCxC;AAED,wBAAsB,qBAAqB,CAAC,OAAO,SAAS,kBAAkB,EAC5E,KAAK,EAAE,sBAAsB,CAAC,OAAO,CAAC,EACtC,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,EAAE,OAAO,EACf,aAAa,EAAE,OAAO,GACrB,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAYlC;AAED,wBAAsB,oBAAoB,CAAC,OAAO,SAAS,kBAAkB,EAC3E,KAAK,EAAE,kBAAkB,CAAC,OAAO,CAAC,EAClC,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,EACtC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAmBzC;AAED,wBAAsB,0BAA0B,CAAC,OAAO,SAAS,kBAAkB,EACjF,KAAK,EAAE,sBAAsB,CAAC,OAAO,CAAC,EACtC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAC9B,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAUlC"}
+{"version":3,"file":"orchestration.d.ts","sourceRoot":"","sources":["../../src/release/orchestration.ts"],"names":[],"mappings":"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"}

package/dist/release/orchestration.js

@@ -7,10 +7,18 @@ export async function runReleaseVersion(shell, options) {
             return { mode: 'none', packages: localRelease, status: 'already-release-target' };
         }
     }
+    const versionPackages = await shell.releaseVersionPackages(options.bump);
+    if (versionPackages.length === 0) {
+        if (options.bump !== 'auto') {
+            // invariant throw: the CLI resolves forced bumps from the full owned release package set.
+            throw new Error(`No release packages were selected for forced --bump ${options.bump}.`);
+        }
+        return { mode: 'none', packages: [], status: 'no-release-needed' };
+    }
     const headBeforeVersioning = await shell.gitHead();
-    await shell.runNxReleaseVersion(options.bump, options.dryRun);
+    const dryRunPackages = await shell.runNxReleaseVersion(versionPackages, options.bump, options.dryRun);
     if (options.dryRun) {
-        return { mode: 'none', packages: [], status: 'dry-run' };
+        return { mode: 'none', packages: dryRunPackages, status: 'dry-run' };
     }
     await shell.assertCleanGitTree();
     const headAfterVersioning = await shell.gitHead();
@@ -43,7 +51,18 @@ export async function completeReleaseAtHead(shell, packages, dryRun, rerunRequir
         rerunRequired,
     });
 }
+export async function bumpStableReleaseToNext(shell, packages, dryRun, rerunRequired) {
+    const stablePackages = packages.filter((pkg) => !pkg.version.includes('-'));
+    if (dryRun || rerunRequired || stablePackages.length === 0) {
+        return [];
+    }
+    await shell.bumpStablePackagesToNext(stablePackages);
+    return stablePackages;
+}
 export async function repairPendingTargets(shell, targets, restoreRef, dryRun) {
+    if (dryRun) {
+        return targets.map((target) => repairDryRunSummary(target));
+    }
     const summaries = [];
     try {
         for (const target of targets) {
@@ -65,6 +84,20 @@ export async function repairPendingTargets(shell, targets, restoreRef, dryRun) {
     }
     return summaries;
 }
+function repairDryRunSummary(target) {
+    return {
+        sha: target.sha,
+        dryRun: true,
+        packages: target.packages,
+        pushed: false,
+        published: [],
+        alreadyPublished: target.packages.filter((pkg) => !target.npmPackages.includes(pkg)),
+        githubReleases: [],
+        githubReleaseLinks: [],
+        rerunRequired: false,
+        noRelease: false,
+    };
+}
 export async function completeRepairTargetAtHead(shell, target, dryRun) {
     return completePlannedRelease(shell, {
         sha: await shell.gitHead(),
@@ -88,8 +121,12 @@ async function completePlannedRelease(shell, input) {
     for (const { pkg, distTag } of plan.publishPackages) {
         await shell.publishPackage(pkg, distTag, input.dryRun);
     }
+    const githubReleaseLinks = [];
     for (const pkg of plan.githubReleasePackages) {
-        await shell.createGithubRelease(pkg, input.dryRun);
+        const url = await shell.createGithubRelease(pkg, input.dryRun);
+        if (url) {
+            githubReleaseLinks.push({ pkg, url });
+        }
     }
     return {
         sha: input.sha,
@@ -99,6 +136,7 @@ async function completePlannedRelease(shell, input) {
         published: input.dryRun ? [] : plan.publishPackages.map((action) => action.pkg),
         alreadyPublished: input.packages.filter((pkg) => !input.npmMissingPackages.includes(pkg)),
         githubReleases: input.dryRun ? [] : plan.githubReleasePackages,
+        githubReleaseLinks,
         rerunRequired: input.rerunRequired,
         noRelease: false,
     };

package/dist/release/publish-plan.js

@@ -5,7 +5,7 @@ export function planPublishActions(input) {
     const npmPackages = input.releasePackages.filter((pkg) => npmMissingNames.has(pkg.name));
     const githubReleasePackages = input.releasePackages.filter((pkg) => githubMissingNames.has(pkg.name));
     return {
-        buildProjects: npmPackages.map((pkg) => pkg.name),
+        buildProjects: npmPackages.map((pkg) => pkg.projectName),
         publishPackages: npmPackages.map((pkg) => ({ pkg, distTag: npmDistTagForVersion(pkg.version) })),
         githubReleasePackages,
     };

package/managed/raw/git-format-staged.yml

@@ -0,0 +1,54 @@
+# git-format-staged configuration for SmoothBricks-style monorepos
+
+formatters:
+  # ESLint for Astro files (run first as it only handles .astro files)
+  eslint:
+    command: "eslint-stdout '{}'"
+    patterns:
+      - '*.astro'
+      - '!.*' # Exclude hidden files
+
+  # Biome for JS/TS/JSX/TSX/JSON/HTML/CSS/GraphQL files
+  biome:
+    command: "biome check --files-ignore-unknown=true --use-editorconfig=true '--stdin-file-path={}' --fix"
+    patterns:
+      - '*.js'
+      - '*.ts'
+      - '*.jsx'
+      - '*.tsx'
+      - '*.json'
+      - '*.jsonc'
+      - '*.html'
+      - '*.css'
+      - '*.graphql'
+
+  # Prettier for all other files (mainly Markdown)
+  prettier:
+    command: "prettier --ignore-unknown --stdin-filepath '{}'"
+    patterns:
+      # Match all files
+      - '*'
+      # Exclude files handled by Biome
+      - '!*.js'
+      - '!*.ts'
+      - '!*.jsx'
+      - '!*.tsx'
+      - '!*.json'
+      - '!*.jsonc'
+      - '!*.html'
+      - '!*.css'
+      - '!*.graphql'
+      # Exclude files handled by Alejandra
+      - '!*.nix'
+      # Bun lockfiles are generated and should not be rewritten by Prettier
+      - '!bun.lock'
+
+  # Alejandra for Nix files
+  alejandra:
+    command: 'alejandra'
+    patterns:
+      - '*.nix'
+
+settings:
+  update_working_tree: true
+  show_commands: true # Verbose output

package/managed/raw/tooling/git-hooks/commit-msg.sh

@@ -6,4 +6,4 @@ export PATH="$TOOLING/git-hooks:$TOOLING:$PWD/node_modules/.bin:$TOOLING/direnv/
 
 set -e -o pipefail
 
-smoo monorepo validate-commit-msg "$1"
+smoo monorepo validate-commit-msg --fix "$1"

package/managed/templates/github/actions/setup-devenv/action.yml

@@ -15,13 +15,7 @@ runs:
     # This action is intentionally post-checkout only. Repo-local actions do not
     # exist before actions/checkout has populated the working tree.
     - name: ❄️ Install Nix
-      uses: DeterminateSystems/nix-installer-action@v22
-      with:
-        extra-conf: |
-          keep-outputs = true
-          keep-derivations = true
-          gc-keep-derivations = true
-          gc-keep-outputs = true
+      uses: DeterminateSystems/determinate-nix-action@v3
 
     - name: 🧊 Cache Nix profiles and store NAR
       id: nix-cache

package/managed/templates/github/workflows/ci.yml

@@ -17,7 +17,9 @@ defaults:
 
 jobs:
   main:
+    name: Validate
     runs-on: ubuntu-latest
+    timeout-minutes: 45
     env:
       NIX_STORE_NAR: ${{ github.workspace }}/nix-store.nar
       GH_TOKEN: ${{ github.token }}
@@ -80,8 +82,8 @@ jobs:
 
       # Step 10
       - name: 📎 Upload trace DBs
-        if: ${{ failure() }}
-        uses: actions/upload-artifact@v4
+        if: ${{ always() }}
+        uses: actions/upload-artifact@v7.0.1
         with:
           name: trace-results-${{ github.run_id }}
           path: packages/*/.trace-results.db

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@smoothbricks/cli",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "type": "module",
   "description": "SmoothBricks monorepo automation CLI",
   "bin": {
     "smoo": "./bin/smoo"
   },
   "scripts": {
-    "test": "bun test"
+    "test": "nx run cli:test --tui=false --outputStyle=stream"
   },
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -33,11 +33,6 @@
       "development": "./src/monorepo/git-config.ts",
       "import": "./dist/monorepo/git-config.js",
       "default": "./dist/monorepo/git-config.js"
-    },
-    "./nx-version-actions": {
-      "types": "./dist/nx-version-actions.d.cts",
-      "require": "./dist/nx-version-actions.cjs",
-      "default": "./dist/nx-version-actions.cjs"
     }
   },
   "files": [
@@ -50,9 +45,11 @@
   ],
   "dependencies": {
     "@arethetypeswrong/cli": "^0.18.2",
+    "@smoothbricks/nx-plugin": "0.2.0",
     "@smoothbricks/validation": "0.1.1",
     "commander": "^14.0.3",
     "publint": "^0.3.18",
+    "semver": "^7.7.4",
     "sherif": "^1.11.1",
     "tslib": "^2.8.1"
   },
@@ -71,11 +68,21 @@
         "dependsOn": [
           "build"
         ]
+      },
+      "test": {
+        "executor": "@smoothbricks/nx-plugin:bounded-exec",
+        "options": {
+          "command": "bun test",
+          "cwd": "{projectRoot}",
+          "timeoutMs": 120000,
+          "killAfterMs": 1e4
+        }
       }
     },
     "tags": [
       "npm:public"
-    ]
+    ],
+    "name": "cli"
   },
   "license": "MIT",
   "publishConfig": {

package/src/cli.ts

@@ -1,4 +1,6 @@
 import { Command, CommanderError } from 'commander';
+import { variants } from './generate/index.js';
+import { cliPackageVersion } from './lib/cli-package.js';
 import { findRepoRoot } from './lib/run.js';
 
 export async function runCli(argv = process.argv.slice(2)): Promise<void> {
@@ -20,7 +22,12 @@ export async function runCli(argv = process.argv.slice(2)): Promise<void> {
 
 function buildProgram(): Command {
   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
@@ -33,12 +40,21 @@ function buildProgram(): Command {
     });
   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')
-    .action(async (options: { failFast?: boolean; onlyIfNewWorkspacePackage?: boolean }) => {
-      const { validateMonorepo } = await import('./monorepo/index.js');
-      await validateMonorepo(await findRepoRoot(), options);
-    });
+    .option('--verbose', 'print validation progress and successful checks')
+    .action(
+      async (options: {
+        fix?: boolean;
+        failFast?: boolean;
+        onlyIfNewWorkspacePackage?: boolean;
+        verbose?: boolean;
+      }) => {
+        const { validateMonorepo } = await import('./monorepo/index.js');
+        await validateMonorepo(await findRepoRoot(), options);
+      },
+    );
   monorepo.command('update').action(async () => {
     const { updateManagedFiles } = await import('./monorepo/index.js');
     updateManagedFiles(await findRepoRoot());
@@ -51,10 +67,13 @@ function buildProgram(): Command {
     const { diffManagedFiles } = await import('./monorepo/index.js');
     diffManagedFiles(await findRepoRoot());
   });
-  monorepo.command('validate-commit-msg <commitMsgFile>').action(async (commitMsgFile: string) => {
-    const { validateCommitMessageFile } = await import('./monorepo/index.js');
-    validateCommitMessageFile(commitMsgFile);
-  });
+  monorepo
+    .command('validate-commit-msg <commitMsgFile>')
+    .option('--fix', 'format the commit message before validation')
+    .action(async (commitMsgFile: string, options: { fix?: boolean }) => {
+      const { validateCommitMessageFile } = await import('./monorepo/index.js');
+      validateCommitMessageFile(commitMsgFile, options, await findRepoRoot());
+    });
   monorepo.command('sync-bun-lockfile-versions').action(async () => {
     const { syncBunLockfileVersions } = await import('./monorepo/index.js');
     syncBunLockfileVersions(await findRepoRoot());
@@ -62,10 +81,10 @@ function buildProgram(): Command {
   monorepo
     .command('list-release-packages')
     .option('--fail-empty', 'fail when no owned release packages are found')
-    .option('--github-output <path>', 'append projects=<packages> to a GitHub Actions output file')
+    .option('--github-output <path>', 'append projects=<nx-projects> to a GitHub Actions output file')
     .action(async (options: { failEmpty?: boolean; githubOutput?: string }) => {
-      const { listReleasePackagesForNx } = await import('./monorepo/index.js');
-      const packages = listReleasePackagesForNx(await findRepoRoot(), options);
+      const { listReleaseProjectNamesForNx } = await import('./monorepo/index.js');
+      const packages = listReleaseProjectNamesForNx(await findRepoRoot(), options);
       if (!options.githubOutput) {
         console.log(packages);
       }
@@ -74,6 +93,46 @@ function buildProgram(): Command {
     const { validatePublicPackageTags } = await import('./monorepo/index.js');
     validatePublicPackageTags(await findRepoRoot());
   });
+  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: {
+        all?: boolean;
+        projects?: string;
+        opContextExport?: string;
+        tracerModule?: string;
+        dryRun?: boolean;
+      }) => {
+        const { setupTestTracing } = await import('./monorepo/index.js');
+        await setupTestTracing(await findRepoRoot(), options);
+      },
+    );
+  // `smoo g` / `smoo generate` — subcommands are driven by the variant
+  // registry in src/generate/index.ts. To add a new variant, add an entry
+  // there; the CLI wiring below picks it up automatically.
+  const g = program.command('g').alias('generate').description('Scaffold workspace packages and components');
+  for (const [variantName, variant] of Object.entries(variants)) {
+    const sub = g.command(`${variantName} <name>`).description(variant.description);
+    for (const opt of variant.options ?? []) {
+      sub.option(opt.flag, opt.description);
+    }
+    sub.option('--dry-run', 'preview changes without writing');
+    sub.action(async (name: string, options: Record<string, unknown>) => {
+      const { generate } = await import('./generate/index.js');
+      await generate(await findRepoRoot(), variantName, name, 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');
@@ -91,7 +150,7 @@ function buildProgram(): Command {
     .command('version')
     .option('--bump <bump>', 'auto, patch, minor, major, or prerelease', 'auto')
     .option('--dry-run [dryRun]', 'run without writing versions or tags')
-    .option('--github-output <path>', 'append mode=<mode> and projects=<packages> to a GitHub Actions output file')
+    .option('--github-output <path>', 'append mode=<mode> and projects=<nx-projects> to a GitHub Actions output file')
     .action(async (options: { bump: string; dryRun?: string | boolean; githubOutput?: string }) => {
       const { releaseVersion } = await import('./release/index.js');
       await releaseVersion(await findRepoRoot(), {
@@ -143,19 +202,91 @@ function buildProgram(): Command {
       },
     );
   release
-    .command('trust-publisher')
-    .description('Configure npm trusted publishing for owned release packages')
-    .option('--dry-run [dryRun]', 'show npm trust changes without saving them')
-    .option('--otp <otp>', 'npm one-time password for trust operations')
-    .option('--skip-login', 'skip npm browser login before configuring trust')
-    .action(async (options: { dryRun?: string | boolean; otp?: string; skipLogin?: boolean }) => {
-      const { releaseTrustPublisher } = await import('./release/index.js');
-      await releaseTrustPublisher(await findRepoRoot(), {
+    .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: { dryRun?: string | boolean; skipLogin?: boolean; otp?: string; package?: string[] }) => {
+      const { releaseBootstrapNpmPackages } = await import('./release/index.js');
+      await releaseBootstrapNpmPackages(await findRepoRoot(), {
         dryRun: booleanOption(options.dryRun),
-        otp: options.otp,
         skipLogin: options.skipLogin === true,
+        otp: options.otp,
+        packages: options.package ?? [],
       });
     });
+  release
+    .command('trust-publisher')
+    .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('--bootstrap-otp <otp>', 'npm one-time password for placeholder publishes during --bootstrap')
+    .option('--skip-login', 'skip npm browser login before publishing placeholders during --bootstrap')
+    .option('--package <name...>', 'only configure the selected owned release package names')
+    .action(
+      async (options: {
+        dryRun?: string | boolean;
+        bootstrap?: boolean;
+        bootstrapOtp?: string;
+        skipLogin?: boolean;
+        package?: string[];
+      }) => {
+        const { releaseTrustPublisher } = await import('./release/index.js');
+        await releaseTrustPublisher(await findRepoRoot(), {
+          dryRun: booleanOption(options.dryRun),
+          bootstrap: options.bootstrap === true,
+          bootstrapOtp: options.bootstrapOtp,
+          skipLogin: options.skipLogin === true,
+          packages: options.package ?? [],
+        });
+      },
+    );
+
+  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: { withTarget?: string }) => {
+      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 () => {