@lumenflow/cli 2.4.0 → 2.5.1

package/dist/file-delete.d.ts

@@ -1,84 +0,0 @@
-#!/usr/bin/env node
-/**
- * File Delete CLI Tool
- *
- * Provides audited file delete operations with:
- * - Scope checking against WU code_paths
- * - Recursive directory deletion
- * - Force option for missing files
- * - Audit logging
- *
- * Usage:
- *   node file-delete.js <path> [--recursive] [--force]
- *
- * WU-1108: INIT-003 Phase 4a - Migrate file operations
- */
-/**
- * Default configuration for file delete operations
- */
-export declare const FILE_DELETE_DEFAULTS: {
-    /** Delete directories recursively */
-    recursive: boolean;
-    /** Don't error on missing files */
-    force: boolean;
-};
-/**
- * Arguments for file delete operation
- */
-export interface FileDeleteArgs {
-    /** Path to file or directory to delete */
-    path?: string;
-    /** Delete directories recursively */
-    recursive?: boolean;
-    /** Don't error on missing files */
-    force?: boolean;
-    /** Show help */
-    help?: boolean;
-}
-/**
- * Metadata returned with file delete
- */
-export interface FileDeleteMetadata {
-    /** Number of items deleted (files + directories) */
-    deletedCount: number;
-    /** Whether target was a directory */
-    wasDirectory: boolean;
-}
-/**
- * Audit log entry for file operations
- */
-export interface AuditLogEntry {
-    /** Operation type */
-    operation: 'read' | 'write' | 'edit' | 'delete';
-    /** File path */
-    path: string;
-    /** Timestamp */
-    timestamp: string;
-    /** Duration in ms */
-    durationMs?: number;
-    /** Success status */
-    success: boolean;
-    /** Error message if failed */
-    error?: string;
-}
-/**
- * Result of file delete operation
- */
-export interface FileDeleteResult {
-    /** Whether operation succeeded */
-    success: boolean;
-    /** Error message (if failed) */
-    error?: string;
-    /** Delete metadata */
-    metadata?: FileDeleteMetadata;
-    /** Audit log entry */
-    auditLog?: AuditLogEntry;
-}
-/**
- * Parse command line arguments for file-delete
- */
-export declare function parseFileDeleteArgs(argv: string[]): FileDeleteArgs;
-/**
- * Delete a file or directory with audit logging and safety checks
- */
-export declare function deleteFileWithAudit(args: FileDeleteArgs): Promise<FileDeleteResult>;

package/dist/file-edit.d.ts

@@ -1,82 +0,0 @@
-#!/usr/bin/env node
-/**
- * File Edit CLI Tool
- *
- * Provides audited file edit operations with:
- * - Scope checking against WU code_paths
- * - Exact string replacement
- * - Uniqueness validation
- * - Replace-all support
- * - Audit logging
- *
- * Usage:
- *   node file-edit.js <path> --old-string <old> --new-string <new> [--replace-all]
- *
- * WU-1108: INIT-003 Phase 4a - Migrate file operations
- */
-/**
- * Default configuration for file edit operations
- */
-export declare const FILE_EDIT_DEFAULTS: {
-    /** Default encoding */
-    encoding: BufferEncoding;
-    /** Replace all occurrences (default: false - requires unique match) */
-    replaceAll: boolean;
-};
-/**
- * Arguments for file edit operation
- */
-export interface FileEditArgs {
-    /** Path to file to edit */
-    path?: string;
-    /** String to find */
-    oldString?: string;
-    /** String to replace with */
-    newString?: string;
-    /** File encoding */
-    encoding?: BufferEncoding;
-    /** Replace all occurrences */
-    replaceAll?: boolean;
-    /** Show help */
-    help?: boolean;
-}
-/**
- * Audit log entry for file operations
- */
-export interface AuditLogEntry {
-    /** Operation type */
-    operation: 'read' | 'write' | 'edit' | 'delete';
-    /** File path */
-    path: string;
-    /** Timestamp */
-    timestamp: string;
-    /** Duration in ms */
-    durationMs?: number;
-    /** Success status */
-    success: boolean;
-    /** Error message if failed */
-    error?: string;
-}
-/**
- * Result of file edit operation
- */
-export interface FileEditResult {
-    /** Whether operation succeeded */
-    success: boolean;
-    /** Error message (if failed) */
-    error?: string;
-    /** Number of replacements made */
-    replacements?: number;
-    /** Diff preview */
-    diff?: string;
-    /** Audit log entry */
-    auditLog?: AuditLogEntry;
-}
-/**
- * Parse command line arguments for file-edit
- */
-export declare function parseFileEditArgs(argv: string[]): FileEditArgs;
-/**
- * Edit a file with audit logging and safety checks
- */
-export declare function editFileWithAudit(args: FileEditArgs): Promise<FileEditResult>;

