/**
 * Documentation CLI commands
 *
 * Provides CLI interface for documentation preview, build, and validation.
 * Works in ANY SpecWeave user project, not just the SpecWeave repo itself.
 *
 * @module cli/commands/docs
 */
import type { DocScope } from '../../utils/docs-preview/types.js';
/** Parsed umbrella configuration */
export interface UmbrellaConfig {
    enabled: boolean;
    childRepos: Array<{
        id: string;
        path: string;
        name: string;
    }>;
}
/** Result of resolving the effective docs root */
export interface DocsRootResolution {
    effectiveRoot: string;
    repoName?: string;
    umbrellaConfig: UmbrellaConfig | null;
}
/**
 * Parse umbrella config from .specweave/config.json.
 * Returns null if not an umbrella project or config is unreadable.
 */
export declare function getUmbrellaConfig(projectRoot: string): UmbrellaConfig | null;
/**
 * Resolve the effective project root for docs operations.
 * When --project is given, resolves to the child repo path.
 * When not given, returns the current project root.
 */
export declare function resolveDocsRoot(projectRoot: string, project?: string): DocsRootResolution;
export interface DocsPreviewOptions {
    port?: number;
    force?: boolean;
    noBrowser?: boolean;
    validate?: boolean;
    autoFix?: boolean;
    scope?: DocScope;
    project?: string;
}
export interface DocsBuildOptions {
    validate?: boolean;
    autoFix?: boolean;
    output?: string;
    scope?: DocScope;
    project?: string;
}
export interface DocsValidateOptions {
    autoFix?: boolean;
    verbose?: boolean;
    scope?: DocScope;
    project?: string;
}
/**
 * Preview documentation with Docusaurus dev server
 */
export declare function docsPreviewCommand(options?: DocsPreviewOptions): Promise<void>;
/**
 * Build static documentation site
 */
export declare function docsBuildCommand(options?: DocsBuildOptions): Promise<void>;
/**
 * Validate documentation without starting server
 */
export declare function docsValidateCommand(options?: DocsValidateOptions): Promise<void>;
/**
 * Kill all running Docusaurus processes
 */
export declare function docsKillCommand(): Promise<void>;
/**
 * Show docs status and help
 */
export declare function docsStatusCommand(options?: {
    project?: string;
}): Promise<void>;
//# sourceMappingURL=docs.d.ts.map