@lumenflow/cli 2.3.2 → 2.5.0

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

package/dist/validate.d.ts

@@ -1,60 +0,0 @@
-#!/usr/bin/env node
-/**
- * @file validate.ts
- * @description Main WU YAML validator CLI (WU-1111)
- *
- * Validates WU tasks and status consistency. This is the replacement for
- * tools/validate.js that was previously a stub.
- *
- * Usage:
- *   validate                     # Validate all WUs
- *   validate --id WU-123         # Validate specific WU
- *   validate --strict            # Fail on warnings too
- *   validate --done-only         # Only validate done WUs
- *
- * Exit codes:
- *   0 - All validations passed
- *   1 - Validation errors found
- *
- * @see {@link wu-validate.ts} - Detailed WU validation with schema
- * @see {@link docs/04-operations/_frameworks/lumenflow/lumenflow-complete.md} - WU lifecycle
- */
-/**
- * Validation result for a single WU
- */
-export interface ValidationResult {
-    valid: boolean;
-    warnings: string[];
-    errors: string[];
-}
-/**
- * Validation summary for multiple WUs
- */
-export interface ValidationSummary {
-    totalValid: number;
-    totalInvalid: number;
-    totalWarnings: number;
-    results: Array<{
-        wuId: string;
-    } & ValidationResult>;
-}
-/**
- * Validate a single WU file
- *
- * @param wuPath - Path to WU YAML file
- * @param options - Validation options
- * @returns Validation result
- */
-export declare function validateSingleWU(wuPath: string, options?: {
-    strict?: boolean;
-}): ValidationResult;
-/**
- * Validate all WU files in the WU directory
- *
- * @param options - Validation options
- * @returns Summary of all validations
- */
-export declare function validateAllWUs(options?: {
-    strict?: boolean;
-    doneOnly?: boolean;
-}): ValidationSummary;

package/dist/wu-block.d.ts

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-/**
- * WU Block Helper
- *
- * Sequence (micro-worktree pattern):
- * 1) Create micro-worktree from main
- * 2) Auto-update WU YAML/backlog/status to Blocked in micro-worktree
- * 3) Commit in micro-worktree, push directly to origin/main
- * 4) Optionally remove work worktree (default: keep)
- *
- * Uses micro-worktree pattern to avoid pre-commit hook blocking commits to main.
- *
- * Usage:
- *   pnpm wu:block --id WU-334 [--reason "Waiting on policy"] [--worktree ...] [--remove-worktree] [--no-auto]
- */
-export {};

package/dist/wu-claim.d.ts

@@ -1,74 +0,0 @@
-#!/usr/bin/env node
-/**
- * WU Claim Helper
- *
- * Canonical sequence:
- * 1) Auto-update backlog/status/WU YAML (safe parsing) unless `--no-auto`
- * 2) Commit and push to `main`
- * 3) Create a dedicated worktree+branch for the WU
- *
- * Usage:
- *   node tools/wu-claim.mjs --id WU-334 --lane Intelligence \
- *     [--worktree worktrees/intelligence-wu-334] [--branch lane/intelligence/wu-334]
- *
- * WU-2542: This script imports utilities from @lumenflow/core package.
- * Full migration to thin shim pending @lumenflow/core CLI export implementation.
- */
-/**
- * WU-1746: Get list of files to commit in worktree mode
- * Excludes backlog.md and status.md to prevent merge conflicts.
- * These generated files should only be updated on main during wu:done.
- *
- * @param {string} wuId - WU ID (e.g., 'WU-1746')
- * @returns {string[]} List of files to commit
- */
-export declare function getWorktreeCommitFiles(wuId: any): string[];
-/**
- * WU-1047: Format Project Defaults section (agent-only).
- *
- * @param {object} methodology - Methodology defaults config
- * @returns {string} Formatted output or empty string if disabled
- */
-export declare function formatProjectDefaults(methodology: any): string;
-/**
- * WU-1047: Print Project Defaults section (agent-only).
- *
- * @param {object} methodology - Methodology defaults config
- */
-export declare function printProjectDefaults(methodology: any): void;
-/**
- * WU-1763: Print a single concise tips line to improve tool adoption.
- * Non-blocking, single-line output to avoid flooding the console.
- *
- * @param {string} _id - WU ID being claimed (unused, kept for future use)
- */
-export declare function printLifecycleNudge(_id: any): void;
-/**
- * WU-1029: Apply symlink fallback (root + nested node_modules) after install failure.
- *
- * @param {string} worktreePath - Worktree path
- * @param {string} mainRepoPath - Main repo path
- * @param {Console} logger - Logger (console-compatible)
- */
-export declare function applyFallbackSymlinks(worktreePath: any, mainRepoPath: any, logger?: Console): {
-    symlinkResult: {
-        created: boolean;
-        skipped: boolean;
-        refused?: undefined;
-        reason?: undefined;
-        error?: undefined;
-    } | {
-        created: boolean;
-        skipped: boolean;
-        refused: boolean;
-        reason: string;
-        error?: undefined;
-    } | {
-        created: boolean;
-        skipped: boolean;
-        error: any;
-        refused?: undefined;
-        reason?: undefined;
-    };
-    nestedResult: any;
-};

package/dist/wu-cleanup.d.ts