package/dist/file-read.d.ts

@@ -1,92 +0,0 @@
-#!/usr/bin/env node
-/**
- * File Read CLI Tool
- *
- * Provides audited file read operations with:
- * - Scope checking against WU code_paths
- * - File size limits
- * - Line range support
- * - Audit logging
- *
- * Usage:
- *   node file-read.js <path> [--encoding utf-8] [--start-line N] [--end-line M]
- *
- * WU-1108: INIT-003 Phase 4a - Migrate file operations
- */
-/**
- * Default configuration for file read operations
- */
-export declare const FILE_READ_DEFAULTS: {
-    /** Maximum file size in bytes (10MB) */
-    maxFileSizeBytes: number;
-    /** Default encoding */
-    encoding: BufferEncoding;
-};
-/**
- * Arguments for file read operation
- */
-export interface FileReadArgs {
-    /** Path to file to read */
-    path?: string;
-    /** File encoding */
-    encoding?: BufferEncoding;
-    /** Start line (1-based, inclusive) */
-    startLine?: number;
-    /** End line (1-based, inclusive) */
-    endLine?: number;
-    /** Maximum file size in bytes */
-    maxFileSizeBytes?: number;
-    /** Show help */
-    help?: boolean;
-}
-/**
- * Metadata returned with file read
- */
-export interface FileReadMetadata {
-    /** File size in bytes */
-    sizeBytes: number;
-    /** Total line count */
-    lineCount: number;
-    /** Lines returned (if subset) */
-    linesReturned?: number;
-}
-/**
- * Audit log entry for file operations
- */
-export interface AuditLogEntry {
-    /** Operation type */
-    operation: 'read' | 'write' | 'edit' | 'delete';
-    /** File path */
-    path: string;
-    /** Timestamp */
-    timestamp: string;
-    /** Duration in ms */
-    durationMs?: number;
-    /** Success status */
-    success: boolean;
-    /** Error message if failed */
-    error?: string;
-}
-/**
- * Result of file read operation
- */
-export interface FileReadResult {
-    /** Whether operation succeeded */
-    success: boolean;
-    /** File content (if successful) */
-    content?: string;
-    /** Error message (if failed) */
-    error?: string;
-    /** File metadata */
-    metadata?: FileReadMetadata;
-    /** Audit log entry */
-    auditLog?: AuditLogEntry;
-}
-/**
- * Parse command line arguments for file-read
- */
-export declare function parseFileReadArgs(argv: string[]): FileReadArgs;
-/**
- * Read a file with audit logging and safety checks
- */
-export declare function readFileWithAudit(args: FileReadArgs): Promise<FileReadResult>;

package/dist/file-write.d.ts

