@lumenflow/cli 3.1.3 → 3.2.0

package/dist/release.js

@@ -65,6 +65,14 @@ const CHANGESET_DIR = '.changeset';
 const LUMENFLOW_FORCE_ENV = 'LUMENFLOW_FORCE';
 /** Environment variable to provide reason for force bypass */
 const LUMENFLOW_FORCE_REASON_ENV = 'LUMENFLOW_FORCE_REASON';
+/** Release phase label for pre-release clean-tree validation */
+const RELEASE_CLEAN_CHECK_PHASE_BEFORE_RELEASE = 'before release';
+/** Release phase label for post-publish clean-tree validation */
+const RELEASE_CLEAN_CHECK_PHASE_AFTER_PUBLISH = 'after npm publish';
+/** Command shown when release fails due to dirty working tree */
+const GIT_STATUS_SHORT_COMMAND = 'git status --short';
+/** Guidance shown when generated artifacts dirty the repository */
+const CLEAN_TREE_RECOVERY_GUIDANCE = 'Commit, stash, or clean generated files before retrying release.';
 /**
  * Environment variable for WU tool identification (WU-1296)
  * Pre-push hook checks this to allow approved tool operations
@@ -101,6 +109,22 @@ export async function withReleaseEnv(fn) {
         }
     }
 }
+/**
+ * Assert the current git working tree is clean.
+ *
+ * @param git - Git adapter with cleanliness check
+ * @param phase - Human-readable release phase label
+ */
+export async function assertWorkingTreeClean(git, phase) {
+    const isClean = await git.isClean();
+    if (isClean) {
+        return;
+    }
+    die(`Working directory has uncommitted changes ${phase}.\n\n` +
+        `Run this command to inspect unexpected artifacts:\n` +
+        `  ${GIT_STATUS_SHORT_COMMAND}\n` +
+        `${CLEAN_TREE_RECOVERY_GUIDANCE}`);
+}
 /**
  * Validate that a string is a valid semver version
  *
@@ -345,13 +369,7 @@ export async function main() {
     const git = getGitForCwd();
     await ensureOnMain(git);
     // Check for uncommitted changes
-    const isClean = await git.isClean();
-    if (!isClean) {
-        die(`Working directory has uncommitted changes.\n\n` +
-            `Commit or stash changes before releasing:\n` +
-            `  git status\n` +
-            `  git stash  # or git commit`);
-    }
+    await assertWorkingTreeClean(git, RELEASE_CLEAN_CHECK_PHASE_BEFORE_RELEASE);
     // Find all @lumenflow/* packages to update
     const packagePaths = findPackageJsonPaths();
     if (packagePaths.length === 0) {
@@ -443,6 +461,7 @@ export async function main() {
         else {
             console.log(`${LOG_PREFIX} Publishing packages to npm...`);
             runCommand(`${PKG_MANAGER} -r publish --access public --no-git-checks`, { label: 'publish' });
+            await assertWorkingTreeClean(git, RELEASE_CLEAN_CHECK_PHASE_AFTER_PUBLISH);
             console.log(`${LOG_PREFIX} ✅ Packages published to npm`);
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/cli",
-  "version": "3.1.3",
+  "version": "3.2.0",
   "description": "Command-line interface for LumenFlow workflow framework",
   "keywords": [
     "lumenflow",
@@ -178,12 +178,12 @@
     "xstate": "^5.28.0",
     "yaml": "^2.8.2",
     "zod": "^4.3.6",
-    "@lumenflow/agent": "3.1.3",
-    "@lumenflow/core": "3.1.3",
-    "@lumenflow/initiatives": "3.1.3",
-    "@lumenflow/metrics": "3.1.3",
-    "@lumenflow/memory": "3.1.3",
-    "@lumenflow/kernel": "3.1.3"
+    "@lumenflow/agent": "3.2.0",
+    "@lumenflow/initiatives": "3.2.0",
+    "@lumenflow/metrics": "3.2.0",
+    "@lumenflow/kernel": "3.2.0",
+    "@lumenflow/memory": "3.2.0",
+    "@lumenflow/core": "3.2.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.18",
@@ -200,6 +200,7 @@
   },
   "scripts": {
     "sync:bundled-packs": "node scripts/sync-bundled-packs.mjs",
+    "clean:bundled-packs": "node scripts/clean-bundled-packs.mjs",
     "build": "tsc && node scripts/check-shebangs.mjs",
     "build:dist:deps": "pnpm --filter @lumenflow/metrics build && pnpm --filter @lumenflow/kernel build && pnpm --filter @lumenflow/core build && pnpm --filter @lumenflow/memory build && pnpm --filter @lumenflow/agent build && pnpm --filter @lumenflow/initiatives build",
     "build:dist": "pnpm run clean && pnpm run build:dist:deps && tsup && node scripts/fix-entry-points.mjs && node scripts/check-shebangs.mjs",