@sudocode-ai/integration-openspec 0.1.14

package/dist/parser/markdown-utils.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Shared Markdown Utilities for OpenSpec Parsing
+ *
+ * Common regex patterns and helper functions for extracting
+ * metadata from OpenSpec markdown files.
+ */
+/**
+ * Regex patterns for common markdown elements in OpenSpec files
+ */
+export declare const PATTERNS: {
+    /** Match H1 title: # Title */
+    TITLE: RegExp;
+    /** Match title with prefix: # Feature Specification: Title */
+    TITLE_WITH_PREFIX: RegExp;
+    /** Match metadata line: **Key**: Value */
+    METADATA: RegExp;
+    /** Match status metadata: **Status**: Value */
+    STATUS: RegExp;
+    /** Match feature branch metadata: **Feature Branch**: Value */
+    FEATURE_BRANCH: RegExp;
+    /** Match branch metadata: **Branch**: Value */
+    BRANCH: RegExp;
+    /** Match created date metadata: **Created**: Value */
+    CREATED: RegExp;
+    /** Match spec link metadata: **Spec**: [[link]] or **Spec**: link */
+    SPEC_LINK: RegExp;
+    /** Match cross-reference: [[id]] or [[id|display]] */
+    CROSS_REFERENCE: RegExp;
+    /** Match task line: - [ ] T001 [P] [US1] Description or - [x] T001: Description */
+    TASK_LINE: RegExp;
+    /** Match parallelizable marker: [P] */
+    PARALLELIZABLE: RegExp;
+    /** Match user story marker: [US1], [US2], etc. */
+    USER_STORY: RegExp;
+    /** Match phase header: ## Phase N: Name or ### Phase N */
+    PHASE_HEADER: RegExp;
+    /** Match section header: ## Section Name */
+    SECTION_HEADER: RegExp;
+    /** Match date format: YYYY-MM-DD */
+    DATE: RegExp;
+    /** Match ISO date with time */
+    ISO_DATE: RegExp;
+};
+/**
+ * Extract all metadata from a markdown file's lines
+ *
+ * @param lines - Array of file lines
+ * @returns Map of metadata key-value pairs
+ *
+ * @example
+ * const lines = [
+ *   "# Title",
+ *   "",
+ *   "**Status**: Draft",
+ *   "**Created**: 2024-01-01",
+ * ];
+ * extractMetadata(lines);
+ * // Map { "Status" => "Draft", "Created" => "2024-01-01" }
+ */
+export declare function extractMetadata(lines: string[]): Map<string, string>;
+/**
+ * Extract the title from markdown content
+ *
+ * @param lines - Array of file lines
+ * @returns The title text or null if not found
+ */
+export declare function extractTitle(lines: string[]): string | null;
+/**
+ * Extract title with optional prefix removal
+ *
+ * @param lines - Array of file lines
+ * @param prefixes - Optional prefixes to remove (e.g., ["Feature Specification:", "Implementation Plan:"])
+ * @returns The clean title text or null
+ */
+export declare function extractTitleWithPrefixRemoval(lines: string[], prefixes?: string[]): string | null;
+/**
+ * Extract a specific metadata value by key (case-insensitive)
+ *
+ * @param lines - Array of file lines
+ * @param key - The metadata key to find
+ * @returns The value or null if not found
+ */
+export declare function extractMetadataValue(lines: string[], key: string): string | null;
+/**
+ * Extract all cross-references from markdown content
+ *
+ * @param content - The full markdown content as a string
+ * @returns Array of cross-reference objects
+ */
+export declare function extractCrossReferences(content: string): Array<{
+    id: string;
+    displayText?: string;
+}>;
+/**
+ * Find the line index where the main content starts (after metadata)
+ *
+ * @param lines - Array of file lines
+ * @returns Index of the first content line
+ */
+export declare function findContentStartIndex(lines: string[]): number;
+/**
+ * Extract section content by header
+ *
+ * @param lines - Array of file lines
+ * @param sectionName - Name of the section to extract
+ * @param headerLevel - Header level (2-6, default 2 for ##)
+ * @returns Section content as array of lines, or null if not found
+ */
+export declare function extractSection(lines: string[], sectionName: string, headerLevel?: number): string[] | null;
+/**
+ * Parse a date string from various formats
+ *
+ * @param dateStr - Date string to parse
+ * @returns Date object or null if invalid
+ */
+export declare function parseDate(dateStr: string): Date | null;
+/**
+ * Escape special regex characters in a string
+ *
+ * @param str - String to escape
+ * @returns Escaped string safe for use in regex
+ */
+export declare function escapeRegex(str: string): string;
+/**
+ * Clean task description by removing markers
+ *
+ * @param description - Raw task description
+ * @returns Cleaned description
+ */
+export declare function cleanTaskDescription(description: string): string;
+/**
+ * Normalize status string to a consistent format
+ *
+ * @param status - Raw status string
+ * @returns Normalized status
+ */
+export declare function normalizeStatus(status: string): string;
+//# sourceMappingURL=markdown-utils.d.ts.map

