@lumenflow/cli 2.3.2 → 2.5.0

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>;

package/dist/git-status.d.ts

@@ -1,58 +0,0 @@
-#!/usr/bin/env node
-/**
- * Git Status CLI Tool
- *
- * Provides WU-aware git status with:
- * - Porcelain and short output formats
- * - Parsed file status (staged, modified, untracked)
- * - Clean/dirty state detection
- *
- * Usage:
- *   node git-status.js [path] [--porcelain] [--short]
- *
- * WU-1109: INIT-003 Phase 4b - Migrate git operations
- */
-/**
- * Arguments for git status operation
- */
-export interface GitStatusArgs {
-    /** Base directory for git operations */
-    baseDir?: string;
-    /** Path to filter status */
-    path?: string;
-    /** Use porcelain output format */
-    porcelain?: boolean;
-    /** Use short output format */
-    short?: boolean;
-    /** Show help */
-    help?: boolean;
-}
-/**
- * Result of git status operation
- */
-export interface GitStatusResult {
-    /** Whether operation succeeded */
-    success: boolean;
-    /** Error message (if failed) */
-    error?: string;
-    /** Whether working tree is clean */
-    isClean?: boolean;
-    /** List of staged files */
-    staged?: string[];
-    /** List of modified files (unstaged) */
-    modified?: string[];
-    /** List of untracked files */
-    untracked?: string[];
-    /** List of deleted files */
-    deleted?: string[];
-    /** Raw output (for porcelain mode) */
-    output?: string;
-}
-/**
- * Parse command line arguments for git-status
- */
-export declare function parseGitStatusArgs(argv: string[]): GitStatusArgs;
-/**
- * Get git status with audit logging
- */
-export declare function getGitStatus(args: GitStatusArgs): Promise<GitStatusResult>;

package/dist/guard-locked.d.ts

@@ -1,62 +0,0 @@
-#!/usr/bin/env node
-/**
- * @file guard-locked.ts
- * @description Guard that prevents changes to locked WUs (WU-1111)
- *
- * Validates that a WU is not locked before allowing modifications.
- * Used by git hooks and wu: commands to enforce workflow discipline.
- *
- * Usage:
- *   guard-locked WU-123        # Check if WU-123 is locked
- *   guard-locked --wu WU-123   # Same with explicit flag
- *
- * Exit codes:
- *   0 - WU is not locked (safe to proceed)
- *   1 - WU is locked (block operation)
- *
- * @see {@link docs/04-operations/_frameworks/lumenflow/lumenflow-complete.md} - WU lifecycle
- */
-/**
- * Check if a WU is locked
- *
- * @param wuPath - Path to WU YAML file
- * @returns true if WU has locked: true, false otherwise
- * @throws Error if WU file does not exist or cannot be parsed
- *
- * @example
- * if (isWULocked('/path/to/WU-123.yaml')) {
- *   console.log('WU is locked, cannot modify');
- * }
- */
-export declare function isWULocked(wuPath: string): boolean;
-/**
- * Assert that a WU is not locked
- *
- * @param wuPath - Path to WU YAML file
- * @throws Error if WU is locked, with actionable fix instructions
- *
- * @example
- * try {
- *   assertWUNotLocked('/path/to/WU-123.yaml');
- *   // Safe to modify
- * } catch (error) {
- *   console.error(error.message);
- *   process.exit(1);
- * }
- */
-export declare function assertWUNotLocked(wuPath: string): void;
-/**
- * Check if a WU ID is locked by looking up the YAML file
- *
- * @param wuId - WU ID (e.g., "WU-123")
- * @returns true if WU has locked: true, false otherwise
- * @throws Error if WU file does not exist
- */
-export declare function isWUIdLocked(wuId: string): boolean;
-/**
- * Assert that a WU ID is not locked
- *
- * @param wuId - WU ID (e.g., "WU-123")
- * @throws Error if WU is locked
- */
-export declare function assertWUIdNotLocked(wuId: string): void;

package/dist/guard-main-branch.d.ts

@@ -1,50 +0,0 @@
-#!/usr/bin/env node
-/**
- * Guard Main Branch CLI Tool
- *
- * Provides branch protection checks for WU workflow:
- * - Blocks operations on main/master branches
- * - Blocks operations on lane branches (require worktree)
- * - Optionally allows agent branches
- *
- * Usage:
- *   node guard-main-branch.js [--allow-agent-branch] [--strict]
- *
- * WU-1109: INIT-003 Phase 4b - Migrate git operations
- */
-/**
- * Arguments for guard-main-branch operation
- */
-export interface GuardMainBranchArgs {
-    /** Base directory for git operations */
-    baseDir?: string;
-    /** Allow agent branches (e.g., claude/session-123) */
-    allowAgentBranch?: boolean;
-    /** Strict mode - fail on any protected branch */
-    strict?: boolean;
-    /** Show help */
-    help?: boolean;
-}
-/**
- * Result of guard-main-branch operation
- */
-export interface GuardMainBranchResult {
-    /** Whether operation succeeded */
-    success: boolean;
-    /** Error message (if failed) */
-    error?: string;
-    /** Whether current branch is protected */
-    isProtected: boolean;
-    /** Current branch name */
-    currentBranch?: string;
-    /** Reason for protection */
-    reason?: string;
-}
-/**
- * Parse command line arguments for guard-main-branch
- */
-export declare function parseGuardMainBranchArgs(argv: string[]): GuardMainBranchArgs;
-/**
- * Guard against operations on protected branches
- */
-export declare function guardMainBranch(args: GuardMainBranchArgs): Promise<GuardMainBranchResult>;

