@docupace/pipeline 1.1.5 → 1.1.6

package/.changeset/run-changeset-bin-directly.md

@@ -0,0 +1,7 @@
+---
+'@docupace/pipeline': patch
+---
+
+Run the changeset binary installed by the CLI directly instead of via `pnpm changeset`, so pnpm cannot re-sync node_modules to the repo lockfile and swap the changelog hook to an older pinned @docupace/pipeline.
+
+Log the @docupace/pipeline version (to stderr) before every command of every dp-*-cli, and log the CLI and changelog hook versions during changeset versioning.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docupace/pipeline",
-  "version": "1.1.5",
+  "version": "1.1.6",
   "description": "",
   "main": "index.js",
   "type": "module",

package/src/auth0/cli.js

@@ -19,10 +19,12 @@ import dotenv from 'dotenv';
 import { configureAlias } from './alias.js';
 import { exportConf } from './export.js';
 import { getAuth0Metadata } from './metadata.js';
+import { logVersionBeforeCommands } from '../lib/pipeline-version.js';
 
 dotenv.config({ path: ['.env.pipeline.local', 'config/.env.pipeline.local'] });
 
 const program = new Command();
+logVersionBeforeCommands(program);
 
 program
   .command(

package/src/changeset/cli.js

@@ -13,10 +13,12 @@ import {
 import { createChangeset } from './create.js';
 import { updateWikiWithVersion } from './changelog-wiki.js';
 import { convertPrepare, convertComplete } from './convert.js';
+import { logVersionBeforeCommands } from '../lib/pipeline-version.js';
 
 dotenv.config({ path: ['.env.pipeline.local', 'config/.env.pipeline.local'] });
 
 const program = new Command();
+logVersionBeforeCommands(program);
 
 const args = process.argv;
 

package/src/changeset/version.js

@@ -5,14 +5,37 @@ import { updateComponentVersion } from '../next/jira.js';
 import { findJiraTicketId } from './util.js';
 import { revertBaseBranch, updateBaseBranch } from './changeset-config.js';
 import semver from 'semver';
-import { dirname, join } from 'path';
-import { fileURLToPath } from 'url';
-
-const getPackageVersion = () => {
-  const __dirname = dirname(fileURLToPath(import.meta.url));
-  const packageJsonPath = join(__dirname, '../../package.json');
-  const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
-  return packageJson.version;
+import { join } from 'path';
+import { getPipelineVersion as getPackageVersion } from '../lib/pipeline-version.js';
+
+// Run the changeset binary installed by the temporary install below rather than
+// `pnpm changeset`. Going through pnpm lets it re-sync node_modules with the
+// repo's own lockfile before the command runs, which swaps the pinned
+// @docupace/pipeline (used by the changelog hook) for whatever version the repo
+// lockfile holds instead of the version of this CLI.
+const CHANGESET_BIN = './node_modules/.bin/changeset';
+
+// Version of @docupace/pipeline the changelog hook will be loaded from (the
+// copy in the current directory's node_modules, not the one running this CLI).
+const getInstalledPipelineVersion = () => {
+  try {
+    const pkgPath = join(
+      process.cwd(),
+      'node_modules',
+      '@docupace',
+      'pipeline',
+      'package.json',
+    );
+    return JSON.parse(readFileSync(pkgPath, 'utf8')).version;
+  } catch (error) {
+    return `unknown (${error.message})`;
+  }
+};
+
+const logPipelineVersions = (stage) => {
+  console.log(
+    `🔎 @docupace/pipeline ${stage}: running CLI ${getPackageVersion()}, changelog hook ${getInstalledPipelineVersion()}`,
+  );
 };
 
 const getChangeSetPackage = (installLatest = false) => `{
@@ -61,9 +84,9 @@ export async function versionStatus(sinceBranch) {
   const outputPath = './changeset-output.json';
 
   if (sinceBranch) {
-    await $`pnpm changeset status --output=${outputPath} --since=${sinceBranch}`;
+    await $`${CHANGESET_BIN} status --output=${outputPath} --since=${sinceBranch}`;
   } else {
-    await $`pnpm changeset status --output=${outputPath}`;
+    await $`${CHANGESET_BIN} status --output=${outputPath}`;
   }
 
   // Read the file and parse JSON
@@ -77,6 +100,7 @@ export async function versionCommand(
   installLatest = false,
 ) {
   console.log('📦 Running Changeset versioning...');
+  logPipelineVersions('at start');
   if (!process.env.IS_DEV) {
     await setGitInfo();
     await $`mv package.json package.json.bak`;
@@ -98,9 +122,10 @@ export async function versionCommand(
     }
     await $`mv package.json.bak package.json`;
     await $`mv pnpm-lock.yaml.bak pnpm-lock.yaml`;
+    logPipelineVersions('after install');
   }
   if (closeVersion) {
-    await $`pnpm changeset pre exit`;
+    await $`${CHANGESET_BIN} pre exit`;
   }
 
   let originalBaseBranch;
@@ -117,7 +142,8 @@ export async function versionCommand(
 
   // Intentionally outside the try/catch above: a failure here (e.g. release
   // notes processing) must fail the build, not be swallowed as "no releases".
-  await $`pnpm changeset version`;
+  logPipelineVersions('before changeset version');
+  await $`${CHANGESET_BIN} version`;
 
   await removeChangesetOutput();
 

package/src/lib/pipeline-version.js

@@ -0,0 +1,25 @@
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+
+/**
+ * Version of the @docupace/pipeline package this code is running from.
+ */
+export function getPipelineVersion() {
+  const __dirname = dirname(fileURLToPath(import.meta.url));
+  const packageJsonPath = join(__dirname, '../../package.json');
+  return JSON.parse(readFileSync(packageJsonPath, 'utf8')).version;
+}
+
+/**
+ * Registers a commander hook that logs the @docupace/pipeline version before
+ * any command of the given program runs. Written to stderr so it never mixes
+ * with output that callers parse from stdout.
+ */
+export function logVersionBeforeCommands(program) {
+  program.hook('preAction', (_thisCommand, actionCommand) => {
+    console.error(
+      `🔎 @docupace/pipeline ${getPipelineVersion()} (${program.name() || 'cli'} ${actionCommand.name()})`,
+    );
+  });
+}

package/src/merge/cli.js

@@ -6,9 +6,11 @@ import { Command } from 'commander';
 import { setupMerge } from './cli-merge.js';
 import { setupResolve } from './cli-resolve.js';
 import { setupMergeAll } from './cli-merge-all.js';
+import { logVersionBeforeCommands } from '../lib/pipeline-version.js';
 
 const args = process.argv;
 const program = new Command();
+logVersionBeforeCommands(program);
 
 /**
  * Reusable auto-resolve function

package/src/micro/cli.js

@@ -9,10 +9,12 @@ import {
   microserviceCopyImageToEnv,
   microserviceBuildPushImage,
 } from './ms-deploy.js';
+import { logVersionBeforeCommands } from '../lib/pipeline-version.js';
 
 dotenv.config({ path: ['.env.pipeline.local', 'config/.env.pipeline.local'] });
 
 const program = new Command();
+logVersionBeforeCommands(program);
 
 //const GIT_SHA = (await $`git log --pretty=format:'%h' -n 1`).stdout.trim();
 

package/src/next/cli.js

@@ -23,10 +23,12 @@ import { deployConnect, deployCore } from './jenkins.js';
 import { deployConnectAws, runPipelineChecked } from './connect-aws.js';
 import { registerConnectAwsCommands } from './connect-aws-cli.js';
 import { runPipeline } from './pipline.js';
+import { logVersionBeforeCommands } from '../lib/pipeline-version.js';
 
 dotenv.config({ path: ['.env.pipeline.local', 'config/.env.pipeline.local'] });
 
 const program = new Command();
+logVersionBeforeCommands(program);
 
 const GIT_SHA = (await $`git log --pretty=format:'%h' -n 1`).stdout.trim();
 

package/src/tenable/cli.js

@@ -3,8 +3,10 @@
 import { Command } from 'commander';
 import { $ } from 'zx';
 import { runTenableScan } from './scan.js';
+import { logVersionBeforeCommands } from '../lib/pipeline-version.js';
 
 const program = new Command();
+logVersionBeforeCommands(program);
 
 program
   .command('scan')

package/src/veracode/cli.js

@@ -2,8 +2,10 @@
 
 import { Command } from 'commander';
 import { runVeracodeScan } from './scan.js';
+import { logVersionBeforeCommands } from '../lib/pipeline-version.js';
 
 const program = new Command();
+logVersionBeforeCommands(program);
 
 program
   .command('scan')

package/src/xray/cli.js

@@ -2,8 +2,10 @@
 
 import { Command } from 'commander';
 import { notify } from './notify.js';
+import { logVersionBeforeCommands } from '../lib/pipeline-version.js';
 
 const program = new Command();
+logVersionBeforeCommands(program);
 
 program
   .command('notify')