@lumenflow/core 3.2.0 → 3.2.2

package/dist/wu-cli-constants.d.ts

@@ -0,0 +1,427 @@
+/**
+ * CLI and Tooling Constants
+ *
+ * WU-1549: Extracted from wu-constants.ts for domain-specific modularity.
+ * Contains CLI flags, package manager commands, ESLint configuration, gate names,
+ * process constants, and external tool configurations.
+ *
+ * @module wu-cli-constants
+ */
+/**
+ * CLI argument flags
+ *
+ * Centralized command-line argument strings to eliminate hardcoded flags.
+ * Used across wu-* scripts, gates, and validation tools.
+ */
+export declare const CLI_FLAGS: {
+    DRY_RUN: string;
+    EXECUTE: string;
+    HELP: string;
+    HELP_SHORT: string;
+    VERBOSE: string;
+    FIX: string;
+    JSON: string;
+    FORCE: string;
+    DOCS_ONLY: string;
+    FULL_LINT: string;
+    FULL_TESTS: string;
+    FULL_COVERAGE: string;
+    COVERAGE_MODE: string;
+    WU: string;
+    ID: string;
+    ALL: string;
+    CHECK: string;
+    TIER: string;
+    AGENT_TYPE: string;
+    DESCRIPTION: string;
+    ACCEPTANCE: string;
+    VALIDATE: string;
+    REASON: string;
+    WEEK: string;
+    SINCE: string;
+};
+/**
+ * pnpm/npm command flags
+ *
+ * Centralized package manager flag strings.
+ */
+export declare const PKG_FLAGS: {
+    FILTER: string;
+    FROZEN_LOCKFILE: string;
+    /** WU-1527: Required for pnpm add at workspace root in monorepos */
+    WORKSPACE_ROOT: string;
+    SAVE_DEV: string;
+    SAVE_EXACT: string;
+};
+/**
+ * ESLint command flags
+ *
+ * Centralized ESLint CLI flag strings.
+ */
+export declare const ESLINT_FLAGS: {
+    MAX_WARNINGS: string;
+    NO_WARN_IGNORED: string;
+    CACHE: string;
+    CACHE_STRATEGY: string;
+    CACHE_LOCATION: string;
+    PASS_ON_UNPRUNED: string;
+};
+/**
+ * pnpm script names
+ *
+ * Centralized script names for package.json commands.
+ */
+export declare const SCRIPTS: {
+    LINT: string;
+    TEST: string;
+    TEST_UNIT: string;
+    BUILD: string;
+    FORMAT: string;
+    FORMAT_CHECK: string;
+    TYPECHECK: string;
+    DEV: string;
+    SPEC_LINTER: string;
+    /** WU-1467: Stub script -- not an enforced gate. Retained for script surface only. */
+    PROMPTS_LINT: string;
+    RUN: string;
+    GATES: string;
+    /** WU-1467: Stub script -- not an enforced gate. Retained for script surface only. */
+    COS_GATES: string;
+    PRETTIER: string;
+    /** WU-1467: Root script surface for tasks:validate (delegates to wu:validate --all) */
+    TASKS_VALIDATE: string;
+};
+/**
+ * Gate names for quality gates
+ *
+ * Centralized gate identifiers for gates.ts and telemetry.
+ */
+export declare const GATE_NAMES: {
+    /** WU-2252: Invariants check (runs first, non-bypassable) */
+    INVARIANTS: string;
+    FORMAT_CHECK: string;
+    SPEC_LINTER: string;
+    /** WU-1467: PROMPTS_LINT removed -- was a stub (exit 0), not an authoritative gate */
+    BACKLOG_SYNC: string;
+    /** WU-2009: Spec-to-code absolute claim drift detector */
+    CLAIM_VALIDATION: string;
+    SUPABASE_DOCS_LINTER: string;
+    LINT: string;
+    TYPECHECK: string;
+    TEST: string;
+    COVERAGE: string;
+    /** WU-2062: Safety-critical tests (always run) */
+    SAFETY_CRITICAL_TEST: string;
+    /** WU-2062: Integration tests (for high-risk changes) */
+    INTEGRATION_TEST: string;
+    /** WU-1191: Lane health check (overlap detection) */
+    LANE_HEALTH: string;
+    /** WU-1315: Onboarding smoke test (init + wu:create validation) */
+    ONBOARDING_SMOKE_TEST: string;
+};
+/**
+ * Gate command sentinels (special values for non-shell commands)
+ *
+ * These are not shell commands but trigger special handling in gates.ts.
+ */
+export declare const GATE_COMMANDS: {
+    /** WU-2252: Triggers invariants check */
+    INVARIANTS: string;
+    /** Triggers incremental lint (only changed files) */
+    INCREMENTAL: string;
+    /** Triggers incremental tests (only tests related to changed files) - WU-1920 */
+    INCREMENTAL_TEST: string;
+    /** Triggers coverage gate check */
+    COVERAGE_GATE: string;
+    /** WU-2062: Triggers safety-critical tests (always run) */
+    SAFETY_CRITICAL_TEST: string;
+    /** WU-2062: Triggers tiered test execution based on risk */
+    TIERED_TEST: string;
+    /** WU-1315: Triggers onboarding smoke test */
+    ONBOARDING_SMOKE_TEST: string;
+};
+/**
+ * CLI mode flags
+ *
+ * Command-line mode arguments.
+ */
+export declare const CLI_MODES: {
+    LOCAL: string;
+};
+/**
+ * Prettier command flags
+ *
+ * Centralized prettier CLI flag strings.
+ */
+export declare const PRETTIER_FLAGS: {
+    WRITE: string;
+};
+/**
+ * Package manager commands
+ *
+ * Centralized pnpm command strings.
+ */
+export declare const PKG_MANAGER = "pnpm";
+/**
+ * Package manager subcommands
+ *
+ * Centralized pnpm subcommand strings.
+ */
+export declare const PKG_COMMANDS: {
+    INSTALL: string;
+    /** WU-1527: Used by lumenflow-upgrade and deps-add */
+    ADD: string;
+    REMOVE: string;
+};
+/**
+ * Package names (monorepo workspaces)
+ *
+ * Centralized package names for --filter usage.
+ * WU-1068: Changed from @exampleapp to @lumenflow for framework reusability.
+ * Project-specific packages should be configured in workspace.yaml.
+ */
+export declare const PACKAGES: {
+    WEB: string;
+    APPLICATION: string;
+    DOMAIN: string;
+    INFRASTRUCTURE: string;
+};
+/**
+ * Process stdio constants
+ *
+ * Standard values for child_process execSync stdio option.
+ */
+export declare const STDIO: {
+    /** Pipe stdout/stderr (capture output) */
+    readonly PIPE: "pipe";
+    /** Inherit stdio from parent process */
+    readonly INHERIT: "inherit";
+    /** Ignore stdio (silent execution) */
+    readonly IGNORE: "ignore";
+};
+/**
+ * Process stdio modes
+ *
+ * Centralized stdio configuration values for child_process operations.
+ */
+export declare const STDIO_MODES: {
+    /** Inherit stdio from parent process (shows output in console) */
+    readonly INHERIT: "inherit";
+    /** Pipe stdio to parent process (capture output) */
+    readonly PIPE: "pipe";
+    /** Ignore stdio (discard output) */
+    readonly IGNORE: "ignore";
+};
+/**
+ * Process exit codes
+ *
+ * Standard exit code values for CLI scripts.
+ */
+export declare const EXIT_CODES: {
+    /** Success exit code */
+    SUCCESS: number;
+    /** Generic error exit code */
+    ERROR: number;
+    /** Fatal or distinct failure exit code */
+    FAILURE: number;
+};
+/**
+ * Stream error codes
+ *
+ * WU-1233: Error codes for stream operations (stdout/stderr).
+ * Used by StreamErrorHandler for graceful pipe closure handling.
+ */
+export declare const STREAM_ERRORS: {
+    /**
+     * EPIPE error code
+     *
+     * Occurs when writing to a pipe whose read end has been closed.
+     * This is normal behavior when CLI output is piped through head/tail.
+     * Unix convention: exit with code 0 on EPIPE (consumer got what it needed).
+     */
+    readonly EPIPE: "EPIPE";
+};
+/**
+ * ESLint command names
+ *
+ * Centralized ESLint command strings.
+ */
+export declare const ESLINT_COMMANDS: {
+    /** ESLint CLI command */
+    ESLINT: string;
+};
+/**
+ * ESLint default values
+ *
+ * Default configuration values for ESLint operations.
+ */
+export declare const ESLINT_DEFAULTS: {
+    /**
+     * Maximum allowed warnings
+     *
+     * WU-1866: Temporarily increased from 0 to 100 to unblock gates.
+     * There are ~82 pre-existing warnings that need proper fixes.
+     */
+    MAX_WARNINGS: string;
+};
+/**
+ * ESLint cache strategy values
+ */
+export declare const CACHE_STRATEGIES: {
+    CONTENT: string;
+    METADATA: string;
+};
+/**
+ * Prettier command arguments
+ *
+ * Centralized prettier CLI arguments.
+ */
+export declare const PRETTIER_ARGS: {
+    /** Check formatting without writing */
+    CHECK: string;
+    /** List files with formatting differences */
+    LIST_DIFFERENT: string;
+};
+/**
+ * Audit command arguments
+ *
+ * Centralized pnpm audit CLI arguments.
+ */
+export declare const AUDIT_ARGS: {
+    /** Audit subcommand */
+    AUDIT: string;
+    /** Audit level flag */
+    AUDIT_LEVEL_MODERATE: string;
+    /** Ignore registry errors */
+    IGNORE_REGISTRY_ERRORS: string;
+    /** Auto-fix flag */
+    FIX: string;
+};
+/**
+ * Common shell commands
+ *
+ * Centralized command names for child_process operations.
+ */
+export declare const SHELL_COMMANDS: {
+    /** Which command (check if executable exists) */
+    WHICH: string;
+    /** Cat command (concatenate files) */
+    CAT: string;
+    /** Node.js executable */
+    NODE: string;
+};
+/**
+ * External tool commands
+ *
+ * Centralized tool command names.
+ */
+export declare const TOOLS: {
+    /** Gitleaks secret scanner */
+    GITLEAKS: string;
+    /** ESLint linter */
+    ESLINT: string;
+    /** Prettier formatter */
+    PRETTIER: string;
+    /** TypeScript compiler */
+    TSC: string;
+};
+/**
+ * Gitleaks command arguments
+ *
+ * Centralized gitleaks CLI arguments.
+ */
+export declare const GITLEAKS_ARGS: {
+    /** Protect mode (scan staged files) */
+    PROTECT: string;
+    /** Staged flag */
+    STAGED: string;
+    /** Verbose output */
+    VERBOSE: string;
+};
+/**
+ * Known package names for vulnerability tracking
+ *
+ * Package identifiers used in dependency auditing.
+ */
+export declare const KNOWN_PACKAGES: {
+    /** node-forge crypto library */
+    NODE_FORGE: string;
+    /** Next.js framework */
+    NEXT: string;
+    /** jsPDF PDF generation library */
+    JSPDF: string;
+};
+/**
+ * Error codes and messages
+ *
+ * Centralized error identifiers for consistency.
+ */
+export declare const ERROR_CODES: {
+    /** Socket timeout error */
+    ERR_SOCKET_TIMEOUT: string;
+    /** Timeout error code */
+    ETIMEDOUT: string;
+};
+/**
+ * Micro-worktree operation identifiers
+ *
+ * WU-923: Centralized operation names for withMicroWorktree()
+ */
+export declare const MICRO_WORKTREE_OPERATIONS: {
+    WU_CREATE: string;
+    WU_EDIT: string;
+    WU_DELETE: string;
+    WU_DONE: string;
+    WU_BLOCK: string;
+    WU_UNBLOCK: string;
+    WU_CLAIM: string;
+    ORPHAN_REPAIR: string;
+    INITIATIVE_EDIT: string;
+    INITIATIVE_BULK_ASSIGN: string;
+    LANE_EDIT: string;
+};
+/**
+ * Telemetry step identifiers
+ *
+ * WU-1584: Centralized telemetry step names to eliminate string literals.
+ */
+export declare const TELEMETRY_STEPS: {
+    GATES: string;
+    /** WU-1467: COS_GATES removed -- was a stub (exit 0), not an authoritative step */
+    PARALLEL_DETECTION: string;
+    PARALLEL_AUTO_REBASE: string;
+};
+/**
+ * WU-1747: Skip gates reason constants
+ */
+export declare const SKIP_GATES_REASONS: {
+    CHECKPOINT_VALID: string;
+};
+/**
+ * WU-1747: Checkpoint-related log messages
+ */
+export declare const CHECKPOINT_MESSAGES: {
+    SKIPPING_GATES_VALID: string;
+    CHECKPOINT_LABEL: string;
+    GATES_PASSED_AT: string;
+    COULD_NOT_CREATE: string;
+};
+/**
+ * Process detection constants for background process warning (WU-1381)
+ *
+ * Used by process-detector.ts to identify processes that may interfere
+ * with wu:done gates execution.
+ */
+export declare const PROCESS_DETECTION: {
+    /**
+     * Process names that commonly interfere with gates execution.
+     * These processes may:
+     * - Write to stdout/stderr (causing mixed output)
+     * - Hold file locks that may cause test failures
+     * - Consume resources that affect gate performance
+     */
+    INTERFERING_NAMES: string[];
+    /** Maximum characters to display for command in warnings */
+    CMD_DISPLAY_LIMIT: number;
+};
+//# sourceMappingURL=wu-cli-constants.d.ts.map

package/dist/wu-cli-constants.d.ts.map

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