package/dist/guard-worktree-commit.d.ts

@@ -1,59 +0,0 @@
-#!/usr/bin/env node
-/**
- * @file guard-worktree-commit.ts
- * @description Guard that prevents WU commits from main checkout (WU-1111)
- *
- * Validates that WU-related commits are only made from worktrees, not main.
- * Used by git commit-msg hooks to enforce worktree discipline.
- *
- * Usage:
- *   guard-worktree-commit "commit message"
- *   guard-worktree-commit --message "commit message"
- *
- * Exit codes:
- *   0 - Commit allowed
- *   1 - Commit blocked (WU commit from main)
- *
- * @see {@link docs/04-operations/_frameworks/lumenflow/lumenflow-complete.md} - Worktree discipline
- */
-/**
- * Result of commit block check
- */
-export interface CommitBlockResult {
-    /** Whether the commit should be blocked */
-    blocked: boolean;
-    /** Reason for blocking (if blocked) */
-    reason?: string;
-}
-/**
- * Check if a commit should be blocked
- *
- * @param options - Check options
- * @param options.commitMessage - The commit message
- * @param options.isMainCheckout - Whether in main checkout
- * @param options.isInWorktree - Whether in a worktree
- * @returns Whether commit should be blocked and why
- *
- * @example
- * const result = shouldBlockCommit({
- *   commitMessage: 'wu(WU-123): add feature',
- *   isMainCheckout: true,
- *   isInWorktree: false,
- * });
- * if (result.blocked) {
- *   console.error(result.reason);
- *   process.exit(1);
- * }
- */
-export declare function shouldBlockCommit(options: {
-    commitMessage: string;
-    isMainCheckout: boolean;
-    isInWorktree: boolean;
-}): CommitBlockResult;
-/**
- * Check if a commit message is WU-related
- *
- * @param message - Commit message to check
- * @returns true if message indicates WU work
- */
-export declare function isWUCommitMessage(message: string): boolean;

package/dist/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * @lumenflow/cli - Command-line interface for LumenFlow workflow framework
- *
- * This package provides CLI commands for the LumenFlow workflow framework.
- * Most functionality is exposed via bin commands, but the cli-entry-point
- * helper is exported for use in custom CLI wrappers.
- *
- * @see https://lumenflow.dev/reference/cli
- */
-export { runCLI } from './cli-entry-point.js';

package/dist/init-plan.d.ts

@@ -1,80 +0,0 @@
-#!/usr/bin/env node
-/**
- * Init Plan Command (WU-1105)
- *
- * Links plan files to initiatives by setting the `related_plan` field
- * in the initiative YAML.
- *
- * Usage:
- *   pnpm init:plan --initiative INIT-001 --plan docs/04-operations/plans/my-plan.md
- *   pnpm init:plan --initiative INIT-001 --create  # Create new plan template
- *
- * Features:
- * - Validates initiative exists before modifying
- * - Formats plan path as lumenflow:// URI
- * - Idempotent: no error if same plan already linked
- * - Warns if replacing existing plan link
- * - Can create plan templates with --create
- *
- * Context: WU-1105 (INIT-003 Phase 3a: Migrate init:plan command)
- */
-import { readInitiative } from '@lumenflow/initiatives/dist/initiative-yaml.js';
-/** Log prefix for console output */
-export declare const LOG_PREFIX: string;
-/**
- * Validate Initiative ID format
- * @param id - Initiative ID to validate
- * @throws Error if format is invalid
- */
-export declare function validateInitIdFormat(id: string): void;
-/**
- * Validate plan file path
- * @param planPath - Path to plan file
- * @throws Error if path is invalid or file doesn't exist
- */
-export declare function validatePlanPath(planPath: string): void;
-/**
- * Format plan path as lumenflow:// URI
- *
- * Extracts the filename (and any subdirectory within plans/) and creates
- * a standardized URI for the plan reference.
- *
- * @param planPath - Path to plan file (can be relative or absolute)
- * @returns lumenflow://plans/<filename> URI
- */
-export declare function formatPlanUri(planPath: string): string;
-/**
- * Check if initiative exists and return the document
- * @param initId - Initiative ID to check
- * @returns Initiative document
- * @throws Error if initiative not found
- */
-export declare function checkInitiativeExists(initId: string): ReturnType<typeof readInitiative>;
-/**
- * Update initiative with plan reference in micro-worktree
- *
- * Uses raw YAML parsing to preserve unknown fields like related_plan
- * that are not in the strict initiative schema.
- *
- * @param worktreePath - Path to micro-worktree
- * @param initId - Initiative ID
- * @param planUri - Plan URI to set
- * @returns True if changes were made, false if already linked
- */
-export declare function updateInitiativeWithPlan(worktreePath: string, initId: string, planUri: string): boolean;
-/**
- * Create a plan template file
- *
- * @param worktreePath - Path to repo root or worktree
- * @param initId - Initiative ID
- * @param title - Initiative title
- * @returns Path to created file
- * @throws Error if file already exists
- */
-export declare function createPlanTemplate(worktreePath: string, initId: string, title: string): string;
-/**
- * Generate commit message for plan link operation
- */
-export declare function getCommitMessage(initId: string, planUri: string): string;
-declare function main(): Promise<void>;
-export { main };