@lumenflow/core 3.1.1 → 3.1.3

package/dist/path-classifiers.js

@@ -1,96 +0,0 @@
-#!/usr/bin/env node
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * Path Classification Utilities for WU Tooling
- *
- * WU-1255: Classifies file paths to determine test scoping.
- * Uses string methods (no regex) for path prefix matching.
- *
- * Paths that skip web app tests:
- * - Documentation: docs/, ai/, .claude/, README*, CLAUDE*.md
- * - Tooling: tools/, scripts/
- *
- * @see {@link ./wu-done-paths.js} - Consumer for detectDocsOnlyByPaths
- */
-/**
- * Prefixes for paths that should skip web app tests.
- * These are paths for docs, tooling, and configuration that don't affect app functionality.
- *
- * @constant {string[]}
- */
-export const SKIP_TESTS_PREFIXES = Object.freeze([
-    'docs/',
-    'ai/',
-    '.claude/',
-    'tools/', // WU-1255: Tooling WUs
-    'scripts/', // WU-1255: Scripts WUs
-]);
-/**
- * Root file patterns that should skip web app tests.
- * These are files in the root directory that are documentation.
- *
- * @constant {string[]}
- */
-export const SKIP_TESTS_ROOT_FILES = Object.freeze([
-    'readme', // Case-insensitive match
-    'claude', // CLAUDE.md, CLAUDE-core.md, etc.
-]);
-/**
- * Check if a single file path should skip web app tests.
- *
- * Uses string methods for matching:
- * - `startsWith` for directory prefixes (docs/, tools/, etc.)
- * - `toLowerCase` for case-insensitive root file matching
- *
- * @param {string|null|undefined} filePath - File path to check
- * @returns {boolean} True if path should skip web app tests
- *
- * @example
- * isSkipWebTestsPath('docs/README.md') // true
- * isSkipWebTestsPath('tools/wu-done.js') // true
- * isSkipWebTestsPath('apps/web/src/page.tsx') // false
- */
-export function isSkipWebTestsPath(filePath) {
-    if (!filePath || typeof filePath !== 'string') {
-        return false;
-    }
-    const path = filePath.trim();
-    if (path.length === 0) {
-        return false;
-    }
-    // Check directory prefixes (docs/, ai/, .claude/, tools/, scripts/)
-    for (const prefix of SKIP_TESTS_PREFIXES) {
-        if (path.startsWith(prefix)) {
-            return true;
-        }
-    }
-    // Check root file patterns (README*, CLAUDE*.md)
-    const lowerPath = path.toLowerCase();
-    for (const pattern of SKIP_TESTS_ROOT_FILES) {
-        if (lowerPath.startsWith(pattern)) {
-            return true;
-        }
-    }
-    return false;
-}
-/**
- * Check if ALL code paths should skip web app tests.
- *
- * Returns true only if EVERY path in the array is a skip-tests path.
- * This is the aggregate check for WU YAML code_paths array.
- *
- * @param {string[]|null|undefined} codePaths - Array of file paths from WU YAML
- * @returns {boolean} True if all paths should skip web app tests
- *
- * @example
- * shouldSkipWebTests(['docs/README.md', 'tools/wu-done.js']) // true
- * shouldSkipWebTests(['docs/README.md', 'apps/web/src/page.tsx']) // false
- */
-export function shouldSkipWebTests(codePaths) {
-    if (!codePaths || !Array.isArray(codePaths) || codePaths.length === 0) {
-        return false;
-    }
-    return codePaths.every((path) => isSkipWebTestsPath(path));
-}
-//# sourceMappingURL=path-classifiers.js.map

package/dist/path-classifiers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"path-classifiers.js","sourceRoot":"","sources":["../src/path-classifiers.ts"],"names":[],"mappings":";AACA,iCAAiC;AACjC,yCAAyC;AACzC;;;;;;;;;;;GAWG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,OAAO;IACP,KAAK;IACL,UAAU;IACV,QAAQ,EAAE,uBAAuB;IACjC,UAAU,EAAE,uBAAuB;CACpC,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC;IACjD,QAAQ,EAAE,yBAAyB;IACnC,QAAQ,EAAE,kCAAkC;CAC7C,CAAC,CAAC;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAmB;IACpD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oEAAoE;IACpE,KAAK,MAAM,MAAM,IAAI,mBAAmB,EAAE,CAAC;QACzC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,iDAAiD;IACjD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACrC,KAAK,MAAM,OAAO,IAAI,qBAAqB,EAAE,CAAC;QAC5C,IAAI,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAoB;IACrD,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/patrol-loop.d.ts