package/dist/parser/markdown-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-utils.d.ts","sourceRoot":"","sources":["../../src/parser/markdown-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,QAAQ;IACnB,8BAA8B;;IAG9B,8DAA8D;;IAG9D,0CAA0C;;IAG1C,+CAA+C;;IAG/C,+DAA+D;;IAG/D,+CAA+C;;IAG/C,sDAAsD;;IAGtD,qEAAqE;;IAGrE,sDAAsD;;IAGtD,mFAAmF;;IAGnF,uCAAuC;;IAGvC,kDAAkD;;IAGlD,0DAA0D;;IAG1D,4CAA4C;;IAG5C,oCAAoC;;IAGpC,+BAA+B;;CAEhC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAYpE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAQ3D;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,GAAE,MAAM,EAAO,GACtB,MAAM,GAAG,IAAI,CAef;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EAAE,EACf,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,IAAI,CAWf;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,GACd,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAa7C;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAgC7D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,EAAE,MAAM,EACnB,WAAW,GAAE,MAAU,GACtB,MAAM,EAAE,GAAG,IAAI,CAiCjB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAoBtD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAOhE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAmBtD"}

package/dist/parser/markdown-utils.js

@@ -0,0 +1,283 @@
+/**
+ * Shared Markdown Utilities for OpenSpec Parsing
+ *
+ * Common regex patterns and helper functions for extracting
+ * metadata from OpenSpec markdown files.
+ */
+/**
+ * Regex patterns for common markdown elements in OpenSpec files
+ */
+export const PATTERNS = {
+    /** Match H1 title: # Title */
+    TITLE: /^#\s+(.+)$/,
+    /** Match title with prefix: # Feature Specification: Title */
+    TITLE_WITH_PREFIX: /^#\s+(?:Feature Specification|Implementation Plan):\s*(.+)$/i,
+    /** Match metadata line: **Key**: Value */
+    METADATA: /^\*\*([^*]+)\*\*:\s*(.*)$/,
+    /** Match status metadata: **Status**: Value */
+    STATUS: /^\*\*Status\*\*:\s*(.*)$/i,
+    /** Match feature branch metadata: **Feature Branch**: Value */
+    FEATURE_BRANCH: /^\*\*Feature Branch\*\*:\s*(.*)$/i,
+    /** Match branch metadata: **Branch**: Value */
+    BRANCH: /^\*\*Branch\*\*:\s*(.*)$/i,
+    /** Match created date metadata: **Created**: Value */
+    CREATED: /^\*\*Created\*\*:\s*(.*)$/i,
+    /** Match spec link metadata: **Spec**: [[link]] or **Spec**: link */
+    SPEC_LINK: /^\*\*Spec\*\*:\s*(?:\[\[)?([^\]]+)(?:\]\])?$/i,
+    /** Match cross-reference: [[id]] or [[id|display]] */
+    CROSS_REFERENCE: /\[\[([^\]|]+)(?:\|([^\]]+))?\]\]/g,
+    /** Match task line: - [ ] T001 [P] [US1] Description or - [x] T001: Description */
+    TASK_LINE: /^(\s*)-\s*\[([ xX])\]\s*(T\d+)(.*)$/,
+    /** Match parallelizable marker: [P] */
+    PARALLELIZABLE: /\[P\]/i,
+    /** Match user story marker: [US1], [US2], etc. */
+    USER_STORY: /\[US(\d+)\]/i,
+    /** Match phase header: ## Phase N: Name or ### Phase N */
+    PHASE_HEADER: /^#{2,3}\s+Phase\s+(\d+)(?::\s*(.+))?$/i,
+    /** Match section header: ## Section Name */
+    SECTION_HEADER: /^(#{2,6})\s+(.+)$/,
+    /** Match date format: YYYY-MM-DD */
+    DATE: /^\d{4}-\d{2}-\d{2}$/,
+    /** Match ISO date with time */
+    ISO_DATE: /^\d{4}-\d{2}-\d{2}(?:T\d{2}:\d{2}:\d{2})?/,
+};
+/**
+ * Extract all metadata from a markdown file's lines
+ *
+ * @param lines - Array of file lines
+ * @returns Map of metadata key-value pairs
+ *
+ * @example
+ * const lines = [
+ *   "# Title",
+ *   "",
+ *   "**Status**: Draft",
+ *   "**Created**: 2024-01-01",
+ * ];
+ * extractMetadata(lines);
+ * // Map { "Status" => "Draft", "Created" => "2024-01-01" }
+ */
+export function extractMetadata(lines) {
+    const metadata = new Map();
+    for (const line of lines) {
+        const match = line.match(PATTERNS.METADATA);
+        if (match) {
+            const [, key, value] = match;
+            metadata.set(key.trim(), value.trim());
+        }
+    }
+    return metadata;
+}
+/**
+ * Extract the title from markdown content
+ *
+ * @param lines - Array of file lines
+ * @returns The title text or null if not found
+ */
+export function extractTitle(lines) {
+    for (const line of lines) {
+        const match = line.match(PATTERNS.TITLE);
+        if (match) {
+            return match[1].trim();
+        }
+    }
+    return null;
+}
+/**
+ * Extract title with optional prefix removal
+ *
+ * @param lines - Array of file lines
+ * @param prefixes - Optional prefixes to remove (e.g., ["Feature Specification:", "Implementation Plan:"])
+ * @returns The clean title text or null
+ */
+export function extractTitleWithPrefixRemoval(lines, prefixes = []) {
+    const rawTitle = extractTitle(lines);
+    if (!rawTitle)
+        return null;
+    // Try to match and remove known prefixes
+    for (const prefix of prefixes) {
+        const prefixLower = prefix.toLowerCase();
+        if (rawTitle.toLowerCase().startsWith(prefixLower)) {
+            const remainder = rawTitle.slice(prefix.length).trim();
+            // Remove leading colon if present
+            return remainder.startsWith(":") ? remainder.slice(1).trim() : remainder;
+        }
+    }
+    return rawTitle;
+}
+/**
+ * Extract a specific metadata value by key (case-insensitive)
+ *
+ * @param lines - Array of file lines
+ * @param key - The metadata key to find
+ * @returns The value or null if not found
+ */
+export function extractMetadataValue(lines, key) {
+    const keyLower = key.toLowerCase();
+    for (const line of lines) {
+        const match = line.match(PATTERNS.METADATA);
+        if (match && match[1].trim().toLowerCase() === keyLower) {
+            return match[2].trim();
+        }
+    }
+    return null;
+}
+/**
+ * Extract all cross-references from markdown content
+ *
+ * @param content - The full markdown content as a string
+ * @returns Array of cross-reference objects
+ */
+export function extractCrossReferences(content) {
+    const references = [];
+    const regex = new RegExp(PATTERNS.CROSS_REFERENCE.source, "g");
+    let match;
+    while ((match = regex.exec(content)) !== null) {
+        references.push({
+            id: match[1].trim(),
+            displayText: match[2]?.trim(),
+        });
+    }
+    return references;
+}
+/**
+ * Find the line index where the main content starts (after metadata)
+ *
+ * @param lines - Array of file lines
+ * @returns Index of the first content line
+ */
+export function findContentStartIndex(lines) {
+    let titleFound = false;
+    let lastMetadataIndex = -1;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Track title
+        if (!titleFound && PATTERNS.TITLE.test(line)) {
+            titleFound = true;
+            continue;
+        }
+        // Track metadata lines
+        if (PATTERNS.METADATA.test(line)) {
+            lastMetadataIndex = i;
+            continue;
+        }
+        // Skip blank lines after metadata
+        if (line.trim() === "") {
+            continue;
+        }
+        // If we're past the title and metadata, this is content start
+        if (titleFound && i > lastMetadataIndex) {
+            return i;
+        }
+    }
+    // Return end of file if no content found
+    return lines.length;
+}
+/**
+ * Extract section content by header
+ *
+ * @param lines - Array of file lines
+ * @param sectionName - Name of the section to extract
+ * @param headerLevel - Header level (2-6, default 2 for ##)
+ * @returns Section content as array of lines, or null if not found
+ */
+export function extractSection(lines, sectionName, headerLevel = 2) {
+    const headerPrefix = "#".repeat(headerLevel);
+    const sectionRegex = new RegExp(`^${headerPrefix}\\s+${escapeRegex(sectionName)}\\s*$`, "i");
+    const nextHeaderRegex = new RegExp(`^#{1,${headerLevel}}\\s+`);
+    let sectionStart = -1;
+    let sectionEnd = lines.length;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (sectionStart === -1) {
+            // Looking for section start
+            if (sectionRegex.test(line)) {
+                sectionStart = i + 1; // Start after header
+            }
+        }
+        else {
+            // Looking for section end (next header at same or higher level)
+            if (nextHeaderRegex.test(line)) {
+                sectionEnd = i;
+                break;
+            }
+        }
+    }
+    if (sectionStart === -1) {
+        return null;
+    }
+    return lines.slice(sectionStart, sectionEnd);
+}
+/**
+ * Parse a date string from various formats
+ *
+ * @param dateStr - Date string to parse
+ * @returns Date object or null if invalid
+ */
+export function parseDate(dateStr) {
+    if (!dateStr)
+        return null;
+    // Try ISO format first
+    if (PATTERNS.ISO_DATE.test(dateStr)) {
+        const date = new Date(dateStr);
+        if (!isNaN(date.getTime())) {
+            return date;
+        }
+    }
+    // Try simple date format
+    if (PATTERNS.DATE.test(dateStr)) {
+        const date = new Date(dateStr + "T00:00:00");
+        if (!isNaN(date.getTime())) {
+            return date;
+        }
+    }
+    return null;
+}
+/**
+ * Escape special regex characters in a string
+ *
+ * @param str - String to escape
+ * @returns Escaped string safe for use in regex
+ */
+export function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Clean task description by removing markers
+ *
+ * @param description - Raw task description
+ * @returns Cleaned description
+ */
+export function cleanTaskDescription(description) {
+    return description
+        .replace(PATTERNS.PARALLELIZABLE, "")
+        .replace(PATTERNS.USER_STORY, "")
+        .replace(/^\s*:\s*/, "") // Remove leading colon with surrounding whitespace
+        .replace(/\s+/g, " ") // Normalize whitespace
+        .trim();
+}
+/**
+ * Normalize status string to a consistent format
+ *
+ * @param status - Raw status string
+ * @returns Normalized status
+ */
+export function normalizeStatus(status) {
+    const statusLower = status.toLowerCase().trim();
+    const statusMap = {
+        draft: "Draft",
+        "in progress": "In Progress",
+        "in-progress": "In Progress",
+        inprogress: "In Progress",
+        blocked: "Blocked",
+        complete: "Complete",
+        completed: "Complete",
+        done: "Complete",
+        review: "Review",
+        "needs review": "Needs Review",
+        "needs-review": "Needs Review",
+        approved: "Approved",
+    };
+    return statusMap[statusLower] || status;
+}
+//# sourceMappingURL=markdown-utils.js.map

