/**
 * Spec Parser - Extract User Stories and Acceptance Criteria from spec.md
 *
 * Parses increment spec.md files to extract:
 * - User Story IDs (US-001, US-002, etc.)
 * - Acceptance Criteria IDs (AC-US1-01, AC-US1-02, etc.)
 * - User Story titles and metadata
 *
 * Used by AC coverage validator to cross-reference tasks with requirements.
 */
/**
 * User Story metadata
 */
export interface UserStory {
    /** User Story ID (e.g., "US-001") */
    id: string;
    /** User Story title */
    title: string;
    /** Priority (P0, P1, P2, P3) */
    priority?: string;
    /** Acceptance Criteria IDs for this US */
    acceptanceCriteria: string[];
    /** Full text of the user story */
    description?: string;
    /** Line number in spec.md */
    lineNumber?: number;
}
/**
 * Spec metadata
 */
export interface SpecMetadata {
    /** Increment ID */
    incrementId: string;
    /** Increment title */
    title: string;
    /** All User Stories */
    userStories: UserStory[];
    /** All AC-IDs (flattened from all user stories) */
    allACIds: string[];
}
/**
 * Parse spec.md to extract User Stories and Acceptance Criteria
 *
 * @param specPath - Path to spec.md file
 * @returns Spec metadata with User Stories and AC-IDs
 * @throws Error if spec.md cannot be read or is malformed
 */
export declare function parseSpecMd(specPath: string): SpecMetadata;
/**
 * Get all User Story IDs from spec
 */
export declare function getAllUSIds(specPath: string): string[];
/**
 * Get all AC-IDs from spec
 */
export declare function getAllACIds(specPath: string): string[];
/**
 * Get AC-IDs for a specific User Story
 */
export declare function getACsForUS(specPath: string, usId: string): string[];
/**
 * Validate that an AC-ID belongs to the correct User Story
 *
 * @param acId - AC-ID to validate (e.g., "AC-US1-01")
 * @param usId - Expected User Story ID (e.g., "US-001")
 * @returns True if AC belongs to US, false otherwise
 */
export declare function validateACBelongsToUS(acId: string, usId: string): boolean;
//# sourceMappingURL=spec-parser.d.ts.map