@@ -1,171 +0,0 @@
-/**
- * Patrol Loop Module (WU-1242)
- *
- * Continuous patrol loop for monitoring spawn health.
- * The 'Witness patrol' pattern - keeps the spawn fleet healthy by
- * checking status at configurable intervals with exponential backoff
- * on repeated failures.
- *
- * Features:
- * - Configurable patrol interval (default 5min)
- * - Exponential backoff on failures (max 1hr)
- * - Graceful shutdown support
- * - Cycle callbacks for status reporting
- * - Error handling with continuation
- *
- * @see {@link packages/@lumenflow/cli/src/orchestrate-monitor.ts} - CLI integration
- * @see {@link packages/@lumenflow/core/src/__tests__/patrol-loop.test.ts} - Tests
- */
-/**
- * Default patrol interval (5 minutes in milliseconds)
- */
-export declare const DEFAULT_PATROL_INTERVAL_MS: number;
-/**
- * Maximum backoff interval (1 hour in milliseconds)
- */
-export declare const MAX_BACKOFF_MS: number;
-/**
- * Result of a patrol check
- */
-export interface PatrolCheckResult {
-    /** Whether the spawn fleet is healthy (no stuck spawns or zombies) */
-    healthy: boolean;
-    /** Number of stuck spawns detected */
-    stuckCount: number;
-    /** Number of zombie locks detected */
-    zombieCount: number;
-    /** Optional suggestions for recovery */
-    suggestions?: string[];
-}
-/**
- * Metadata passed to cycle callbacks
- */
-export interface CycleMetadata {
-    /** The cycle number (1-indexed) */
-    cycleNumber: number;
-    /** Current interval in milliseconds */
-    intervalMs: number;
-    /** Number of consecutive failures */
-    consecutiveFailures: number;
-    /** Timestamp of the cycle */
-    timestamp: Date;
-}
-/**
- * Callback invoked on each patrol cycle
- */
-export type OnCycleCallback = (result: PatrolCheckResult, meta: CycleMetadata) => void;
-/**
- * Callback invoked when an error occurs
- */
-export type OnErrorCallback = (error: Error, cycleNumber: number) => void;
-/**
- * Options for creating a PatrolLoop
- */
-export interface PatrolLoopOptions {
-    /**
-     * Function to check spawn health
-     */
-    checkFn: () => Promise<PatrolCheckResult>;
-    /**
-     * Patrol interval in milliseconds (default: 5 minutes)
-     */
-    intervalMs?: number;
-    /**
-     * Callback invoked after each patrol cycle
-     */
-    onCycle?: OnCycleCallback;
-    /**
-     * Callback invoked when checkFn throws an error
-     */
-    onError?: OnErrorCallback;
-}
-/**
- * Calculates the backoff interval based on consecutive failures.
- * Uses exponential backoff with a maximum of 1 hour.
- *
- * Backoff formula: baseInterval * 2^(failures-1), capped at MAX_BACKOFF_MS
- *
- * @param consecutiveFailures - Number of consecutive failures (1-indexed)
- * @param baseIntervalMs - Base interval in milliseconds
- * @returns Backoff interval in milliseconds
- *
- * @example
- * calculateBackoff(1, 5*60*1000) // 5 minutes (no backoff yet)
- * calculateBackoff(2, 5*60*1000) // 10 minutes (2x)
- * calculateBackoff(3, 5*60*1000) // 20 minutes (4x)
- */
-export declare function calculateBackoff(consecutiveFailures: number, baseIntervalMs: number): number;
-/**
- * Patrol loop for continuous spawn monitoring.
- *
- * @example
- * const patrol = new PatrolLoop({
- *   checkFn: async () => {
- *     const result = await runMonitor();
- *     return {
- *       healthy: result.stuckSpawns.length === 0,
- *       stuckCount: result.stuckSpawns.length,
- *       zombieCount: result.zombieLocks.length,
- *     };
- *   },
- *   intervalMs: 5 * 60 * 1000, // 5 minutes
- *   onCycle: (result, meta) => {
- *     console.log(`Cycle ${meta.cycleNumber}: ${result.healthy ? 'healthy' : 'issues detected'}`);
- *   },
- * });
- *
- * patrol.start();
- * // Later...
- * patrol.stop();
- */
-export declare class PatrolLoop {
-    private readonly checkFn;
-    private readonly baseIntervalMs;
-    private readonly onCycle?;
-    private readonly onError?;
-    private timer;
-    private running;
-    private failures;
-    private cycles;
-    /**
-     * Creates a new PatrolLoop instance.
-     *
-     * @param options - Patrol loop configuration
-     */
-    constructor(options: PatrolLoopOptions);
-    /**
-     * The configured base interval in milliseconds.
-     */
-    get intervalMs(): number;
-    /**
-     * Whether the patrol loop is currently running.
-     */
-    get isRunning(): boolean;
-    /**
-     * Number of consecutive failures (resets on success).
-     */
-    get consecutiveFailures(): number;
-    /**
-     * Total number of completed patrol cycles.
-     */
-    get totalCycles(): number;
-    /**
-     * Starts the patrol loop.
-     * Does nothing if already running.
-     */
-    start(): void;
-    /**
-     * Stops the patrol loop.
-     * Safe to call even if not running.
-     */
-    stop(): void;
-    /**
-     * Schedules the next patrol cycle.
-     */
-    private scheduleNextCycle;
-    /**
-     * Runs a single patrol cycle.
-     */
-    private runCycle;
-}
-//# sourceMappingURL=patrol-loop.d.ts.map

