@lumenflow/cli 2.4.0 → 2.5.0

package/dist/release.d.ts

@@ -1,117 +0,0 @@
-#!/usr/bin/env node
-/**
- * Release Command
- *
- * Orchestrates npm release for all @lumenflow/* packages using micro-worktree isolation.
- *
- * Features:
- * - Validates semver version format
- * - Bumps all @lumenflow/* package versions atomically
- * - Uses micro-worktree isolation for version commit (no main branch pollution)
- * - Builds all packages via turbo
- * - Publishes to npm with proper auth (requires NPM_TOKEN)
- * - Creates git tag vX.Y.Z
- *
- * Usage:
- *   pnpm release --release-version 1.3.0
- *   pnpm release --release-version 1.3.0 --dry-run     # Preview without making changes
- *   pnpm release --release-version 1.3.0 --skip-publish # Bump and tag only (no npm publish)
- *
- * WU-1085: The --release-version flag was renamed from --version to avoid conflict
- * with the standard CLI --version flag that shows the CLI version.
- *
- * WU-1074: Add release command for npm publishing
- */
-import { getGitForCwd } from '@lumenflow/core/dist/git-adapter.js';
-/**
- * Release command options
- * WU-1085: Renamed version to releaseVersion to avoid CLI --version conflict
- */
-export interface ReleaseOptions {
-    releaseVersion: string;
-    dryRun?: boolean;
-    skipPublish?: boolean;
-    skipBuild?: boolean;
-}
-/**
- * Validate that a string is a valid semver version
- *
- * @param version - Version string to validate
- * @returns true if valid semver, false otherwise
- */
-export declare function validateSemver(version: string): boolean;
-/**
- * Find all public @lumenflow/* package.json paths
- *
- * @param baseDir - Base directory to search from (defaults to cwd)
- * @returns Array of absolute paths to package.json files
- */
-export declare function findPackageJsonPaths(baseDir?: string): string[];
-/**
- * Update version in specified package.json files
- *
- * @param paths - Array of package.json paths
- * @param version - New version string
- */
-export declare function updatePackageVersions(paths: string[], version: string): Promise<void>;
-/**
- * Build commit message for version bump
- *
- * @param version - New version string
- * @returns Commit message
- */
-export declare function buildCommitMessage(version: string): string;
-/**
- * Build git tag name from version
- *
- * @param version - Version string
- * @returns Git tag name with 'v' prefix
- */
-export declare function buildTagName(version: string): string;
-/**
- * Check if npm authentication is available
- *
- * Checks for auth in this order:
- * 1. NPM_TOKEN environment variable
- * 2. NODE_AUTH_TOKEN environment variable
- * 3. Auth token in specified .npmrc file (or ~/.npmrc by default)
- *
- * @param npmrcPath - Optional path to .npmrc file (defaults to ~/.npmrc)
- * @returns true if any auth method is found
- */
-export declare function hasNpmAuth(npmrcPath?: string): boolean;
-/**
- * Check if the project is in changeset pre-release mode
- *
- * Changeset pre mode is indicated by the presence of .changeset/pre.json
- *
- * @param baseDir - Base directory to check (defaults to cwd)
- * @returns true if in pre-release mode
- */
-export declare function isInChangesetPreMode(baseDir?: string): boolean;
-/**
- * Exit changeset pre-release mode by removing .changeset/pre.json
- *
- * This is safe to call even if not in pre mode (no-op if file doesn't exist)
- *
- * @param baseDir - Base directory to operate in (defaults to cwd)
- */
-export declare function exitChangesetPreMode(baseDir?: string): void;
-/**
- * Push a git tag to origin, bypassing pre-push hooks via LUMENFLOW_FORCE
- *
- * This is necessary because the release script runs in a micro-worktree context
- * and pre-push hooks may block tag pushes. The force is logged and requires
- * a reason for audit purposes.
- *
- * @param git - SimpleGit instance
- * @param tagName - Name of the tag to push
- * @param reason - Reason for bypassing hooks (for audit log)
- */
-export declare function pushTagWithForce(git: ReturnType<typeof getGitForCwd>, tagName: string, reason?: string): Promise<void>;
-/**
- * Main release function
- * WU-1085: Renamed --version to --release-version to avoid conflict with CLI --version flag
- */
-declare function main(): Promise<void>;
-export { main };

