@lumenflow/cli 2.4.0 → 2.5.0

package/dist/__tests__/init-plan.test.js

@@ -1,340 +0,0 @@
-/**
- * Tests for init:plan command (WU-1105)
- *
- * The init:plan command links plan files to initiatives by setting
- * the `related_plan` field in the initiative YAML.
- *
- * TDD: These tests are written BEFORE the implementation.
- */
-import { describe, it, expect, vi, beforeEach, afterEach, beforeAll } from 'vitest';
-import { existsSync, mkdirSync, rmSync, writeFileSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { tmpdir } from 'node:os';
-import { parseYAML, stringifyYAML } from '@lumenflow/core/dist/wu-yaml.js';
-// Pre-import the module to ensure coverage tracking includes the module itself
-let initPlanModule;
-beforeAll(async () => {
-    initPlanModule = await import('../init-plan.js');
-});
-// Mock modules before importing the module under test
-const mockGit = {
-    branch: vi.fn().mockResolvedValue({ current: 'main' }),
-    status: vi.fn().mockResolvedValue({ isClean: () => true }),
-};
-vi.mock('@lumenflow/core/dist/git-adapter.js', () => ({
-    getGitForCwd: vi.fn(() => mockGit),
-}));
-vi.mock('@lumenflow/core/dist/wu-helpers.js', () => ({
-    ensureOnMain: vi.fn().mockResolvedValue(undefined),
-}));
-vi.mock('@lumenflow/core/dist/micro-worktree.js', () => ({
-    withMicroWorktree: vi.fn(async ({ execute }) => {
-        // Simulate micro-worktree by executing in temp dir
-        const tempDir = join(tmpdir(), `init-plan-test-${Date.now()}`);
-        mkdirSync(tempDir, { recursive: true });
-        try {
-            await execute({ worktreePath: tempDir });
-        }
-        finally {
-            // Cleanup handled by test
-        }
-    }),
-}));
-describe('init:plan command', () => {
-    let tempDir;
-    let originalCwd;
-    beforeEach(() => {
-        tempDir = join(tmpdir(), `init-plan-test-${Date.now()}`);
-        mkdirSync(tempDir, { recursive: true });
-        originalCwd = process.cwd();
-    });
-    afterEach(() => {
-        process.chdir(originalCwd);
-        if (existsSync(tempDir)) {
-            rmSync(tempDir, { recursive: true, force: true });
-        }
-        vi.clearAllMocks();
-    });
-    describe('validateInitIdFormat', () => {
-        it('should accept valid INIT-NNN format', async () => {
-            const { validateInitIdFormat } = await import('../init-plan.js');
-            // Should not throw
-            expect(() => validateInitIdFormat('INIT-001')).not.toThrow();
-            expect(() => validateInitIdFormat('INIT-123')).not.toThrow();
-        });
-        it('should accept valid INIT-NAME format', async () => {
-            const { validateInitIdFormat } = await import('../init-plan.js');
-            expect(() => validateInitIdFormat('INIT-TOOLING')).not.toThrow();
-            expect(() => validateInitIdFormat('INIT-A1')).not.toThrow();
-        });
-        it('should reject invalid formats', async () => {
-            const { validateInitIdFormat } = await import('../init-plan.js');
-            expect(() => validateInitIdFormat('init-001')).toThrow();
-            expect(() => validateInitIdFormat('INIT001')).toThrow();
-            expect(() => validateInitIdFormat('WU-001')).toThrow();
-            expect(() => validateInitIdFormat('')).toThrow();
-        });
-    });
-    describe('validatePlanPath', () => {
-        it('should accept existing markdown files', async () => {
-            const { validatePlanPath } = await import('../init-plan.js');
-            const planPath = join(tempDir, 'test-plan.md');
-            writeFileSync(planPath, '# Test Plan');
-            // Should not throw
-            expect(() => validatePlanPath(planPath)).not.toThrow();
-        });
-        it('should reject non-existent files when not creating', async () => {
-            const { validatePlanPath } = await import('../init-plan.js');
-            const planPath = join(tempDir, 'nonexistent.md');
-            expect(() => validatePlanPath(planPath)).toThrow();
-        });
-        it('should reject non-markdown files', async () => {
-            const { validatePlanPath } = await import('../init-plan.js');
-            const planPath = join(tempDir, 'test-plan.txt');
-            writeFileSync(planPath, 'Test Plan');
-            expect(() => validatePlanPath(planPath)).toThrow();
-        });
-    });
-    describe('formatPlanUri', () => {
-        it('should format plan path as lumenflow:// URI', async () => {
-            const { formatPlanUri } = await import('../init-plan.js');
-            expect(formatPlanUri('docs/04-operations/plans/my-plan.md')).toBe('lumenflow://plans/my-plan.md');
-        });
-        it('should handle nested paths', async () => {
-            const { formatPlanUri } = await import('../init-plan.js');
-            expect(formatPlanUri('docs/04-operations/plans/subdir/nested-plan.md')).toBe('lumenflow://plans/subdir/nested-plan.md');
-        });
-        it('should handle paths not in standard location', async () => {
-            const { formatPlanUri } = await import('../init-plan.js');
-            // Should still create a URI even for non-standard paths
-            expect(formatPlanUri('/absolute/path/custom-plan.md')).toBe('lumenflow://plans/custom-plan.md');
-        });
-    });
-    describe('checkInitiativeExists', () => {
-        it('should return initiative doc if found', async () => {
-            const { checkInitiativeExists } = await import('../init-plan.js');
-            // Create a mock initiative file
-            const initDir = join(tempDir, 'docs', '04-operations', 'tasks', 'initiatives');
-            mkdirSync(initDir, { recursive: true });
-            const initPath = join(initDir, 'INIT-001.yaml');
-            const initDoc = {
-                id: 'INIT-001',
-                slug: 'test-initiative',
-                title: 'Test Initiative',
-                status: 'open',
-                created: '2026-01-25',
-            };
-            writeFileSync(initPath, stringifyYAML(initDoc));
-            process.chdir(tempDir);
-            const result = checkInitiativeExists('INIT-001');
-            expect(result.id).toBe('INIT-001');
-        });
-        it('should throw if initiative not found', async () => {
-            const { checkInitiativeExists } = await import('../init-plan.js');
-            process.chdir(tempDir);
-            expect(() => checkInitiativeExists('INIT-999')).toThrow();
-        });
-    });
-    describe('updateInitiativeWithPlan', () => {
-        it('should add related_plan field to initiative', async () => {
-            const { updateInitiativeWithPlan } = await import('../init-plan.js');
-            // Setup mock initiative
-            const initDir = join(tempDir, 'docs', '04-operations', 'tasks', 'initiatives');
-            mkdirSync(initDir, { recursive: true });
-            const initPath = join(initDir, 'INIT-001.yaml');
-            const initDoc = {
-                id: 'INIT-001',
-                slug: 'test-initiative',
-                title: 'Test Initiative',
-                status: 'open',
-                created: '2026-01-25',
-            };
-            writeFileSync(initPath, stringifyYAML(initDoc));
-            // Update initiative
-            const changed = updateInitiativeWithPlan(tempDir, 'INIT-001', 'lumenflow://plans/test-plan.md');
-            expect(changed).toBe(true);
-            // Verify the file was updated
-            const updated = parseYAML(readFileSync(initPath, 'utf-8'));
-            expect(updated.related_plan).toBe('lumenflow://plans/test-plan.md');
-        });
-        it('should return false if plan already linked (idempotent)', async () => {
-            const { updateInitiativeWithPlan } = await import('../init-plan.js');
-            // Setup mock initiative with existing plan
-            const initDir = join(tempDir, 'docs', '04-operations', 'tasks', 'initiatives');
-            mkdirSync(initDir, { recursive: true });
-            const initPath = join(initDir, 'INIT-001.yaml');
-            const initDoc = {
-                id: 'INIT-001',
-                slug: 'test-initiative',
-                title: 'Test Initiative',
-                status: 'open',
-                created: '2026-01-25',
-                related_plan: 'lumenflow://plans/test-plan.md',
-            };
-            writeFileSync(initPath, stringifyYAML(initDoc));
-            // Update initiative with same plan
-            const changed = updateInitiativeWithPlan(tempDir, 'INIT-001', 'lumenflow://plans/test-plan.md');
-            expect(changed).toBe(false);
-        });
-        it('should warn but proceed if different plan already linked', async () => {
-            const { updateInitiativeWithPlan } = await import('../init-plan.js');
-            const consoleSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
-            // Setup mock initiative with different plan
-            const initDir = join(tempDir, 'docs', '04-operations', 'tasks', 'initiatives');
-            mkdirSync(initDir, { recursive: true });
-            const initPath = join(initDir, 'INIT-001.yaml');
-            const initDoc = {
-                id: 'INIT-001',
-                slug: 'test-initiative',
-                title: 'Test Initiative',
-                status: 'open',
-                created: '2026-01-25',
-                related_plan: 'lumenflow://plans/old-plan.md',
-            };
-            writeFileSync(initPath, stringifyYAML(initDoc));
-            // Update initiative with new plan
-            const changed = updateInitiativeWithPlan(tempDir, 'INIT-001', 'lumenflow://plans/new-plan.md');
-            expect(changed).toBe(true);
-            expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('Replacing existing related_plan'));
-            consoleSpy.mockRestore();
-        });
-    });
-    describe('createPlanTemplate', () => {
-        it('should create a plan template file', async () => {
-            const { createPlanTemplate } = await import('../init-plan.js');
-            const plansDir = join(tempDir, 'docs', '04-operations', 'plans');
-            mkdirSync(plansDir, { recursive: true });
-            const planPath = createPlanTemplate(tempDir, 'INIT-001', 'Test Initiative');
-            expect(existsSync(planPath)).toBe(true);
-            const content = readFileSync(planPath, 'utf-8');
-            expect(content).toContain('# INIT-001');
-            expect(content).toContain('Test Initiative');
-            expect(content).toContain('## Goal');
-            expect(content).toContain('## Scope');
-        });
-        it('should not overwrite existing plan file', async () => {
-            const { createPlanTemplate } = await import('../init-plan.js');
-            const plansDir = join(tempDir, 'docs', '04-operations', 'plans');
-            mkdirSync(plansDir, { recursive: true });
-            // Create existing file
-            const existingPath = join(plansDir, 'INIT-001-test-initiative.md');
-            writeFileSync(existingPath, '# Existing Content');
-            expect(() => createPlanTemplate(tempDir, 'INIT-001', 'Test Initiative')).toThrow();
-        });
-    });
-    describe('LOG_PREFIX', () => {
-        it('should use correct log prefix', async () => {
-            const { LOG_PREFIX } = await import('../init-plan.js');
-            expect(LOG_PREFIX).toBe('[init:plan]');
-        });
-    });
-    describe('getCommitMessage', () => {
-        it('should generate correct commit message', async () => {
-            const { getCommitMessage } = await import('../init-plan.js');
-            expect(getCommitMessage('INIT-001', 'lumenflow://plans/my-plan.md')).toBe('docs: link plan my-plan.md to init-001');
-        });
-        it('should handle nested plan paths', async () => {
-            const { getCommitMessage } = await import('../init-plan.js');
-            expect(getCommitMessage('INIT-TOOLING', 'lumenflow://plans/subdir/nested-plan.md')).toBe('docs: link plan subdir/nested-plan.md to init-tooling');
-        });
-    });
-    describe('updateInitiativeWithPlan ID mismatch', () => {
-        it('should throw if initiative ID does not match', async () => {
-            const { updateInitiativeWithPlan } = await import('../init-plan.js');
-            // Setup mock initiative with different ID
-            const initDir = join(tempDir, 'docs', '04-operations', 'tasks', 'initiatives');
-            mkdirSync(initDir, { recursive: true });
-            const initPath = join(initDir, 'INIT-001.yaml');
-            const initDoc = {
-                id: 'INIT-002', // Wrong ID
-                slug: 'test-initiative',
-                title: 'Test Initiative',
-                status: 'open',
-                created: '2026-01-25',
-            };
-            writeFileSync(initPath, stringifyYAML(initDoc));
-            expect(() => updateInitiativeWithPlan(tempDir, 'INIT-001', 'lumenflow://plans/test-plan.md')).toThrow();
-        });
-    });
-});
-describe('init:plan CLI integration', () => {
-    it('should require --initiative flag', async () => {
-        // This test verifies that the CLI requires the initiative flag
-        // The actual CLI integration is tested via subprocess
-        const { WU_OPTIONS } = await import('@lumenflow/core/dist/arg-parser.js');
-        expect(WU_OPTIONS.initiative).toBeDefined();
-        expect(WU_OPTIONS.initiative.flags).toContain('--initiative');
-    });
-    it('should export main function for CLI entry', async () => {
-        const initPlan = await import('../init-plan.js');
-        expect(typeof initPlan.main).toBe('function');
-    });
-    it('should export all required functions', async () => {
-        const initPlan = await import('../init-plan.js');
-        expect(typeof initPlan.validateInitIdFormat).toBe('function');
-        expect(typeof initPlan.validatePlanPath).toBe('function');
-        expect(typeof initPlan.formatPlanUri).toBe('function');
-        expect(typeof initPlan.checkInitiativeExists).toBe('function');
-        expect(typeof initPlan.updateInitiativeWithPlan).toBe('function');
-        expect(typeof initPlan.createPlanTemplate).toBe('function');
-        expect(typeof initPlan.getCommitMessage).toBe('function');
-        expect(typeof initPlan.LOG_PREFIX).toBe('string');
-    });
-});
-describe('createPlanTemplate edge cases', () => {
-    let tempDir;
-    let originalCwd;
-    beforeEach(() => {
-        tempDir = join(tmpdir(), `init-plan-test-${Date.now()}`);
-        mkdirSync(tempDir, { recursive: true });
-        originalCwd = process.cwd();
-    });
-    afterEach(() => {
-        process.chdir(originalCwd);
-        if (existsSync(tempDir)) {
-            rmSync(tempDir, { recursive: true, force: true });
-        }
-        vi.clearAllMocks();
-    });
-    it('should create plans directory if it does not exist', async () => {
-        const { createPlanTemplate } = await import('../init-plan.js');
-        // Do NOT pre-create the plans directory
-        const planPath = createPlanTemplate(tempDir, 'INIT-001', 'Test Initiative');
-        expect(existsSync(planPath)).toBe(true);
-        expect(planPath).toContain('docs/04-operations/plans');
-    });
-    it('should truncate long titles in filename', async () => {
-        const { createPlanTemplate } = await import('../init-plan.js');
-        const longTitle = 'This is an extremely long initiative title that should be truncated in the filename';
-        const planPath = createPlanTemplate(tempDir, 'INIT-001', longTitle);
-        expect(existsSync(planPath)).toBe(true);
-        // Filename should be truncated
-        const filename = planPath.split('/').pop() || '';
-        // INIT-001- is 9 chars, .md is 3 chars, slug should be max 30 chars
-        expect(filename.length).toBeLessThanOrEqual(9 + 30 + 3);
-    });
-    it('should handle special characters in title', async () => {
-        const { createPlanTemplate } = await import('../init-plan.js');
-        const specialTitle = "Test's Initiative: (Special) Chars! @#$%";
-        const planPath = createPlanTemplate(tempDir, 'INIT-001', specialTitle);
-        expect(existsSync(planPath)).toBe(true);
-        // Filename should only have kebab-case characters
-        expect(planPath).toMatch(/INIT-001-[a-z0-9-]+\.md$/);
-    });
-});
-/**
- * Note on main() function testing:
- *
- * The main() function is intentionally not unit-tested because:
- * 1. It calls die() which invokes process.exit() - difficult to mock without complex test infrastructure
- * 2. It involves micro-worktree operations with git
- * 3. All business logic functions it calls ARE thoroughly tested above
- *
- * The main() function is integration/orchestration code that composes the tested helper functions.
- * Integration testing via subprocess (pnpm init:plan) is the appropriate testing strategy for main().
- *
- * Coverage statistics:
- * - All exported helper functions: ~100% coverage
- * - main() function: Not unit tested (orchestration code)
- * - Overall file coverage: ~50% (acceptable for CLI commands)
- */