package/dist/patrol-loop.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"patrol-loop.d.ts","sourceRoot":"","sources":["../src/patrol-loop.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;GAEG;AACH,eAAO,MAAM,0BAA0B,QAAgB,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,cAAc,QAAiB,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,6BAA6B;IAC7B,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;AAEvF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE1C;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;IAE1B;;OAEG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,mBAAmB,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAW5F;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAkB;IAE3C,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,MAAM,CAAK;IAEnB;;;;OAIG;gBACS,OAAO,EAAE,iBAAiB;IAOtC;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,mBAAmB,IAAI,MAAM,CAEhC;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;;OAGG;IACH,KAAK,IAAI,IAAI;IASb;;;OAGG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;OAEG;YACW,QAAQ;CAkCvB"}

package/dist/patrol-loop.js

@@ -1,197 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * Patrol Loop Module (WU-1242)
- *
- * Continuous patrol loop for monitoring spawn health.
- * The 'Witness patrol' pattern - keeps the spawn fleet healthy by
- * checking status at configurable intervals with exponential backoff
- * on repeated failures.
- *
- * Features:
- * - Configurable patrol interval (default 5min)
- * - Exponential backoff on failures (max 1hr)
- * - Graceful shutdown support
- * - Cycle callbacks for status reporting
- * - Error handling with continuation
- *
- * @see {@link packages/@lumenflow/cli/src/orchestrate-monitor.ts} - CLI integration
- * @see {@link packages/@lumenflow/core/src/__tests__/patrol-loop.test.ts} - Tests
- */
-/**
- * Default patrol interval (5 minutes in milliseconds)
- */
-export const DEFAULT_PATROL_INTERVAL_MS = 5 * 60 * 1000;
-/**
- * Maximum backoff interval (1 hour in milliseconds)
- */
-export const MAX_BACKOFF_MS = 60 * 60 * 1000;
-/**
- * Calculates the backoff interval based on consecutive failures.
- * Uses exponential backoff with a maximum of 1 hour.
- *
- * Backoff formula: baseInterval * 2^(failures-1), capped at MAX_BACKOFF_MS
- *
- * @param consecutiveFailures - Number of consecutive failures (1-indexed)
- * @param baseIntervalMs - Base interval in milliseconds
- * @returns Backoff interval in milliseconds
- *
- * @example
- * calculateBackoff(1, 5*60*1000) // 5 minutes (no backoff yet)
- * calculateBackoff(2, 5*60*1000) // 10 minutes (2x)
- * calculateBackoff(3, 5*60*1000) // 20 minutes (4x)
- */
-export function calculateBackoff(consecutiveFailures, baseIntervalMs) {
-    if (consecutiveFailures <= 1) {
-        return baseIntervalMs;
-    }
-    // Exponential backoff: baseInterval * 2^(failures-1)
-    const multiplier = Math.pow(2, consecutiveFailures - 1);
-    const backoffMs = baseIntervalMs * multiplier;
-    // Cap at maximum backoff
-    return Math.min(backoffMs, MAX_BACKOFF_MS);
-}
-/**
- * Patrol loop for continuous spawn monitoring.
- *
- * @example
- * const patrol = new PatrolLoop({
- *   checkFn: async () => {
- *     const result = await runMonitor();
- *     return {
- *       healthy: result.stuckSpawns.length === 0,
- *       stuckCount: result.stuckSpawns.length,
- *       zombieCount: result.zombieLocks.length,
- *     };
- *   },
- *   intervalMs: 5 * 60 * 1000, // 5 minutes
- *   onCycle: (result, meta) => {
- *     console.log(`Cycle ${meta.cycleNumber}: ${result.healthy ? 'healthy' : 'issues detected'}`);
- *   },
- * });
- *
- * patrol.start();
- * // Later...
- * patrol.stop();
- */
-export class PatrolLoop {
-    checkFn;
-    baseIntervalMs;
-    onCycle;
-    onError;
-    timer = null;
-    running = false;
-    failures = 0;
-    cycles = 0;
-    /**
-     * Creates a new PatrolLoop instance.
-     *
-     * @param options - Patrol loop configuration
-     */
-    constructor(options) {
-        this.checkFn = options.checkFn;
-        this.baseIntervalMs = options.intervalMs ?? DEFAULT_PATROL_INTERVAL_MS;
-        this.onCycle = options.onCycle;
-        this.onError = options.onError;
-    }
-    /**
-     * The configured base interval in milliseconds.
-     */
-    get intervalMs() {
-        return this.baseIntervalMs;
-    }
-    /**
-     * Whether the patrol loop is currently running.
-     */
-    get isRunning() {
-        return this.running;
-    }
-    /**
-     * Number of consecutive failures (resets on success).
-     */
-    get consecutiveFailures() {
-        return this.failures;
-    }
-    /**
-     * Total number of completed patrol cycles.
-     */
-    get totalCycles() {
-        return this.cycles;
-    }
-    /**
-     * Starts the patrol loop.
-     * Does nothing if already running.
-     */
-    start() {
-        if (this.running) {
-            return; // Already running, don't create duplicate timers
-        }
-        this.running = true;
-        this.scheduleNextCycle();
-    }
-    /**
-     * Stops the patrol loop.
-     * Safe to call even if not running.
-     */
-    stop() {
-        this.running = false;
-        if (this.timer) {
-            clearTimeout(this.timer);
-            this.timer = null;
-        }
-    }
-    /**
-     * Schedules the next patrol cycle.
-     */
-    scheduleNextCycle() {
-        if (!this.running) {
-            return;
-        }
-        const intervalMs = calculateBackoff(this.failures, this.baseIntervalMs);
-        this.timer = setTimeout(() => {
-            // WU-1551: Add .catch() to prevent unhandled promise rejections
-            void this.runCycle()
-                .then(() => this.scheduleNextCycle())
-                .catch(() => {
-                // Error already handled in runCycle's try/catch.
-                // This .catch() is a safety net to prevent unhandled rejections
-                // if runCycle itself throws before reaching its try/catch.
-                this.scheduleNextCycle();
-            });
-        }, intervalMs);
-    }
-    /**
-     * Runs a single patrol cycle.
-     */
-    async runCycle() {
-        if (!this.running) {
-            return;
-        }
-        this.cycles++;
-        const cycleNumber = this.cycles;
-        try {
-            const result = await this.checkFn();
-            // Success - reset failure count
-            this.failures = 0;
-            // Call cycle callback
-            if (this.onCycle) {
-                const meta = {
-                    cycleNumber,
-                    intervalMs: this.baseIntervalMs,
-                    consecutiveFailures: this.failures,
-                    timestamp: new Date(),
-                };
-                this.onCycle(result, meta);
-            }
-        }
-        catch (error) {
-            // Failure - increment failure count
-            this.failures++;
-            // Call error callback
-            if (this.onError) {
-                this.onError(error instanceof Error ? error : new Error(String(error)), cycleNumber);
-            }
-        }
-    }
-}
-//# sourceMappingURL=patrol-loop.js.map