package/dist/rotate-progress.d.ts

@@ -1,48 +0,0 @@
-#!/usr/bin/env node
-/**
- * Rotate Progress CLI Command
- *
- * Moves completed WUs from status.md In Progress section to Completed section.
- * Keeps the status file tidy by archiving done work.
- *
- * WU-1112: INIT-003 Phase 6 - Migrate remaining Tier 1 tools
- *
- * Usage:
- *   pnpm rotate:progress
- *   pnpm rotate:progress --dry-run
- *   pnpm rotate:progress --limit 10
- */
-/**
- * Arguments for rotate-progress command
- */
-export interface RotateArgs {
-    /** Dry run - show changes without writing */
-    dryRun?: boolean;
-    /** Maximum number of WUs to rotate */
-    limit?: number;
-    /** Show help */
-    help?: boolean;
-}
-/**
- * Parse command line arguments for rotate-progress
- *
- * @param argv - Process argv array
- * @returns Parsed arguments
- */
-export declare function parseRotateArgs(argv: string[]): RotateArgs;
-/**
- * Find WUs in the In Progress section that have status=done in YAML
- *
- * @param statusContent - Content of status.md file
- * @param wuStatuses - Map of WU IDs to their statuses from YAML
- * @returns Array of WU IDs that should be moved to Completed
- */
-export declare function findCompletedWUs(statusContent: string, wuStatuses: Map<string, string>): string[];
-/**
- * Build the rotated status.md content
- *
- * @param statusContent - Original status.md content
- * @param completedWUs - WU IDs to move to Completed
- * @returns Updated status.md content
- */
-export declare function buildRotatedContent(statusContent: string, completedWUs: string[]): string;

package/dist/session-coordinator.d.ts

@@ -1,74 +0,0 @@
-#!/usr/bin/env node
-/**
- * Session Coordinator CLI Command
- *
- * Manages agent sessions - starting, stopping, status, and handoffs.
- * Sessions track which agent is working on which WU and facilitate
- * coordination between multiple agents.
- *
- * WU-1112: INIT-003 Phase 6 - Migrate remaining Tier 1 tools
- *
- * Usage:
- *   pnpm session:start --wu WU-1112 --agent claude-code
- *   pnpm session:stop --reason "Completed work"
- *   pnpm session:status
- *   pnpm session:handoff --wu WU-1112 --agent cursor
- */
-/**
- * Session subcommands
- */
-export declare enum SessionCommand {
-    START = "start",
-    STOP = "stop",
-    STATUS = "status",
-    HANDOFF = "handoff"
-}
-/**
- * Arguments for session-coordinator command
- */
-export interface SessionArgs {
-    /** Subcommand to run */
-    command?: SessionCommand | string;
-    /** WU ID for the session */
-    wuId?: string;
-    /** Agent type (e.g., claude-code, cursor, aider) */
-    agent?: string;
-    /** Reason for stopping session */
-    reason?: string;
-    /** Show help */
-    help?: boolean;
-}
-/**
- * Validation result for session command
- */
-export interface SessionValidationResult {
-    valid: boolean;
-    error?: string;
-}
-/**
- * Session state stored in current.json
- */
-export interface SessionState {
-    /** WU being worked on */
-    wuId: string;
-    /** Agent working on the WU */
-    agent: string;
-    /** Session start timestamp */
-    startedAt: string;
-    /** Last activity timestamp */
-    lastActivity: string;
-}
-/**
- * Parse command line arguments for session-coordinator
- *
- * @param argv - Process argv array
- * @returns Parsed arguments
- */
-export declare function parseSessionArgs(argv: string[]): SessionArgs;
-/**
- * Validate session command arguments
- *
- * @param args - Parsed session arguments
- * @returns Validation result
- */
-export declare function validateSessionCommand(args: SessionArgs): SessionValidationResult;