package/dist/agent-issues-query.d.ts

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-/**
- * Agent Issues Query CLI (WU-1018)
- *
- * Query and display logged agent incidents/issues.
- *
- * Usage:
- *   pnpm agent:issues-query summary                 # Summary of last 7 days
- *   pnpm agent:issues-query summary --since 30     # Summary of last 30 days
- *   pnpm agent:issues-query summary --category tooling
- *   pnpm agent:issues-query summary --severity blocker
- *
- * @module agent-issues-query
- * @see {@link @lumenflow/agent}
- */
-export {};

package/dist/agent-log-issue.d.ts

@@ -1,10 +0,0 @@
-#!/usr/bin/env node
-/**
- * Agent Log Issue CLI
- *
- * Logs a workflow issue or incident during agent execution.
- *
- * Usage:
- *   pnpm agent:log-issue --category workflow --severity minor --title "..." --description "..."
- */
-export {};

package/dist/agent-session-end.d.ts

@@ -1,10 +0,0 @@
-#!/usr/bin/env node
-/**
- * Agent Session End CLI
- *
- * Ends the current agent session and returns summary.
- *
- * Usage:
- *   pnpm agent:session:end
- */
-export {};

package/dist/agent-session.d.ts

@@ -1,10 +0,0 @@
-#!/usr/bin/env node
-/**
- * Agent Session Start CLI
- *
- * Starts an agent session for tracking WU execution.
- *
- * Usage:
- *   pnpm agent:session --wu WU-1234 --tier 2
- */
-export {};

