@lumenflow/cli 2.1.1 → 2.2.0

package/dist/mem-summarize.d.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+/**
+ * Memory Summarize CLI (WU-1471)
+ *
+ * Rollup older memory nodes into summary nodes for compaction.
+ * Implements forgetting as first-class feature.
+ *
+ * Features:
+ * - Aggregate checkpoint/note/discovery nodes into summaries
+ * - Mark originals for cleanup after summary creation
+ * - Respect lifecycle TTL (ephemeral, session, wu, project)
+ * - Support dry-run mode for preview
+ *
+ * Usage:
+ *   pnpm mem:summarize --wu WU-1234           # Create summary from WU nodes
+ *   pnpm mem:summarize --wu WU-1234 --dry-run # Preview without changes
+ *   pnpm mem:summarize --wu WU-1234 --json    # Output as JSON
+ *
+ * @see {@link tools/lib/mem-summarize-core.mjs} - Core logic
+ * @see {@link tools/__tests__/mem-summarize.test.mjs} - Tests
+ */
+export {};

package/dist/mem-triage.d.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+/**
+ * Memory Triage CLI (WU-1470)
+ *
+ * Review discovery nodes and promote to WUs or archive.
+ *
+ * Features:
+ * - List open discovery nodes
+ * - Promote discovery to WU (integrates with wu:create)
+ * - Archive discovery without promotion
+ * - Interactive mode for human review
+ *
+ * Usage:
+ *   pnpm mem:triage                        # List open discoveries
+ *   pnpm mem:triage --wu WU-1234           # List discoveries for specific WU
+ *   pnpm mem:triage --promote mem-aaa1 --lane "Operations: Tooling"
+ *   pnpm mem:triage --archive mem-aaa1 --reason "Duplicate"
+ *
+ * @see {@link tools/lib/mem-triage-core.mjs} - Core logic
+ * @see {@link tools/__tests__/mem-triage.test.mjs} - Tests
+ */
+export {};

package/dist/metrics-cli.d.ts

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+/**
+ * Unified Metrics CLI with subcommands (WU-1110)
+ *
+ * Provides lanes, dora, and flow metrics subcommands in a single CLI.
+ *
+ * Usage:
+ *   pnpm metrics                          # All metrics, JSON output
+ *   pnpm metrics lanes                    # Lane health only
+ *   pnpm metrics dora                     # DORA metrics only
+ *   pnpm metrics flow                     # Flow state only
+ *   pnpm metrics --format table           # Table output
+ *   pnpm metrics --days 30                # 30 day window
+ *   pnpm metrics --output metrics.json    # Custom output file
+ *   pnpm metrics --dry-run                # Preview without writing
+ *
+ * @module metrics-cli
+ */
+import { type WUMetrics, type GitCommit, type SkipGatesEntry, type DORAMetrics, type FlowState, type LaneHealth } from '@lumenflow/metrics';
+/** Valid subcommands */
+export type MetricsSubcommand = 'lanes' | 'dora' | 'flow' | 'all';
+/** Output format types */
+export type MetricsFormat = 'json' | 'table';
+/** Parsed command result */
+export interface MetricsCommandResult {
+    subcommand: MetricsSubcommand;
+    days: number;
+    format: MetricsFormat;
+    output: string;
+    dryRun: boolean;
+}
+/** Lane health result from WUs */
+export interface LaneHealthResult {
+    lanes: LaneHealth[];
+    totalActive: number;
+    totalBlocked: number;
+    totalCompleted: number;
+}
+/** DORA calculation input */
+export interface DoraCalculationInput {
+    commits: GitCommit[];
+    wuMetrics: WUMetrics[];
+    skipGatesEntries: SkipGatesEntry[];
+    weekStart: Date;
+    weekEnd: Date;
+}
+/**
+ * Parse command line arguments
+ */
+export declare function parseCommand(argv: string[]): MetricsCommandResult;
+/**
+ * Calculate lane health from WU metrics
+ */
+export declare function calculateLaneHealthFromWUs(wuMetrics: WUMetrics[]): LaneHealthResult;
+/**
+ * Calculate DORA metrics from data
+ */
+export declare function calculateDoraFromData(input: DoraCalculationInput): DORAMetrics;
+/**
+ * Calculate flow state from WU metrics
+ */
+export declare function calculateFlowFromWUs(wuMetrics: WUMetrics[]): FlowState;
+/**
+ * Format lanes output
+ */
+export declare function formatLanesOutput(lanes: LaneHealthResult, format: MetricsFormat): string;
+/**
+ * Format DORA output
+ */
+export declare function formatDoraOutput(dora: DORAMetrics, format: MetricsFormat): string;
+/**
+ * Format flow output
+ */
+export declare function formatFlowOutput(flow: FlowState, format: MetricsFormat): string;
+/**
+ * Run lanes subcommand
+ */
+export declare function runLanesSubcommand(opts: MetricsCommandResult): Promise<void>;
+/**
+ * Run dora subcommand
+ */
+export declare function runDoraSubcommand(opts: MetricsCommandResult): Promise<void>;
+/**
+ * Run flow subcommand
+ */
+export declare function runFlowSubcommand(opts: MetricsCommandResult): Promise<void>;
+/**
+ * Run all metrics (default)
+ */
+export declare function runAllSubcommand(opts: MetricsCommandResult): Promise<void>;

package/dist/metrics-snapshot.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * Metrics Snapshot Capture CLI (WU-1018)
+ *
+ * Captures DORA metrics, lane health, and flow state snapshots.
+ *
+ * Usage:
+ *   pnpm metrics:snapshot                     # All metrics, JSON output
+ *   pnpm metrics:snapshot --type dora         # DORA metrics only
+ *   pnpm metrics:snapshot --type lanes        # Lane health only
+ *   pnpm metrics:snapshot --type flow         # Flow state only
+ *   pnpm metrics:snapshot --dry-run           # Preview without writing
+ *   pnpm metrics:snapshot --output metrics.json
+ *
+ * @module metrics-snapshot
+ * @see {@link @lumenflow/metrics/flow/capture-metrics-snapshot}
+ */
+export {};

package/dist/orchestrate-init-status.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * Orchestrate Initiative Status CLI
+ *
+ * Compact status view for initiative orchestration.
+ * Shows progress of WUs in an initiative.
+ *
+ * Usage:
+ *   pnpm orchestrate:init-status --initiative INIT-001
+ */
+export {};

package/dist/orchestrate-initiative.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Orchestrate Initiative CLI
+ *
+ * Orchestrate initiative execution with parallel agent spawning.
+ * Builds execution plan based on WU dependencies and manages wave-based execution.
+ *
+ * Usage:
+ *   pnpm orchestrate:initiative --initiative INIT-001
+ *   pnpm orchestrate:initiative --initiative INIT-001 --dry-run
+ */
+export {};

package/dist/orchestrate-monitor.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * Orchestrate Monitor CLI
+ *
+ * Monitors spawned agent progress using mem:inbox signals.
+ * Designed to prevent context exhaustion by using compact signal output.
+ *
+ * Usage:
+ *   pnpm orchestrate:monitor --since 30m
+ */
+export {};

package/dist/release.d.ts

@@ -0,0 +1,117 @@
+#!/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

@@ -0,0 +1,48 @@
+#!/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

@@ -0,0 +1,74 @@
+#!/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

@@ -0,0 +1,16 @@
+#!/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

@@ -0,0 +1,92 @@
+#!/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

@@ -0,0 +1,52 @@
+/**
+ * @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

@@ -0,0 +1,84 @@
+#!/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;