@lumenflow/cli 2.3.2 → 2.5.0

package/dist/mem-export.d.ts

@@ -1,10 +0,0 @@
-#!/usr/bin/env node
-/**
- * Memory Export CLI (WU-1137)
- *
- * Render memory.jsonl as markdown or JSON with basic filters.
- *
- * Usage:
- *   pnpm mem:export [--wu WU-1234] [--type <type>] [--lifecycle <lifecycle>] [--format <markdown|json>] [--quiet]
- */
-export {};

package/dist/mem-inbox.d.ts

@@ -1,35 +0,0 @@
-#!/usr/bin/env node
-/**
- * Memory Inbox CLI (WU-1474)
- *
- * Read coordination signals from other agents for real-time awareness
- * of parallel agent progress. Filter by lane, WU, or time range.
- * Supports watch mode for continuous monitoring.
- *
- * Includes audit logging to .lumenflow/telemetry/tools.ndjson.
- *
- * WU-2202: Added dependency validation before operations to prevent silent
- * failures when node_modules is corrupted or incomplete.
- *
- * Usage:
- *   pnpm mem:inbox [--lane <name>] [--wu <id>] [--since <time>] [--watch]
- *
- * @see {@link tools/lib/mem-signal-core.mjs} - Core logic
- * @see {@link tools/__tests__/mem-inbox.test.mjs} - Tests
- */
-/**
- * Format signal count for --count flag output
- * WU-2401: Lightweight polling for orchestrators
- *
- * @param {number} count - Number of unread signals
- * @returns {string} Formatted count string
- */
-export declare function formatCount(count: any): string;
-/**
- * Parse relative time string to Date object
- * WU-1849: Replaced custom regex with ms package
- *
- * @param {string} timeStr - Time string like "1h", "30m", "2d", or ISO date
- * @returns {Date} Parsed date
- */
-export declare function parseTimeString(timeStr: any): Date;

package/dist/mem-init.d.ts

@@ -1,15 +0,0 @@
-#!/usr/bin/env node
-/**
- * Memory Init CLI (WU-1464)
- *
- * Initialize memory layer in the repository.
- * Creates .lumenflow/memory/ directory with memory.jsonl and config.yaml.
- *
- * Includes audit logging to .lumenflow/telemetry/tools.ndjson.
- *
- * Usage:
- *   pnpm mem:init [--base-dir <path>] [--quiet]
- *
- * @see {@link tools/lib/mem-init-core.mjs} - Core logic
- */
-export {};

package/dist/mem-ready.d.ts

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-/**
- * Memory Ready CLI (WU-1468)
- *
- * Deterministic ready-work query for "what next?" oracle.
- * Returns unblocked open nodes, ordered by priority then createdAt.
- *
- * Usage:
- *   pnpm mem:ready --wu WU-1234 [--type <type>] [--format <json|human>] [--quiet]
- *
- * Includes audit logging to .lumenflow/telemetry/tools.ndjson.
- *
- * @see {@link tools/lib/mem-ready-core.mjs} - Core logic
- * @see {@link tools/__tests__/mem-ready.test.mjs} - Tests
- */
-export {};

package/dist/mem-signal.d.ts

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-/**
- * Memory Signal CLI (WU-1473)
- *
- * Send coordination signals between parallel agents for sub-100ms
- * multi-agent swarm coordination without git sync latency.
- *
- * Includes audit logging to .lumenflow/telemetry/tools.ndjson.
- *
- * Usage:
- *   pnpm mem:signal 'message' [--wu <id>] [--lane <name>] [--quiet]
- *
- * @see {@link tools/lib/mem-signal-core.mjs} - Core logic
- * @see {@link tools/__tests__/mem-signal.test.mjs} - Tests
- */
-export {};

package/dist/mem-start.d.ts

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-/**
- * Memory Start CLI (WU-1466)
- *
- * Create a session node linked to a WU.
- * Called by wu:claim enhancement for context restoration after /clear.
- *
- * Includes audit logging to .lumenflow/telemetry/tools.ndjson.
- *
- * Usage:
- *   pnpm mem:start --wu WU-1234 [--agent-type <type>] [--context-tier <tier>] [--quiet]
- *
- * @see {@link tools/lib/mem-start-core.mjs} - Core logic
- * @see {@link tools/__tests__/mem-start.test.mjs} - Tests
- */
-export {};

package/dist/mem-summarize.d.ts

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

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

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

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

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

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

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

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