package/dist/backlog-prune.d.ts

@@ -1,84 +0,0 @@
-#!/usr/bin/env node
-/**
- * Backlog Prune Command
- *
- * Maintains backlog hygiene by:
- * - Auto-tagging stale WUs (in_progress/ready too long without activity)
- * - Archiving old completed WUs (done for > N days)
- *
- * WU-1106: INIT-003 Phase 3b - Migrate from PatientPath tools/backlog-prune.mjs
- *
- * Usage:
- *   pnpm backlog:prune           # Dry-run mode (shows what would be done)
- *   pnpm backlog:prune --execute # Apply changes
- */
-/**
- * Default configuration for backlog pruning
- */
-export declare const BACKLOG_PRUNE_DEFAULTS: {
-    /** Days without activity before in_progress WU is considered stale */
-    staleDaysInProgress: number;
-    /** Days without activity before ready WU is considered stale */
-    staleDaysReady: number;
-    /** Days after completion before done WU can be archived */
-    archiveDaysDone: number;
-};
-/**
- * Arguments for backlog-prune command
- */
-export interface BacklogPruneArgs {
-    dryRun: boolean;
-    staleDaysInProgress: number;
-    staleDaysReady: number;
-    archiveDaysDone: number;
-    help?: boolean;
-}
-/**
- * Minimal WU information needed for prune analysis
- */
-export interface WuPruneInfo {
-    id: string;
-    status: string;
-    title?: string;
-    created?: string;
-    updated?: string;
-    completed?: string;
-}
-/**
- * Result of WU categorization
- */
-export interface PruneCategorization {
-    stale: WuPruneInfo[];
-    archivable: WuPruneInfo[];
-    healthy: WuPruneInfo[];
-}
-/**
- * Parse command line arguments for backlog-prune
- */
-export declare function parseBacklogPruneArgs(argv: string[]): BacklogPruneArgs;
-/**
- * Calculate days since a date string
- * @returns Number of days since date, or null if invalid
- */
-export declare function calculateStaleDays(dateStr: string | undefined | null): number | null;
-/**
- * Check if a WU is stale based on its status and last activity date
- */
-export declare function isWuStale(wu: WuPruneInfo, options: {
-    staleDaysInProgress?: number;
-    staleDaysReady?: number;
-}): boolean;
-/**
- * Check if a WU is archivable (done for more than N days)
- */
-export declare function isWuArchivable(wu: WuPruneInfo, options: {
-    archiveDaysDone?: number;
-}): boolean;
-/**
- * Categorize WUs into stale, archivable, and healthy
- */
-export declare function categorizeWus(wus: WuPruneInfo[], options: {
-    staleDaysInProgress: number;
-    staleDaysReady: number;
-    archiveDaysDone: number;
-}): PruneCategorization;