package/dist/spawn-list.d.ts

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-/**
- * Spawn List Command (WU-1950)
- *
- * Displays spawn trees for WUs or initiatives.
- * Shows parent-child relationships with status indicators.
- *
- * Usage:
- *   pnpm spawn:list --wu WU-XXX          # Spawns for a specific WU
- *   pnpm spawn:list --initiative INIT-XXX # All spawns in an initiative
- *   pnpm spawn:list --json               # JSON output
- *
- * @see {@link tools/lib/spawn-tree.mjs} - Tree builder
- * @see {@link tools/__tests__/spawn-list.test.mjs} - Tests
- */
-export {};

package/dist/state-bootstrap.d.ts

@@ -1,92 +0,0 @@
-#!/usr/bin/env node
-/**
- * State Bootstrap Command
- *
- * One-time migration utility from WU YAMLs to event-sourced state store.
- * Reads all WU YAML files and generates corresponding events in the state store.
- *
- * WU-1107: INIT-003 Phase 3c - Migrate state-bootstrap.mjs from PatientPath
- *
- * Usage:
- *   pnpm state:bootstrap           # Dry-run mode (shows what would be done)
- *   pnpm state:bootstrap --execute # Apply changes
- */
-/**
- * Default configuration for state bootstrap
- */
-export declare const STATE_BOOTSTRAP_DEFAULTS: {
-    /** Default WU directory path */
-    wuDir: string;
-    /** Default state directory path */
-    stateDir: string;
-};
-/**
- * Arguments for state-bootstrap command
- */
-export interface StateBootstrapArgs {
-    dryRun: boolean;
-    wuDir: string;
-    stateDir: string;
-    force: boolean;
-    help?: boolean;
-}
-/**
- * Minimal WU information needed for bootstrap event generation
- */
-export interface WuBootstrapInfo {
-    id: string;
-    status: string;
-    lane: string;
-    title: string;
-    created?: string;
-    claimed_at?: string;
-    completed_at?: string;
-}
-/**
- * Bootstrap event to be written to state store
- */
-export interface BootstrapEvent {
-    type: 'claim' | 'complete' | 'block' | 'unblock' | 'release';
-    wuId: string;
-    timestamp: string;
-    lane?: string;
-    title?: string;
-    reason?: string;
-}
-/**
- * Result of bootstrap operation
- */
-export interface BootstrapResult {
-    success: boolean;
-    eventsGenerated: number;
-    eventsWritten: number;
-    skipped: number;
-    warnings: string[];
-    error?: string;
-}
-/**
- * Parse command line arguments for state-bootstrap
- */
-export declare function parseStateBootstrapArgs(argv: string[]): StateBootstrapArgs;
-/**
- * Infer events from a WU based on its current status
- *
- * Event generation rules:
- * - ready: No events (WU not yet claimed)
- * - in_progress: Generate claim event
- * - blocked: Generate claim + block events
- * - done/completed: Generate claim + complete events
- */
-export declare function inferEventsFromWu(wu: WuBootstrapInfo): BootstrapEvent[];
-/**
- * Generate all bootstrap events from a list of WUs, ordered chronologically
- */
-export declare function generateBootstrapEvents(wus: WuBootstrapInfo[]): BootstrapEvent[];
-/**
- * Run the state bootstrap migration
- */
-export declare function runStateBootstrap(args: StateBootstrapArgs): Promise<BootstrapResult>;
-/**
- * Print help text
- */
-export declare function printHelp(): void;

package/dist/sync-templates.d.ts