package/dist/patrol-loop.js.map

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

package/dist/piped-command-detector.d.ts

@@ -1,25 +0,0 @@
-/**
- * Check if a command is a piped pnpm dependency command
- *
- * Detects patterns like:
- * - echo "y" | pnpm add foo
- * - yes | pnpm install
- * - pnpm add foo < /dev/null
- * - pnpm install <<< "y"
- *
- * Does NOT flag:
- * - pnpm test | grep foo (pnpm not receiving input)
- * - pnpm add foo (no pipe)
- *
- * @param {string} command - Shell command to analyze
- * @returns {boolean} True if command is a piped pnpm dependency command
- */
-export declare function isPipedPnpmCommand(command: UnsafeAny): boolean;
-/**
- * Check if a command contains UnsafeAny dependency-mutating pnpm subcommand
- *
- * @param {string} command - Shell command to analyze
- * @returns {boolean} True if command contains pnpm dependency mutation
- */
-export declare function containsPnpmDependencyCommand(command: UnsafeAny): boolean;
-//# sourceMappingURL=piped-command-detector.d.ts.map

package/dist/piped-command-detector.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"piped-command-detector.d.ts","sourceRoot":"","sources":["../src/piped-command-detector.ts"],"names":[],"mappings":"AAoBA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,WAqBpD;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,SAAS,WAQ/D"}