package/dist/cli-entry-point.d.ts

@@ -1,8 +0,0 @@
-/**
- * Wraps an async main function with proper error handling.
- * WU-1085: Also initializes color support based on NO_COLOR/FORCE_COLOR/--no-color
- *
- * @param main - The async main function to execute
- * @returns Promise that resolves when main completes (or after error handling)
- */
-export declare function runCLI(main: () => Promise<void>): Promise<void>;

package/dist/deps-add.d.ts

@@ -1,91 +0,0 @@
-#!/usr/bin/env node
-/**
- * Deps Add CLI Command
- *
- * Safe wrapper for `pnpm add` that enforces worktree discipline.
- * Dependencies can only be added from within a worktree, not from main checkout.
- *
- * WU-1112: INIT-003 Phase 6 - Migrate remaining Tier 1 tools
- *
- * Usage:
- *   pnpm deps:add react
- *   pnpm deps:add --dev vitest
- *   pnpm deps:add --filter @lumenflow/cli chalk
- *
- * @see dependency-guard.ts for blocking logic
- */
-/**
- * Arguments for deps-add command
- */
-export interface DepsAddArgs {
-    /** Package names to add */
-    packages?: string[];
-    /** Add as dev dependency */
-    dev?: boolean;
-    /** Filter to specific workspace package */
-    filter?: string;
-    /** Use exact version */
-    exact?: boolean;
-    /** Show help */
-    help?: boolean;
-}
-/**
- * Arguments for deps-remove command (also exported from here for convenience)
- */
-export interface DepsRemoveArgs {
-    /** Package names to remove */
-    packages?: string[];
-    /** Filter to specific workspace package */
-    filter?: string;
-    /** Show help */
-    help?: boolean;
-}
-/**
- * Result of worktree context validation
- */
-export interface WorktreeValidationResult {
-    /** Whether the context is valid (inside worktree) */
-    valid: boolean;
-    /** Error message if invalid */
-    error?: string;
-    /** Fix command suggestion */
-    fixCommand?: string;
-}
-/**
- * Parse command line arguments for deps-add
- *
- * @param argv - Process argv array
- * @returns Parsed arguments
- */
-export declare function parseDepsAddArgs(argv: string[]): DepsAddArgs;
-/**
- * Parse command line arguments for deps-remove
- *
- * @param argv - Process argv array
- * @returns Parsed arguments
- */
-export declare function parseDepsRemoveArgs(argv: string[]): DepsRemoveArgs;
-/**
- * Validate that the current directory is within a worktree
- *
- * Dependencies should only be modified in worktrees to maintain
- * isolation and prevent lockfile conflicts on main checkout.
- *
- * @param cwd - Current working directory to validate
- * @returns Validation result with error and fix command if invalid
- */
-export declare function validateWorktreeContext(cwd: string): WorktreeValidationResult;
-/**
- * Build pnpm add command string from arguments
- *
- * @param args - Parsed deps-add arguments
- * @returns Command string ready for execution
- */
-export declare function buildPnpmAddCommand(args: DepsAddArgs): string;
-/**
- * Build pnpm remove command string from arguments
- *
- * @param args - Parsed deps-remove arguments
- * @returns Command string ready for execution
- */
-export declare function buildPnpmRemoveCommand(args: DepsRemoveArgs): string;