@@ -1,52 +0,0 @@
-/**
- * @file sync-templates.ts
- * Sync internal docs to CLI templates for release-cycle maintenance (WU-1123)
- *
- * This script syncs source docs from the hellmai/os repo to the templates
- * directory, applying template variable substitutions:
- * - Onboarding docs -> templates/core/ai/onboarding/
- * - Claude skills -> templates/vendors/claude/.claude/skills/
- * - Core docs (LUMENFLOW.md, constraints.md) -> templates/core/
- */
-export interface SyncResult {
-    synced: string[];
-    errors: string[];
-}
-export interface SyncSummary {
-    onboarding: SyncResult;
-    skills: SyncResult;
-    core: SyncResult;
-}
-/**
- * Parse sync-templates command options
- */
-export declare function parseSyncTemplatesOptions(): {
-    dryRun: boolean;
-    verbose: boolean;
-};
-/**
- * Convert source content to template format by replacing:
- * - YYYY-MM-DD dates with {{DATE}}
- * - Absolute project paths with {{PROJECT_ROOT}}
- */
-export declare function convertToTemplate(content: string, projectRoot: string): string;
-/**
- * Sync onboarding docs to templates/core/ai/onboarding/
- */
-export declare function syncOnboardingDocs(projectRoot: string, dryRun?: boolean): Promise<SyncResult>;
-/**
- * Sync Claude skills to templates/vendors/claude/.claude/skills/
- */
-export declare function syncSkillsToTemplates(projectRoot: string, dryRun?: boolean): Promise<SyncResult>;
-/**
- * Sync core docs (LUMENFLOW.md, constraints.md) to templates/core/
- */
-export declare function syncCoreDocs(projectRoot: string, dryRun?: boolean): Promise<SyncResult>;
-/**
- * Sync all templates
- */
-export declare function syncTemplates(projectRoot: string, dryRun?: boolean): Promise<SyncSummary>;
-/**
- * CLI entry point
- */
-export declare function main(): Promise<void>;

package/dist/trace-gen.d.ts

@@ -1,84 +0,0 @@
-#!/usr/bin/env node
-/**
- * Trace Generator CLI Command
- *
- * Creates traceability reports linking WUs to code changes.
- * Useful for audit trails, compliance documentation, and understanding
- * what code was changed as part of each WU.
- *
- * WU-1112: INIT-003 Phase 6 - Migrate remaining Tier 1 tools
- *
- * Usage:
- *   pnpm trace:gen --wu WU-1112
- *   pnpm trace:gen --since 2024-01-01 --format json
- *   pnpm trace:gen --format markdown --output trace.md
- */
-/**
- * Output formats for trace report
- */
-export declare enum TraceFormat {
-    JSON = "json",
-    MARKDOWN = "markdown",
-    CSV = "csv"
-}
-/**
- * Arguments for trace-gen command
- */
-export interface TraceArgs {
-    /** Specific WU ID to trace */
-    wuId?: string;
-    /** Output format */
-    format?: TraceFormat | string;
-    /** Output file path */
-    output?: string;
-    /** Since date (ISO format) */
-    since?: string;
-    /** Show help */
-    help?: boolean;
-}
-/**
- * Commit information
- */
-export interface CommitInfo {
-    sha: string;
-    message: string;
-    date: string;
-}
-/**
- * Input data for building trace entry
- */
-export interface TraceInput {
-    wuId: string;
-    title: string;
-    status: string;
-    commits: CommitInfo[];
-    files: string[];
-}
-/**
- * Trace entry for a WU
- */
-export interface TraceEntry {
-    wuId: string;
-    title: string;
-    status: string;
-    commitCount: number;
-    fileCount: number;
-    firstCommit?: string;
-    lastCommit?: string;
-    commits?: CommitInfo[];
-    files?: string[];
-}
-/**
- * Parse command line arguments for trace-gen
- *
- * @param argv - Process argv array
- * @returns Parsed arguments
- */
-export declare function parseTraceArgs(argv: string[]): TraceArgs;
-/**
- * Build a trace entry from WU and commit data
- *
- * @param input - Input data containing WU info, commits, and files
- * @returns Trace entry with summary statistics
- */
-export declare function buildTraceEntry(input: TraceInput): TraceEntry;

package/dist/validate-agent-skills.d.ts

@@ -1,50 +0,0 @@
-#!/usr/bin/env node
-/**
- * @file validate-agent-skills.ts
- * @description Validates agent skill definitions (WU-1111)
- *
- * Validates that skill files in .claude/skills/ follow the expected format
- * and contain required sections.
- *
- * Usage:
- *   validate-agent-skills                    # Validate all skills
- *   validate-agent-skills --skill wu-lifecycle  # Validate specific skill
- *
- * Exit codes:
- *   0 - All skills valid
- *   1 - Validation errors found
- *
- * @see {@link .claude/skills/} - Skill definitions
- */
-/**
- * Validation result for a skill
- */
-export interface SkillValidationResult {
-    valid: boolean;
-    errors: string[];
-    warnings: string[];
-}
-/**
- * Validation summary for all skills
- */
-export interface SkillValidationSummary {
-    totalValid: number;
-    totalInvalid: number;
-    results: Array<{
-        skillName: string;
-    } & SkillValidationResult>;
-}
-/**
- * Validate a single skill file
- *
- * @param skillPath - Path to SKILL.md file
- * @returns Validation result
- */
-export declare function validateSkillFile(skillPath: string): SkillValidationResult;
-/**
- * Validate all skills in a directory
- *
- * @param skillsDir - Path to skills directory
- * @returns Validation summary
- */
-export declare function validateAllSkills(skillsDir: string): SkillValidationSummary;