package/dist/piped-command-detector.js

@@ -1,67 +0,0 @@
-// Copyright (c) 2026 Hellmai Ltd
-// SPDX-License-Identifier: AGPL-3.0-only
-/**
- * WU-2278: Piped Command Detection
- *
- * Detects when pnpm dependency commands are being executed with piped input,
- * which can bypass interactive prompts and cause security issues.
- *
- * Note: No external library exists for this specific shell command analysis.
- *
- * @module piped-command-detector
- */
-/**
- * List of pnpm commands that mutate dependencies
- * @constant {string[]}
- */
-const DEPENDENCY_COMMANDS = ['add', 'install', 'i', 'remove', 'rm', 'uninstall', 'update', 'up'];
-/**
- * Check if a command is a piped pnpm dependency command
- *
- * Detects patterns like:
- * - echo "y" | pnpm add foo
- * - yes | pnpm install
- * - pnpm add foo < /dev/null
- * - pnpm install <<< "y"
- *
- * Does NOT flag:
- * - pnpm test | grep foo (pnpm not receiving input)
- * - pnpm add foo (no pipe)
- *
- * @param {string} command - Shell command to analyze
- * @returns {boolean} True if command is a piped pnpm dependency command
- */
-export function isPipedPnpmCommand(command) {
-    if (!command || typeof command !== 'string') {
-        return false;
-    }
-    // Pattern 1: Something piped TO pnpm (before pnpm in command)
-    // e.g., "echo y | pnpm add", "yes | pnpm install"
-    const pipeToPattern = /\|\s*pnpm\s+(add|install|i|remove|rm|uninstall|update|up)\b/i;
-    if (pipeToPattern.test(command)) {
-        return true;
-    }
-    // Pattern 2: Input redirection (< or <<<)
-    // e.g., "pnpm add foo < /dev/null", "pnpm install <<< y"
-    const redirectPattern = /pnpm\s+(add|install|i|remove|rm|uninstall|update|up)\b[^|]*<(?!<)/i;
-    const heredocPattern = /pnpm\s+(add|install|i|remove|rm|uninstall|update|up)\b[^|]*<<</i;
-    if (redirectPattern.test(command) || heredocPattern.test(command)) {
-        return true;
-    }
-    return false;
-}
-/**
- * Check if a command contains UnsafeAny dependency-mutating pnpm subcommand
- *
- * @param {string} command - Shell command to analyze
- * @returns {boolean} True if command contains pnpm dependency mutation
- */
-export function containsPnpmDependencyCommand(command) {
-    if (!command || typeof command !== 'string') {
-        return false;
-    }
-    // eslint-disable-next-line security/detect-non-literal-regexp -- command names from internal constant array, not user input
-    const pattern = new RegExp(`pnpm\\s+(${DEPENDENCY_COMMANDS.join('|')})\\b`, 'i');
-    return pattern.test(command);
-}
-//# sourceMappingURL=piped-command-detector.js.map

package/dist/piped-command-detector.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"piped-command-detector.js","sourceRoot":"","sources":["../src/piped-command-detector.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;GASG;AAEH;;;GAGG;AACH,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;AAEjG;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAkB;IACnD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8DAA8D;IAC9D,kDAAkD;IAClD,MAAM,aAAa,GAAG,8DAA8D,CAAC;IACrF,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0CAA0C;IAC1C,yDAAyD;IACzD,MAAM,eAAe,GAAG,oEAAoE,CAAC;IAC7F,MAAM,cAAc,GAAG,iEAAiE,CAAC;IACzF,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAClE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,OAAkB;IAC9D,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,4HAA4H;IAC5H,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,YAAY,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjF,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC"}