package/dist/deps-remove.d.ts

@@ -1,17 +0,0 @@
-#!/usr/bin/env node
-/**
- * Deps Remove CLI Command
- *
- * Safe wrapper for `pnpm remove` that enforces worktree discipline.
- * Dependencies can only be removed from within a worktree, not from main checkout.
- *
- * WU-1112: INIT-003 Phase 6 - Migrate remaining Tier 1 tools
- *
- * Usage:
- *   pnpm deps:remove lodash
- *   pnpm deps:remove --filter @lumenflow/cli chalk
- *
- * @see dependency-guard.ts for blocking logic
- */
-import { type DepsRemoveArgs } from './deps-add.js';
-export type { DepsRemoveArgs };

package/dist/docs-sync.d.ts

@@ -1,50 +0,0 @@
-/**
- * @file docs-sync.ts
- * LumenFlow docs:sync command for syncing agent docs to existing projects (WU-1083)
- * WU-1085: Added createWUParser for proper --help support
- * WU-1124: Refactored to read templates from bundled files (INIT-004 Phase 2)
- */
-export type VendorType = 'claude' | 'cursor' | 'aider' | 'all' | 'none';
-/**
- * WU-1085: Parse docs-sync command options using createWUParser
- * Provides proper --help, --version, and option parsing
- */
-export declare function parseDocsSyncOptions(): {
-    force: boolean;
-    vendor: VendorType;
-};
-export interface SyncOptions {
-    force: boolean;
-    vendor?: VendorType;
-}
-export interface SyncResult {
-    created: string[];
-    skipped: string[];
-}
-/**
- * WU-1124: Get the templates directory path
- * Templates are bundled with the CLI package at dist/templates/
- * Falls back to src/templates/ for development
- */
-export declare function getTemplatesDir(): string;
-/**
- * WU-1124: Load a template file from the bundled templates directory
- * @param templatePath - Relative path from templates directory (e.g., 'core/ai/onboarding/quick-ref-commands.md.template')
- * @returns Template content as string
- */
-export declare function loadTemplate(templatePath: string): string;
-/**
- * Sync agent onboarding docs to an existing project
- * WU-1124: Now reads templates from bundled files instead of hardcoded strings
- */
-export declare function syncAgentDocs(targetDir: string, options: SyncOptions): Promise<SyncResult>;
-/**
- * Sync Claude skills to an existing project
- * WU-1124: Now reads templates from bundled files instead of hardcoded strings
- */
-export declare function syncSkills(targetDir: string, options: SyncOptions): Promise<SyncResult>;
-/**
- * CLI entry point for docs:sync command
- * WU-1085: Updated to use parseDocsSyncOptions for proper --help support
- */
-export declare function main(): Promise<void>;