package/dist/validate-agent-sync.d.ts

@@ -1,36 +0,0 @@
-#!/usr/bin/env node
-/**
- * @file validate-agent-sync.ts
- * @description Validates agent sync state (WU-1111)
- *
- * Validates that agent configuration files exist and are properly structured.
- * Checks .claude/agents/ for valid agent definitions.
- *
- * Usage:
- *   validate-agent-sync                # Validate agent configuration
- *
- * Exit codes:
- *   0 - Agent configuration valid
- *   1 - Validation errors found
- *
- * @see {@link .claude/agents/} - Agent definitions
- */
-/**
- * Validation result for agent sync
- */
-export interface AgentSyncValidationResult {
-    valid: boolean;
-    errors: string[];
-    warnings: string[];
-    agents: string[];
-}
-/**
- * Validate agent sync state
- *
- * @param options - Validation options
- * @param options.cwd - Working directory (default: process.cwd())
- * @returns Validation result
- */
-export declare function validateAgentSync(options?: {
-    cwd?: string;
-}): Promise<AgentSyncValidationResult>;

package/dist/validate-backlog-sync.d.ts

@@ -1,37 +0,0 @@
-#!/usr/bin/env node
-/**
- * @file validate-backlog-sync.ts
- * @description Validates backlog.md is in sync with WU YAML files (WU-1111)
- *
- * Checks that all WU YAML files are referenced in backlog.md and vice versa.
- * This is the TypeScript replacement for tools/validate-backlog-sync.js.
- *
- * Usage:
- *   validate-backlog-sync              # Validate sync
- *
- * Exit codes:
- *   0 - Backlog is in sync
- *   1 - Sync issues found
- *
- * @see {@link docs/04-operations/tasks/backlog.md} - Backlog file
- */
-/**
- * Validation result for backlog sync
- */
-export interface BacklogSyncResult {
-    valid: boolean;
-    errors: string[];
-    warnings: string[];
-    wuCount: number;
-    backlogCount: number;
-}
-/**
- * Validate that backlog.md is in sync with WU YAML files
- *
- * @param options - Validation options
- * @param options.cwd - Working directory (default: process.cwd())
- * @returns Validation result
- */
-export declare function validateBacklogSync(options?: {
-    cwd?: string;
-}): Promise<BacklogSyncResult>;

package/dist/validate-skills-spec.d.ts

@@ -1,40 +0,0 @@
-#!/usr/bin/env node
-/**
- * @file validate-skills-spec.ts
- * @description Validates skills spec format (WU-1111)
- *
- * Validates that skill specification files follow the required format
- * with proper sections and structure.
- *
- * Usage:
- *   validate-skills-spec SKILL.md          # Validate specific file
- *   validate-skills-spec --dir ./skills    # Validate all in directory
- *
- * Exit codes:
- *   0 - Validation passed
- *   1 - Validation errors found
- *
- * @see {@link .claude/skills/} - Skill definitions
- */
-/**
- * Validation result for a skill spec
- */
-export interface SkillsSpecResult {
-    valid: boolean;
-    errors: string[];
-    warnings: string[];
-}
-/**
- * Validate a skill specification file
- *
- * @param skillPath - Path to skill spec file
- * @returns Validation result
- */
-export declare function validateSkillsSpec(skillPath: string): SkillsSpecResult;
-/**
- * Validate all skill specs in a directory
- *
- * @param dir - Directory to scan
- * @returns Map of file path to validation result
- */
-export declare function validateSkillsSpecDir(dir: string): Map<string, SkillsSpecResult>;