@@ -1,90 +0,0 @@
-#!/usr/bin/env node
-/**
- * File Write CLI Tool
- *
- * Provides audited file write operations with:
- * - Scope checking against WU code_paths
- * - PHI scanning (optional)
- * - Directory creation
- * - Audit logging
- *
- * Usage:
- *   node file-write.js <path> --content <content> [--encoding utf-8]
- *
- * WU-1108: INIT-003 Phase 4a - Migrate file operations
- */
-/**
- * Default configuration for file write operations
- */
-export declare const FILE_WRITE_DEFAULTS: {
-    /** Default encoding */
-    encoding: BufferEncoding;
-    /** Create parent directories if they don't exist */
-    createDirectories: boolean;
-};
-/**
- * Arguments for file write operation
- */
-export interface FileWriteArgs {
-    /** Path to file to write */
-    path?: string;
-    /** Content to write */
-    content?: string;
-    /** File encoding */
-    encoding?: BufferEncoding;
-    /** Create parent directories */
-    createDirectories?: boolean;
-    /** Scan content for PHI */
-    scanPHI?: boolean;
-    /** Show help */
-    help?: boolean;
-}
-/**
- * Metadata returned with file write
- */
-export interface FileWriteMetadata {
-    /** Bytes written */
-    bytesWritten: number;
-    /** Whether directories were created */
-    directoriesCreated?: boolean;
-}
-/**
- * Audit log entry for file operations
- */
-export interface AuditLogEntry {
-    /** Operation type */
-    operation: 'read' | 'write' | 'edit' | 'delete';
-    /** File path */
-    path: string;
-    /** Timestamp */
-    timestamp: string;
-    /** Duration in ms */
-    durationMs?: number;
-    /** Success status */
-    success: boolean;
-    /** Error message if failed */
-    error?: string;
-}
-/**
- * Result of file write operation
- */
-export interface FileWriteResult {
-    /** Whether operation succeeded */
-    success: boolean;
-    /** Error message (if failed) */
-    error?: string;
-    /** Warnings (e.g., PHI detected) */
-    warnings?: string[];
-    /** File metadata */
-    metadata?: FileWriteMetadata;
-    /** Audit log entry */
-    auditLog?: AuditLogEntry;
-}
-/**
- * Parse command line arguments for file-write
- */
-export declare function parseFileWriteArgs(argv: string[]): FileWriteArgs;
-/**
- * Write a file with audit logging and safety checks
- */
-export declare function writeFileWithAudit(args: FileWriteArgs): Promise<FileWriteResult>;

package/dist/flow-bottlenecks.d.ts

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-/**
- * Flow Bottlenecks Analysis CLI (WU-1018)
- *
- * Analyzes WU dependency graph to identify bottlenecks and critical paths.
- *
- * Usage:
- *   pnpm flow:bottlenecks                   # Default: top 10 bottlenecks, JSON output
- *   pnpm flow:bottlenecks --limit 5         # Top 5 bottlenecks
- *   pnpm flow:bottlenecks --format table    # Table output
- *   pnpm flow:bottlenecks --format mermaid  # Mermaid diagram of critical path
- *
- * @module flow-bottlenecks
- * @see {@link @lumenflow/metrics/flow/analyze-bottlenecks}
- */
-export {};

package/dist/flow-report.d.ts

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-/**
- * Flow Report Generator CLI (WU-1018)
- *
- * Generates DORA/SPACE flow reports from telemetry and WU data.
- *
- * Usage:
- *   pnpm flow:report                         # Default: last 7 days, JSON output
- *   pnpm flow:report --days 30               # Last 30 days
- *   pnpm flow:report --format table          # Table output
- *   pnpm flow:report --start 2026-01-01 --end 2026-01-15
- *
- * @module flow-report
- * @see {@link @lumenflow/metrics/flow/generate-flow-report}
- */
-export {};

package/dist/gates.d.ts

