@lumenflow/cli 2.11.0 → 2.12.0

package/dist/wu-validate.js

@@ -25,7 +25,31 @@ import { validateWU, validateWUCompleteness } from '@lumenflow/core/dist/wu-sche
 import { FILE_SYSTEM, EMOJI, PATTERNS } from '@lumenflow/core/dist/wu-constants.js';
 // WU-2253: Import WU spec linter for acceptance/code_paths validation
 import { lintWUSpec } from '@lumenflow/core/dist/wu-lint.js';
+import { validateWuValidateCliArgs } from './shared-validators.js';
 const LOG_PREFIX = '[wu:validate]';
+export function validateWuValidateOptions(id, noStrict) {
+    return validateWuValidateCliArgs({ id, noStrict });
+}
+/**
+ * Summarize validation results for JSON output.
+ */
+export function summarizeValidationResults(results) {
+    const totalValid = results.filter((r) => r.valid).length;
+    const totalInvalid = results.filter((r) => !r.valid).length;
+    const totalWarnings = results.reduce((sum, r) => sum + (r.warnings?.length ?? 0), 0);
+    const invalid = results.filter((r) => !r.valid).map((r) => ({ wuId: r.wuId, errors: r.errors }));
+    const warnings = results
+        .filter((r) => r.warnings && r.warnings.length > 0)
+        .map((r) => ({ wuId: r.wuId, warnings: r.warnings }));
+    return {
+        valid: totalInvalid === 0,
+        totalValid,
+        totalInvalid,
+        totalWarnings,
+        invalid,
+        warnings,
+    };
+}
 /**
  * Validate a single WU file
  *
@@ -82,7 +106,7 @@ function validateSingleWU(wuPath, { strict = true } = {}) {
  *
  * @param {object} options - Validation options
  * @param {boolean} options.strict - Treat warnings as errors (default: true)
- * @returns {{totalValid: number, totalInvalid: number, totalWarnings: number, results: object[]}}
+ * @returns {{totalValid: number, totalInvalid: number, totalWarnings: number, results: ValidationResult[]}}
  */
 function validateAllWUs({ strict = true } = {}) {
     const wuDir = WU_PATHS.WU_DIR();
@@ -126,11 +150,17 @@ async function main() {
             },
             // WU-1329: Change from --strict to --no-strict (strict is now default)
             WU_OPTIONS.noStrict,
+            {
+                name: 'json',
+                flags: '--json',
+                type: 'boolean',
+                description: 'Output JSON summary only',
+            },
         ],
         required: [],
         allowPositionalId: true,
     });
-    const { id, all, noStrict } = args;
+    const { id, all, noStrict, json } = args;
     // WU-1329: Strict mode is the default, --no-strict opts out
     const strict = !noStrict;
     // WU-1329: Log when strict validation is bypassed