package/dist/parser/markdown-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-utils.js","sourceRoot":"","sources":["../../src/parser/markdown-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,8BAA8B;IAC9B,KAAK,EAAE,YAAY;IAEnB,8DAA8D;IAC9D,iBAAiB,EAAE,8DAA8D;IAEjF,0CAA0C;IAC1C,QAAQ,EAAE,2BAA2B;IAErC,+CAA+C;IAC/C,MAAM,EAAE,2BAA2B;IAEnC,+DAA+D;IAC/D,cAAc,EAAE,mCAAmC;IAEnD,+CAA+C;IAC/C,MAAM,EAAE,2BAA2B;IAEnC,sDAAsD;IACtD,OAAO,EAAE,4BAA4B;IAErC,qEAAqE;IACrE,SAAS,EAAE,+CAA+C;IAE1D,sDAAsD;IACtD,eAAe,EAAE,mCAAmC;IAEpD,mFAAmF;IACnF,SAAS,EAAE,qCAAqC;IAEhD,uCAAuC;IACvC,cAAc,EAAE,QAAQ;IAExB,kDAAkD;IAClD,UAAU,EAAE,cAAc;IAE1B,0DAA0D;IAC1D,YAAY,EAAE,wCAAwC;IAEtD,4CAA4C;IAC5C,cAAc,EAAE,mBAAmB;IAEnC,oCAAoC;IACpC,IAAI,EAAE,qBAAqB;IAE3B,+BAA+B;IAC/B,QAAQ,EAAE,2CAA2C;CACtD,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAAC,KAAe;IAC7C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC;YAC7B,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAe;IAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAe,EACf,WAAqB,EAAE;IAEvB,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,yCAAyC;IACzC,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACzC,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YACnD,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YACvD,kCAAkC;YAClC,OAAO,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAe,EACf,GAAW;IAEX,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAEnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,QAAQ,EAAE,CAAC;YACxD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAe;IAEf,MAAM,UAAU,GAAgD,EAAE,CAAC;IACnE,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE/D,IAAI,KAAK,CAAC;IACV,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9C,UAAU,CAAC,IAAI,CAAC;YACd,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;YACnB,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAe;IACnD,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,iBAAiB,GAAG,CAAC,CAAC,CAAC;IAE3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAEtB,cAAc;QACd,IAAI,CAAC,UAAU,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,UAAU,GAAG,IAAI,CAAC;YAClB,SAAS;QACX,CAAC;QAED,uBAAuB;QACvB,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,iBAAiB,GAAG,CAAC,CAAC;YACtB,SAAS;QACX,CAAC;QAED,kCAAkC;QAClC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACvB,SAAS;QACX,CAAC;QAED,8DAA8D;QAC9D,IAAI,UAAU,IAAI,CAAC,GAAG,iBAAiB,EAAE,CAAC;YACxC,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,OAAO,KAAK,CAAC,MAAM,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAe,EACf,WAAmB,EACnB,cAAsB,CAAC;IAEvB,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,IAAI,MAAM,CAC7B,IAAI,YAAY,OAAO,WAAW,CAAC,WAAW,CAAC,OAAO,EACtD,GAAG,CACJ,CAAC;IACF,MAAM,eAAe,GAAG,IAAI,MAAM,CAAC,QAAQ,WAAW,OAAO,CAAC,CAAC;IAE/D,IAAI,YAAY,GAAG,CAAC,CAAC,CAAC;IACtB,IAAI,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;IAE9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAEtB,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;YACxB,4BAA4B;YAC5B,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,YAAY,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,qBAAqB;YAC7C,CAAC;QACH,CAAC;aAAM,CAAC;YACN,gEAAgE;YAChE,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,UAAU,GAAG,CAAC,CAAC;gBACf,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,uBAAuB;IACvB,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,OAAO,WAAW;SACf,OAAO,CAAC,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC;SACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC;SAChC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,mDAAmD;SAC3E,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,uBAAuB;SAC5C,IAAI,EAAE,CAAC;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAEhD,MAAM,SAAS,GAA2B;QACxC,KAAK,EAAE,OAAO;QACd,aAAa,EAAE,aAAa;QAC5B,aAAa,EAAE,aAAa;QAC5B,UAAU,EAAE,aAAa;QACzB,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,UAAU;QACrB,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,QAAQ;QAChB,cAAc,EAAE,cAAc;QAC9B,cAAc,EAAE,cAAc;QAC9B,QAAQ,EAAE,UAAU;KACrB,CAAC;IAEF,OAAO,SAAS,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC;AAC1C,CAAC"}