@@ -1,94 +0,0 @@
-#!/usr/bin/env node
-/**
- * Quality Gates Runner
- *
- * Runs quality gates with support for docs-only mode and incremental linting.
- *
- * WU-1304: Optimise ESLint gates performance
- * - Uses incremental linting (only files changed since branching from main)
- * - Full lint coverage maintained via CI workflow
- *
- * WU-1433: Coverage gate with mode flag
- * - Checks coverage thresholds for hex core files (≥90% for application layer)
- * - Mode: block (default) fails the gate, warn logs warnings only
- * WU-2334: Changed default from warn to block for TDD enforcement
- *
- * WU-1610: Supabase docs linter
- * - Verifies every table in migrations is documented in schema.md
- * - Fails if any table is missing documentation
- *
- * For type:documentation WUs:
- * - ✅ Run: format:check, spec:linter, prompts:lint, backlog-sync
- * - ❌ Skip: lint, typecheck, supabase-docs:linter, tests, coverage (no code changed)
- *
- * WU-1920: Incremental test execution
- * - Uses Vitest's --changed flag to run only tests for changed files
- * - Full test suite maintained via CI workflow and --full-tests flag
- *
- * WU-2062: Tiered test execution for faster wu:done
- * - Safety-critical tests (PHI, escalation, red-flag) ALWAYS run
- * - Docs-only WUs: lint/typecheck only (auto-detected or --docs-only flag)
- * - High-risk WUs (auth, PHI, RLS, migrations): run integration tests
- * - Standard WUs: changed tests + safety-critical tests
- *
- * Usage:
- *   node tools/gates.mjs                        # Tiered gates (default)
- *   node tools/gates.mjs --docs-only            # Docs-only gates
- *   node tools/gates.mjs --full-lint            # Full lint (bypass incremental)
- *   node tools/gates.mjs --full-tests           # Full tests (bypass incremental)
- *   node tools/gates.mjs --coverage-mode=block  # Coverage gate in block mode
- */
-/**
- * WU-1087: Gates-specific option definitions for createWUParser.
- * Exported for testing and consistency with other CLI commands.
- */
-export declare const GATES_OPTIONS: {
-    docsOnly: {
-        name: string;
-        flags: string;
-        description: string;
-    };
-    fullLint: {
-        name: string;
-        flags: string;
-        description: string;
-    };
-    fullTests: {
-        name: string;
-        flags: string;
-        description: string;
-    };
-    fullCoverage: {
-        name: string;
-        flags: string;
-        description: string;
-    };
-    coverageMode: {
-        name: string;
-        flags: string;
-        description: string;
-        default: string;
-    };
-    verbose: {
-        name: string;
-        flags: string;
-        description: string;
-    };
-};
-/**
- * WU-1087: Parse gates options using createWUParser for consistency.
- * Handles pnpm's `--` separator and provides automatic --help support.
- *
- * @returns Parsed options object
- */
-export declare function parseGatesOptions(): {
-    docsOnly?: boolean;
-    fullLint?: boolean;
-    fullTests?: boolean;
-    fullCoverage?: boolean;
-    coverageMode: string;
-    verbose?: boolean;
-};
-export declare function parsePrettierListOutput(output: string): string[];
-export declare function buildPrettierWriteCommand(files: string[]): string;
-export declare function formatFormatCheckGuidance(files: string[]): string[];

package/dist/git-branch.d.ts

@@ -1,65 +0,0 @@
-#!/usr/bin/env node
-/**
- * Git Branch CLI Tool
- *
- * Provides WU-aware git branch with:
- * - Branch listing (local, remote, all)
- * - Current branch detection
- * - Contains filtering
- *
- * Usage:
- *   node git-branch.js [--list] [-a] [-r] [--show-current]
- *
- * WU-1109: INIT-003 Phase 4b - Migrate git operations
- */
-/**
- * Arguments for git branch operation
- */
-export interface GitBranchArgs {
-    /** Base directory for git operations */
-    baseDir?: string;
-    /** List branches */
-    list?: boolean;
-    /** Show all branches (local and remote) */
-    all?: boolean;
-    /** Show only remote branches */
-    remotes?: boolean;
-    /** Show current branch only */
-    showCurrent?: boolean;
-    /** Filter branches containing commit */
-    contains?: string;
-    /** Show help */
-    help?: boolean;
-}
-/**
- * Branch information
- */
-export interface BranchInfo {
-    /** Branch name */
-    name: string;
-    /** Whether this is the current branch */
-    isCurrent: boolean;
-    /** Whether this is a remote branch */
-    isRemote: boolean;
-}
-/**
- * Result of git branch operation
- */
-export interface GitBranchResult {
-    /** Whether operation succeeded */
-    success: boolean;
-    /** Error message (if failed) */
-    error?: string;
-    /** Current branch name */
-    current?: string;
-    /** List of branches */
-    branches?: BranchInfo[];
-}
-/**
- * Parse command line arguments for git-branch
- */
-export declare function parseGitBranchArgs(argv: string[]): GitBranchArgs;
-/**
- * Get git branch information
- */
-export declare function getGitBranch(args: GitBranchArgs): Promise<GitBranchResult>;