@@ -1,35 +0,0 @@
-#!/usr/bin/env node
-/**
- * WU Cleanup Helper
- *
- * Cleans up worktree and branch after PR merge (PR-based completion workflow).
- *
- * Sequence:
- * 1) Verify PR is merged (via gh API; no merge-base fallback)
- * 2) Remove worktree (if exists)
- * 3) Delete lane branch (local + remote)
- *
- * Idempotent: Safe no-op if already cleaned.
- *
- * Usage:
- *   pnpm wu:cleanup --id WU-703
- *   pnpm wu:cleanup --artifacts
- */
-export declare const CLEANUP_GUARD_REASONS: {
-    UNCOMMITTED_CHANGES: string;
-    UNPUSHED_COMMITS: string;
-    STATUS_NOT_DONE: string;
-    MISSING_STAMP: string;
-    PR_NOT_MERGED: string;
-};
-export declare function evaluateCleanupGuards({ hasUncommittedChanges, hasUnpushedCommits, hasStamp, yamlStatus, ghAvailable, prMerged, }: {
-    hasUncommittedChanges: any;
-    hasUnpushedCommits: any;
-    hasStamp: any;
-    yamlStatus: any;
-    ghAvailable: any;
-    prMerged: any;
-}): {
-    allowed: boolean;
-    reason: string;
-};

package/dist/wu-create.d.ts

@@ -1,69 +0,0 @@
-#!/usr/bin/env node
-/**
- * WU Create Helper (WU-1262, WU-1439)
- *
- * Race-safe WU creation using shared micro-worktree isolation.
- *
- * Canonical sequence:
- * 1) Validate inputs (id, lane, title)
- * 2) Ensure on main branch
- * 3) Use withMicroWorktree() to atomically:
- *    a) Create temp branch without switching main checkout
- *    b) Create WU-{id}.yaml and update backlog.md in micro-worktree
- *    c) Commit with "docs: create wu-{id} for <title>" message
- *    d) Merge to main with ff-only (retry with rebase if needed)
- *    e) Push to origin/main
- *    f) Cleanup temp branch and micro-worktree
- *
- * Benefits:
- * - Main checkout never switches branches (no impact on other agents)
- * - Race conditions handled via rebase+retry (up to 3 attempts)
- * - Cleanup guaranteed even on failure
- *
- * Usage:
- *   pnpm wu:create --id WU-706 --lane Intelligence --title "Fix XYZ issue"
- *
- * Context: WU-705 (fix agent coordination failures), WU-1262 (micro-worktree isolation),
- *          WU-1439 (refactor to shared helper)
- */
-/**
- * WU-2330: Check if a more specific sub-lane matches the provided inputs.
- * Non-blocking - just logs a warning if a better lane is suggested.
- *
- * @param {string} providedLane - Lane provided by the user
- * @param {string|undefined} codePathsRaw - Comma-separated code paths
- * @param {string} title - WU title (used as fallback description)
- * @param {string|undefined} description - WU description
- */
-export declare function warnIfBetterLaneExists(providedLane: any, codePathsRaw: any, title: any, description: any): void;
-/** Options for creating WU YAML */
-interface CreateWUOptions {
-    initiative?: string;
-    phase?: string;
-    blockedBy?: string;
-    blocks?: string;
-    labels?: string;
-    assignedTo?: string;
-    description?: string;
-    acceptance?: string[];
-    codePaths?: string;
-    testPathsManual?: string;
-    testPathsUnit?: string;
-    testPathsE2e?: string;
-    exposure?: string;
-    userJourney?: string;
-    uiPairingWus?: string;
-    specRefs?: string;
-}
-export declare function validateCreateSpec({ id, lane, title, priority, type, opts, }: {
-    id: string;
-    lane: string;
-    title: string;
-    priority: string;
-    type: string;
-    opts: CreateWUOptions;
-}): {
-    valid: boolean;
-    errors: any[];
-};
-export {};

package/dist/wu-delete.d.ts

@@ -1,21 +0,0 @@
-#!/usr/bin/env node
-/**
- * WU Delete Helper
- *
- * Race-safe WU deletion using micro-worktree isolation.
- *
- * Uses micro-worktree pattern:
- * 1) Validate inputs (WU exists, status is not in_progress)
- * 2) Ensure main is clean and up-to-date with origin
- * 3) Create temp branch WITHOUT switching (main checkout stays on main)
- * 4) Create micro-worktree in /tmp pointing to temp branch
- * 5) Delete WU file and update backlog.md in micro-worktree
- * 6) Commit, ff-only merge, push
- * 7) Cleanup temp branch and micro-worktree
- *
- * Usage:
- *   pnpm wu:delete --id WU-123           # Single WU deletion
- *   pnpm wu:delete --id WU-123 --dry-run # Dry run
- *   pnpm wu:delete --batch WU-1,WU-2,WU-3 # Batch deletion
- */
-export {};

package/dist/wu-deps.d.ts

@@ -1,13 +0,0 @@
-#!/usr/bin/env node
-/**
- * WU Dependency Visualization (WU-1247)
- *
- * Shows dependency graph for a WU in ASCII or Mermaid format.
- *
- * Usage:
- *   pnpm wu:deps WU-1247                    # ASCII format
- *   pnpm wu:deps WU-1247 --format mermaid   # Mermaid diagram
- *   pnpm wu:deps WU-1247 --depth 5          # Deeper traversal
- *   pnpm wu:deps WU-1247 --direction up     # Only upstream deps
- */
-export {};