package/dist/parser/spec-parser.d.ts

@@ -0,0 +1,116 @@
+/**
+ * OpenSpec Spec Parser
+ *
+ * Parses OpenSpec specification files from `openspec/specs/[capability]/spec.md`.
+ *
+ * OpenSpec spec format:
+ * - Title from H1 heading: `# Title`
+ * - Purpose section: `## Purpose`
+ * - Requirements: `### Requirement: Name`
+ * - Scenarios: `#### Scenario: Description` with GIVEN/WHEN/THEN steps
+ */
+/**
+ * A parsed scenario from an OpenSpec requirement
+ */
+export interface ParsedScenario {
+    /** Scenario description from `#### Scenario: Description` */
+    description: string;
+    /** GIVEN steps (preconditions) */
+    given?: string[];
+    /** WHEN steps (actions) */
+    when?: string[];
+    /** THEN steps (expected outcomes) */
+    then?: string[];
+}
+/**
+ * A parsed requirement from an OpenSpec spec
+ */
+export interface ParsedRequirement {
+    /** Requirement name from `### Requirement: Name` */
+    name: string;
+    /** Full content of the requirement section */
+    content: string;
+    /** Scenarios within this requirement */
+    scenarios: ParsedScenario[];
+}
+/**
+ * A fully parsed OpenSpec specification
+ */
+export interface ParsedOpenSpecSpec {
+    /** Directory name (e.g., "cli-init") */
+    capability: string;
+    /** Title from H1 heading */
+    title: string;
+    /** Content from ## Purpose section */
+    purpose?: string;
+    /** Parsed requirements */
+    requirements: ParsedRequirement[];
+    /** Full markdown content of the file */
+    rawContent: string;
+    /** Absolute path to the spec file */
+    filePath: string;
+}
+/**
+ * OpenSpec-specific patterns for parsing spec files
+ */
+export declare const SPEC_PATTERNS: {
+    /** Match requirement header: ### Requirement: Name */
+    REQUIREMENT: RegExp;
+    /** Match scenario header: #### Scenario: Description */
+    SCENARIO: RegExp;
+    /** Match GIVEN step: - **GIVEN** content or **GIVEN**: content */
+    GIVEN: RegExp;
+    /** Match WHEN step: - **WHEN** content or **WHEN**: content */
+    WHEN: RegExp;
+    /** Match THEN step: - **THEN** content or **THEN**: content */
+    THEN: RegExp;
+};
+/**
+ * Parse an OpenSpec spec file
+ *
+ * @param filePath - Absolute path to the spec.md file
+ * @returns Parsed spec object
+ * @throws Error if file cannot be read
+ *
+ * @example
+ * const spec = parseSpecFile("/path/to/openspec/specs/cli-init/spec.md");
+ * console.log(spec.title);        // "CLI Init Specification"
+ * console.log(spec.capability);   // "cli-init"
+ * console.log(spec.requirements); // Array of parsed requirements
+ */
+export declare function parseSpecFile(filePath: string): ParsedOpenSpecSpec;
+/**
+ * Extract the capability name from the file path
+ *
+ * Assumes path structure: .../specs/[capability]/spec.md
+ *
+ * @param filePath - Path to the spec file
+ * @returns Capability directory name
+ */
+export declare function extractCapability(filePath: string): string;
+/**
+ * Parse all requirements from spec content
+ *
+ * @param content - Full markdown content
+ * @returns Array of parsed requirements
+ */
+export declare function parseRequirements(content: string): ParsedRequirement[];
+/**
+ * Parse scenarios from requirement content
+ *
+ * @param content - Requirement section content
+ * @returns Array of parsed scenarios
+ */
+export declare function parseScenarios(content: string): ParsedScenario[];
+/**
+ * Parse GIVEN/WHEN/THEN steps from scenario lines
+ *
+ * @param lines - Lines within a scenario section
+ * @returns Object with given, when, then arrays
+ */
+export declare function parseGivenWhenThen(lines: string[]): {
+    given: string[];
+    when: string[];
+    then: string[];
+};
+//# sourceMappingURL=spec-parser.d.ts.map

package/dist/parser/spec-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-parser.d.ts","sourceRoot":"","sources":["../../src/parser/spec-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB,sDAAsD;;IAGtD,wDAAwD;;IAGxD,kEAAkE;;IAGlE,+DAA+D;;IAG/D,+DAA+D;;CAEhE,CAAC;AAMF;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAyBlE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU1D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,EAAE,CA2CtE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CA4ChE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EAAE,GACd;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAgCrD"}