package/dist/git-diff.d.ts

@@ -1,58 +0,0 @@
-#!/usr/bin/env node
-/**
- * Git Diff CLI Tool
- *
- * Provides WU-aware git diff with:
- * - Staged/cached diff support
- * - Name-only and stat output modes
- * - File filtering
- *
- * Usage:
- *   node git-diff.js [ref] [--staged] [--name-only] [--stat]
- *
- * WU-1109: INIT-003 Phase 4b - Migrate git operations
- */
-/**
- * Arguments for git diff operation
- */
-export interface GitDiffArgs {
-    /** Base directory for git operations */
-    baseDir?: string;
-    /** Reference to diff against */
-    ref?: string;
-    /** Show staged changes */
-    staged?: boolean;
-    /** Show only file names */
-    nameOnly?: boolean;
-    /** Show diffstat */
-    stat?: boolean;
-    /** Path to filter diff */
-    path?: string;
-    /** Show help */
-    help?: boolean;
-}
-/**
- * Result of git diff operation
- */
-export interface GitDiffResult {
-    /** Whether operation succeeded */
-    success: boolean;
-    /** Error message (if failed) */
-    error?: string;
-    /** Whether there are any differences */
-    hasDiff?: boolean;
-    /** Diff output */
-    diff?: string;
-    /** List of files (for name-only mode) */
-    files?: string[];
-    /** Diffstat output (for stat mode) */
-    stat?: string;
-}
-/**
- * Parse command line arguments for git-diff
- */
-export declare function parseGitDiffArgs(argv: string[]): GitDiffArgs;
-/**
- * Get git diff with audit logging
- */
-export declare function getGitDiff(args: GitDiffArgs): Promise<GitDiffResult>;

package/dist/git-log.d.ts

@@ -1,69 +0,0 @@
-#!/usr/bin/env node
-/**
- * Git Log CLI Tool
- *
- * Provides WU-aware git log with:
- * - Oneline and custom format output
- * - Max count limiting
- * - Date and author filtering
- *
- * Usage:
- *   node git-log.js [ref] [--oneline] [-n <count>] [--format <format>]
- *
- * WU-1109: INIT-003 Phase 4b - Migrate git operations
- */
-/**
- * Arguments for git log operation
- */
-export interface GitLogArgs {
-    /** Base directory for git operations */
-    baseDir?: string;
-    /** Reference or range (e.g., main..feature) */
-    ref?: string;
-    /** Use oneline format */
-    oneline?: boolean;
-    /** Maximum number of commits */
-    maxCount?: number;
-    /** Custom format string */
-    format?: string;
-    /** Show commits since date */
-    since?: string;
-    /** Filter by author */
-    author?: string;
-    /** Show help */
-    help?: boolean;
-}
-/**
- * Commit information
- */
-export interface CommitInfo {
-    /** Commit hash */
-    hash: string;
-    /** Commit message */
-    message: string;
-    /** Author name */
-    author?: string;
-    /** Author date */
-    date?: string;
-}
-/**
- * Result of git log operation
- */
-export interface GitLogResult {
-    /** Whether operation succeeded */
-    success: boolean;
-    /** Error message (if failed) */
-    error?: string;
-    /** Parsed commits */
-    commits: CommitInfo[];
-    /** Raw output (for oneline/custom format) */
-    output?: string;
-}
-/**
- * Parse command line arguments for git-log
- */
-export declare function parseGitLogArgs(argv: string[]): GitLogArgs;
-/**
- * Get git log with audit logging
- */
-export declare function getGitLog(args: GitLogArgs): Promise<GitLogResult>;