@@ -145,8 +175,15 @@ async function main() {
     }
     if (all) {
         // Validate all WUs
-        console.log(`${LOG_PREFIX} Validating all WU files...`);
-        const { totalValid, totalInvalid, totalWarnings, results } = validateAllWUs({ strict });
+        if (!json) {
+            console.log(`${LOG_PREFIX} Validating all WU files...`);
+        }
+        const { results } = validateAllWUs({ strict });
+        const summary = summarizeValidationResults(results);
+        if (json) {
+            console.log(JSON.stringify(summary));
+            process.exit(summary.valid ? 0 : 1);
+        }
         // Print results
         for (const result of results) {
             if (result.errors.length > 0) {
@@ -160,14 +197,18 @@ async function main() {
         }
         console.log('');
         console.log(`${LOG_PREFIX} Summary:`);
-        console.log(`  ${EMOJI.SUCCESS} Valid: ${totalValid}`);
-        console.log(`  ${EMOJI.FAILURE} Invalid: ${totalInvalid}`);
-        console.log(`  ${EMOJI.WARNING} Warnings: ${totalWarnings}`);
-        if (totalInvalid > 0) {
+        console.log(`  ${EMOJI.SUCCESS} Valid: ${summary.totalValid}`);
+        console.log(`  ${EMOJI.FAILURE} Invalid: ${summary.totalInvalid}`);
+        console.log(`  ${EMOJI.WARNING} Warnings: ${summary.totalWarnings}`);
+        if (!summary.valid) {
             process.exit(1);
         }
     }
     else {
+        const validation = validateWuValidateOptions(id, noStrict);
+        if (!validation.valid) {
+            die(`Invalid wu:validate arguments:\n  - ${validation.errors.join('\n  - ')}`);
+        }
         // Validate single WU
         const wuId = id.toUpperCase();
         if (!PATTERNS.WU_ID.test(wuId)) {
@@ -177,8 +218,15 @@ async function main() {
         if (!existsSync(wuPath)) {
             die(`WU file not found: ${wuPath}`);
         }
-        console.log(`${LOG_PREFIX} Validating ${wuId}...`);
+        if (!json) {
+            console.log(`${LOG_PREFIX} Validating ${wuId}...`);
+        }
         const result = validateSingleWU(wuPath, { strict });
+        const summary = summarizeValidationResults([{ wuId, ...result }]);
+        if (json) {
+            console.log(JSON.stringify(summary));
+            process.exit(summary.valid ? 0 : 1);
+        }
         if (result.errors.length > 0) {
             console.log(`${EMOJI.FAILURE} Validation failed:`);
             result.errors.forEach((e) => console.log(`  ${e}`));
@@ -200,3 +248,4 @@ import { runCLI } from './cli-entry-point.js';
 if (import.meta.main) {
     runCLI(main);
 }
+//# sourceMappingURL=wu-validate.js.map

package/dist/wu-validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-validate.js","sourceRoot":"","sources":["../src/wu-validate.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/cli",
-  "version": "2.11.0",
+  "version": "2.12.0",
   "description": "Command-line interface for LumenFlow workflow framework",
   "keywords": [
     "lumenflow",
@@ -109,25 +109,13 @@
     "file-write": "./dist/file-write.js",
     "file-edit": "./dist/file-edit.js",
     "file-delete": "./dist/file-delete.js",
-    "guard-worktree-commit": "./dist/guard-worktree-commit.js",
-    "guard-locked": "./dist/guard-locked.js",
     "validate": "./dist/validate.js",
     "lumenflow-validate": "./dist/validate.js",
-    "validate-agent-skills": "./dist/validate-agent-skills.js",
-    "validate-agent-sync": "./dist/validate-agent-sync.js",
-    "validate-backlog-sync": "./dist/validate-backlog-sync.js",
-    "validate-skills-spec": "./dist/validate-skills-spec.js",
-    "deps-add": "./dist/deps-add.js",
-    "deps-remove": "./dist/deps-remove.js",
-    "session-coordinator": "./dist/session-coordinator.js",
-    "rotate-progress": "./dist/rotate-progress.js",
     "lumenflow-upgrade": "./dist/lumenflow-upgrade.js",
-    "trace-gen": "./dist/trace-gen.js",
     "git-status": "./dist/git-status.js",
     "git-diff": "./dist/git-diff.js",
     "git-log": "./dist/git-log.js",
     "git-branch": "./dist/git-branch.js",
-    "guard-main-branch": "./dist/guard-main-branch.js",
     "state-bootstrap": "./dist/state-bootstrap.js",
     "lane-health": "./dist/lane-health.js",
     "lane-suggest": "./dist/lane-suggest.js",
@@ -146,16 +134,16 @@
     "cli-table3": "^0.6.5",
     "commander": "^14.0.2",
     "fast-glob": "^3.3.3",
-    "minimatch": "^10.1.1",
+    "minimatch": "^10.1.2",
     "ms": "^2.1.3",
     "pretty-ms": "^9.2.0",
     "simple-git": "^3.30.0",
     "yaml": "^2.8.2",
-    "@lumenflow/core": "2.11.0",
-    "@lumenflow/metrics": "2.11.0",
-    "@lumenflow/memory": "2.11.0",
-    "@lumenflow/initiatives": "2.11.0",
-    "@lumenflow/agent": "2.11.0"
+    "@lumenflow/core": "2.12.0",
+    "@lumenflow/metrics": "2.12.0",
+    "@lumenflow/agent": "2.12.0",
+    "@lumenflow/memory": "2.12.0",
+    "@lumenflow/initiatives": "2.12.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.17",
@@ -170,9 +158,11 @@
   },
   "scripts": {
     "build": "tsc",
-    "build:dist": "tsc -p tsconfig.build.json",
+    "build:dist": "rm -rf dist && tsc -p tsconfig.build.json",
     "pack:dist": "pnpm pack",
     "clean": "rm -rf dist *.tgz",
-    "test": "vitest run"
+    "test": "vitest run",
+    "lint": "eslint src --quiet --rule no-console:off --rule @typescript-eslint/no-unused-vars:off --rule sonarjs/concise-regex:off",
+    "typecheck": "tsc --noEmit"
   }
 }

package/templates/core/.husky/pre-commit.template

@@ -30,8 +30,8 @@ case "$BRANCH" in tmp/*) exit 0 ;; esac
 if [ "$LUMENFLOW_FORCE" = "1" ]; then
   if [ -z "$LUMENFLOW_FORCE_REASON" ]; then
     echo "" >&2
-    echo "[pre-commit] Warning: LUMENFLOW_FORCE_REASON not set." >&2
-    echo "Consider: LUMENFLOW_FORCE_REASON=\"reason\" LUMENFLOW_FORCE=1 git commit ..." >&2
+    echo "[pre-commit] Warning: Hook bypass used without a reason." >&2
+    echo "Please provide a reason for the audit trail." >&2
     echo "" >&2
   fi
   # Log bypass to .beacon/ for audit trail
@@ -79,10 +79,10 @@ case "$BRANCH" in
     echo "  - Run:  pnpm wu:help" >&2
     echo "" >&2
     echo "------------------------------------------------------------------" >&2
-    echo "EMERGENCY BYPASS (last resort, logged)" >&2
+    echo "STUCK?" >&2
     echo "------------------------------------------------------------------" >&2
-    echo "Bypasses are audit-logged. Only use for genuine emergencies." >&2
-    echo "  LUMENFLOW_FORCE=1 LUMENFLOW_FORCE_REASON=\"<reason>\" git commit ..." >&2
+    echo "If you need to fix workflow state:" >&2
+    echo "  pnpm wu:recover --id WU-XXXX" >&2
     echo "------------------------------------------------------------------" >&2
     echo "" >&2
     exit 1

package/templates/core/LUMENFLOW.md.template

@@ -132,8 +132,8 @@ LumenFlow enforces safety at the repository level so protections apply to all ag
 - **Git wrapper**: `scripts/safe-git` blocks destructive operations (e.g. `worktree remove`, `reset --hard`, `clean -fd`, `push --force`).
 - **Husky hooks**: staged secret scanning, absolute-path scanning, lockfile sync, and worktree discipline.
 - **Audit logs**:
-  - `.beacon/safety-blocks.log`
-  - `.beacon/force-bypasses.log`
+  - `.lumenflow/safety-blocks.log`
+  - `.lumenflow/force-bypasses.log`
 
 ---
 

package/templates/core/ai/onboarding/agent-safety-card.md.template

@@ -68,8 +68,8 @@ These run for everyone:
 
 Audit logs:
 
-- `.beacon/safety-blocks.log` (blocked safety actions)
-- `.beacon/force-bypasses.log` (LUMENFLOW_FORCE bypasses)
+- `.lumenflow/safety-blocks.log` (blocked safety actions)
+- `.lumenflow/force-bypasses.log` (LUMENFLOW_FORCE bypasses)
 
 ---
 
@@ -162,7 +162,7 @@ Agents MUST stop and ask before using LUMENFLOW_FORCE. Present the situation to
 
 ```
 I need to bypass the safety check for [reason].
-This will be logged to .beacon/force-bypasses.log.
+This will be logged to .lumenflow/force-bypasses.log.
 Do you approve? (yes/no)
 ```
 
@@ -191,7 +191,7 @@ notes: |
 
 ### Audit Log Format
 
-All bypasses are logged to `.beacon/force-bypasses.log`:
+All bypasses are logged to `.lumenflow/force-bypasses.log`:
 
 ```
 ISO_TIMESTAMP|BYPASSED|COMMAND_OR_HOOK|USER|BRANCH|REASON|CWD
@@ -200,7 +200,7 @@ ISO_TIMESTAMP|BYPASSED|COMMAND_OR_HOOK|USER|BRANCH|REASON|CWD
 Example:
 
 ```
-{{DATE}}T12:34:56Z|BYPASSED|git reset --hard HEAD|tom|lane/core/wu-1172|user-approved: recovering state|/home/tom/source/project
+{{DATE}}T12:34:56Z|BYPASSED|git reset --hard HEAD|tom|lane/core/wu-1172|user-approved: recovering state|<cwd>
 ```
 
 ### Warning When No Reason Provided
@@ -329,5 +329,5 @@ ls -la .husky/
 
 # Verify bypass works with audit
 LUMENFLOW_FORCE_REASON="testing" LUMENFLOW_FORCE=1 ./scripts/safe-git --version
-# Should succeed and log to .beacon/force-bypasses.log
+# Should succeed and log to .lumenflow/force-bypasses.log
 ```

package/templates/core/ai/onboarding/lumenflow-force-usage.md.template

@@ -8,7 +8,7 @@ This document presents the findings from WU-1220, investigating improper LUMENFL
 
 ## Executive Summary
 
-Analysis of `.beacon/force-bypasses.log` reveals that LUMENFLOW_FORCE is used extensively, but almost exclusively by human operators (user "Tom") rather than AI agents. The vast majority of uses are for legitimate infrastructure operations such as:
+Analysis of `.lumenflow/force-bypasses.log` reveals that LUMENFLOW_FORCE is used extensively, but almost exclusively by human operators (user "Tom") rather than AI agents. The vast majority of uses are for legitimate infrastructure operations such as:
 
 - Release version pushes
 - Micro-worktree recovery operations
@@ -76,11 +76,11 @@ Analysis of 347 logged bypass events shows:
 
 ### Technical Safeguards
 
-1. **Audit logging:** All bypasses logged to `.beacon/force-bypasses.log` with timestamp, hook, user, branch, reason, and working directory.
+1. **Audit logging:** All bypasses logged to `.lumenflow/force-bypasses.log` with timestamp, hook, user, branch, reason, and working directory.
 
 2. **Warning when no reason:** If LUMENFLOW_FORCE_REASON is not provided, a warning is printed.
 
-3. **Git-tracked audit log:** The `.beacon/force-bypasses.log` file is version controlled, providing historical accountability.
+3. **Git-tracked audit log:** The `.lumenflow/force-bypasses.log` file is version controlled, providing historical accountability.
 
 4. **Hook enforcement:** Pre-commit, commit-msg, pre-push, and prepare-commit-msg hooks all check for LUMENFLOW_FORCE before allowing bypass.
 
@@ -126,7 +126,7 @@ Where `SESSION_TYPE` could be: `human`, `claude-code`, `cursor`, `windsurf`, `un
 
 ### 2. Periodic Audit Review (Process)
 
-Establish a monthly review of `.beacon/force-bypasses.log` to identify:
+Establish a monthly review of `.lumenflow/force-bypasses.log` to identify:
 
 - High volume of "no reason provided" entries
 - Unexpected patterns in bypass usage