@hstm-labs/forge-spec-parser 0.1.2

package/dist/parsers/markdown-parser.js

@@ -0,0 +1,606 @@
+/**
+ * Markdown specification parser plugin.
+ *
+ * Converts rich Markdown specification documents into the canonical
+ * {@link ParsedSpecification} model using a two-phase pipeline:
+ *   1. Markdown → mdast (Abstract Syntax Tree) via unified/remark
+ *   2. mdast → ParsedSpecification via AST walking and extraction
+ */
+import { unified } from 'unified';
+import remarkParse from 'remark-parse';
+import remarkFrontmatter from 'remark-frontmatter';
+import remarkGfm from 'remark-gfm';
+import { parse as parseYaml } from 'yaml';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const REQUIREMENT_KEYWORDS = [
+    'requirements',
+    'features',
+    'functional requirements',
+    'user stories',
+];
+const ENTITY_KEYWORDS = [
+    'entities',
+    'data model',
+    'schema',
+    'models',
+    'database',
+];
+const WORKFLOW_KEYWORDS = [
+    'workflows',
+    'flows',
+    'use cases',
+    'user flows',
+    'processes',
+];
+/** Values that indicate a field is required (case-insensitive). */
+const REQUIRED_VALUES = new Set(['yes', 'true', 'required', '✓', 'x']);
+// ---------------------------------------------------------------------------
+// Helper Functions
+// ---------------------------------------------------------------------------
+/** Extract plain text from an array of phrasing content nodes. */
+function phrasingToText(nodes) {
+    return nodes
+        .map((node) => {
+        switch (node.type) {
+            case 'text':
+            case 'inlineCode':
+            case 'html':
+                return node.value;
+            case 'break':
+                return '\n';
+            case 'image':
+            case 'imageReference':
+                return node.alt ?? '';
+            case 'footnoteReference':
+                return '';
+            default:
+                // emphasis, strong, delete, link, linkReference — recurse
+                if ('children' in node) {
+                    return phrasingToText(node.children);
+                }
+                return '';
+        }
+    })
+        .join('');
+}
+/**
+ * Extract plain text from block-level content nodes.
+ *
+ * Accepts `RootContent[]` or structurally-compatible arrays (e.g.
+ * `(BlockContent | DefinitionContent)[]`). The union types overlap
+ * extensively so a single cast at the call-site is safe and avoids
+ * verbose per-node narrowing across the mdast hierarchy.
+ */
+function contentNodesToText(nodes) {
+    return nodes
+        .map((node) => {
+        switch (node.type) {
+            case 'paragraph':
+                return phrasingToText(node.children);
+            case 'heading':
+                return phrasingToText(node.children);
+            case 'code':
+                return node.value;
+            case 'blockquote':
+                // BlockContent[] is a subset of RootContent[]
+                return contentNodesToText(node.children);
+            case 'list':
+                return node.children
+                    .map((item) => contentNodesToText(item.children))
+                    .join('\n');
+            case 'html':
+                return node.value;
+            case 'yaml':
+            case 'thematicBreak':
+                return '';
+            default:
+                return '';
+        }
+    })
+        .filter(Boolean)
+        .join('\n');
+}
+/** Convert text to a URL-friendly slug. */
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+/** Detect MoSCoW priority from text. */
+function detectMoscow(text) {
+    const lower = text.toLowerCase();
+    if (/\bmust\b/.test(lower))
+        return 'must';
+    if (/\bshould\b/.test(lower))
+        return 'should';
+    if (/\bcould\b/.test(lower))
+        return 'could';
+    if (/\bwon'?t\b/.test(lower))
+        return 'wont';
+    return undefined;
+}
+/** Check whether a heading title matches any of the given keywords. */
+function matchesKeywords(title, keywords) {
+    const lower = title.toLowerCase();
+    return keywords.some((kw) => lower.includes(kw));
+}
+/** Extract the first sentence or line from text. */
+function firstSentence(text) {
+    const match = text.match(/^(.+?[.!?])(?:\s|$)/);
+    if (match?.[1])
+        return match[1].trim();
+    const firstLine = text.split('\n')[0];
+    return firstLine ? firstLine.trim() : text.trim();
+}
+/** Get the cell text content from a table row at a specific column index. */
+function tableCellText(row, index) {
+    const cell = row.children[index];
+    return cell ? phrasingToText(cell.children) : '';
+}
+/**
+ * Find sections in the AST whose headings match the given keywords.
+ * Collects all nodes belonging to each matched section (until the next
+ * heading at the same or higher level).
+ */
+function findKeywordSections(tree, keywords) {
+    const results = [];
+    let current = null;
+    for (const node of tree.children) {
+        if (node.type === 'heading') {
+            const title = phrasingToText(node.children);
+            if (matchesKeywords(title, keywords)) {
+                if (current)
+                    results.push(current);
+                current = { heading: title, level: node.depth, nodes: [] };
+            }
+            else if (current && node.depth <= current.level) {
+                results.push(current);
+                current = null;
+            }
+            else if (current) {
+                current.nodes.push(node);
+            }
+        }
+        else if (current && node.type !== 'yaml') {
+            current.nodes.push(node);
+        }
+    }
+    if (current)
+        results.push(current);
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Relationship Extraction
+// ---------------------------------------------------------------------------
+const RELATIONSHIP_PATTERNS = [
+    { pattern: /has\s+many\s+(\w+)/gi, type: 'one-to-many' },
+    { pattern: /has\s+one\s+(\w+)/gi, type: 'one-to-one' },
+    { pattern: /belongs\s+to\s+(\w+)/gi, type: 'one-to-many' },
+    {
+        pattern: /many\s+to\s+many\s+(?:with\s+)?(\w+)/gi,
+        type: 'many-to-many',
+    },
+];
+function extractRelationshipsFromText(text) {
+    const relationships = [];
+    for (const { pattern, type } of RELATIONSHIP_PATTERNS) {
+        // Reset lastIndex for each exec loop on global regex
+        pattern.lastIndex = 0;
+        let match;
+        while ((match = pattern.exec(text)) !== null) {
+            const target = match[1];
+            if (target) {
+                relationships.push({ target, type });
+            }
+        }
+    }
+    return relationships;
+}
+// ---------------------------------------------------------------------------
+// MarkdownParserPlugin
+// ---------------------------------------------------------------------------
+/**
+ * Parser plugin for Markdown specification files.
+ *
+ * Implements the two-phase Markdown → AST → ParsedSpecification pipeline.
+ * Supports YAML frontmatter, GFM tables, task lists, and ordered lists.
+ */
+export class MarkdownParserPlugin {
+    format = 'markdown';
+    extensions = ['.md'];
+    /**
+     * Parse a Markdown specification into the canonical model.
+     *
+     * @param content - Raw Markdown content
+     * @param sourcePath - Original file path
+     * @returns Parsed specification
+     */
+    parse(content, sourcePath) {
+        // Phase 1: Markdown → AST
+        const tree = unified()
+            .use(remarkParse)
+            .use(remarkFrontmatter, ['yaml'])
+            .use(remarkGfm)
+            .parse(content);
+        // Phase 2: AST → ParsedSpecification
+        const metadata = this.extractMetadata(tree, sourcePath);
+        const sections = this.extractSections(tree);
+        const requirements = this.extractRequirements(tree);
+        const entities = this.extractEntities(tree);
+        const workflows = this.extractWorkflows(tree);
+        const apiStyle = this.detectApiStyle(content);
+        const result = {
+            metadata,
+            sections,
+            requirements,
+            entities,
+            workflows,
+        };
+        if (apiStyle !== undefined) {
+            result.apiStyle = apiStyle;
+        }
+        return result;
+    }
+    // -----------------------------------------------------------------------
+    // Metadata Extraction
+    // -----------------------------------------------------------------------
+    extractMetadata(tree, sourcePath) {
+        let title = '';
+        let version;
+        let description;
+        let authors;
+        // Try YAML frontmatter first
+        const yamlNode = tree.children.find((n) => n.type === 'yaml');
+        if (yamlNode && 'value' in yamlNode) {
+            try {
+                const fm = parseYaml(yamlNode.value);
+                if (typeof fm === 'object' && fm !== null) {
+                    if (typeof fm['title'] === 'string')
+                        title = fm['title'];
+                    if (typeof fm['version'] === 'string')
+                        version = fm['version'];
+                    if (typeof fm['description'] === 'string')
+                        description = fm['description'];
+                    if (Array.isArray(fm['authors'])) {
+                        authors = fm['authors'].filter((a) => typeof a === 'string');
+                    }
+                }
+            }
+            catch {
+                // Malformed YAML — fall through to heading fallback
+            }
+        }
+        // Fallback: use first h1 heading as title
+        if (!title) {
+            const firstH1 = tree.children.find((n) => n.type === 'heading' && n.depth === 1);
+            if (firstH1) {
+                title = phrasingToText(firstH1.children);
+            }
+        }
+        const metadata = {
+            title: title || 'Untitled',
+            sourcePath,
+            format: 'markdown',
+        };
+        if (version !== undefined)
+            metadata.version = version;
+        if (description !== undefined)
+            metadata.description = description;
+        if (authors !== undefined && authors.length > 0)
+            metadata.authors = authors;
+        return metadata;
+    }
+    // -----------------------------------------------------------------------
+    // Section Extraction
+    // -----------------------------------------------------------------------
+    extractSections(tree) {
+        const rootSections = [];
+        const stack = [];
+        let contentBuffer = [];
+        let currentSection = null;
+        for (const node of tree.children) {
+            if (node.type === 'heading') {
+                // Finalize previous section content
+                if (currentSection) {
+                    currentSection.content = contentNodesToText(contentBuffer).trim();
+                }
+                contentBuffer = [];
+                const title = phrasingToText(node.children);
+                const newSection = {
+                    id: slugify(title),
+                    title,
+                    level: node.depth,
+                    content: '',
+                    subsections: [],
+                };
+                // Pop stack until parent with lower level is found
+                while (stack.length > 0 &&
+                    stack[stack.length - 1].level >= node.depth) {
+                    stack.pop();
+                }
+                if (stack.length === 0) {
+                    rootSections.push(newSection);
+                }
+                else {
+                    stack[stack.length - 1].subsections.push(newSection);
+                }
+                stack.push(newSection);
+                currentSection = newSection;
+            }
+            else if (node.type !== 'yaml') {
+                contentBuffer.push(node);
+            }
+        }
+        // Finalize last section
+        if (currentSection) {
+            currentSection.content = contentNodesToText(contentBuffer).trim();
+        }
+        return rootSections;
+    }
+    // -----------------------------------------------------------------------
+    // Requirement Extraction
+    // -----------------------------------------------------------------------
+    extractRequirements(tree) {
+        const sections = findKeywordSections(tree, REQUIREMENT_KEYWORDS);
+        const requirements = [];
+        let counter = 0;
+        for (const section of sections) {
+            const lists = section.nodes.filter((n) => n.type === 'list');
+            for (const list of lists) {
+                for (const item of list.children) {
+                    counter++;
+                    requirements.push(this.listItemToRequirement(item, counter));
+                }
+            }
+        }
+        return requirements;
+    }
+    listItemToRequirement(item, index) {
+        const id = `REQ-${String(index).padStart(3, '0')}`;
+        // Get text from the item's direct paragraph children
+        const paragraphs = item.children.filter((n) => n.type === 'paragraph');
+        const fullText = paragraphs
+            .map((p) => phrasingToText(p.children))
+            .join(' ');
+        const title = firstSentence(fullText);
+        const priority = detectMoscow(fullText);
+        // Extract acceptance criteria from nested task-list items
+        const acceptanceCriteria = [];
+        const nestedLists = item.children.filter((n) => n.type === 'list');
+        for (const nestedList of nestedLists) {
+            for (const nestedItem of nestedList.children) {
+                if (typeof nestedItem.checked === 'boolean') {
+                    const criteriaText = contentNodesToText(nestedItem.children).trim();
+                    if (criteriaText) {
+                        acceptanceCriteria.push(criteriaText);
+                    }
+                }
+            }
+        }
+        const req = {
+            id,
+            title,
+            description: fullText,
+            acceptanceCriteria,
+        };
+        if (priority !== undefined)
+            req.priority = priority;
+        return req;
+    }
+    // -----------------------------------------------------------------------
+    // Entity Extraction
+    // -----------------------------------------------------------------------
+    extractEntities(tree) {
+        const sections = findKeywordSections(tree, ENTITY_KEYWORDS);
+        const entities = [];
+        for (const section of sections) {
+            entities.push(...this.extractEntitiesFromNodes(section.nodes, section.heading));
+        }
+        return entities;
+    }
+    extractEntitiesFromNodes(nodes, defaultName) {
+        const entities = [];
+        let currentName = defaultName;
+        let currentDescription;
+        let currentFields = [];
+        let currentRelationships = [];
+        let hasSubEntities = false;
+        for (const node of nodes) {
+            if (node.type === 'heading') {
+                // Flush previous entity if it has fields
+                if (hasSubEntities && currentFields.length > 0) {
+                    entities.push(this.buildEntity(currentName, currentDescription, currentFields, currentRelationships));
+                }
+                hasSubEntities = true;
+                currentName = phrasingToText(node.children);
+                currentDescription = undefined;
+                currentFields = [];
+                currentRelationships = [];
+            }
+            else if (node.type === 'table') {
+                currentFields.push(...this.parseTableFields(node));
+            }
+            else if (node.type === 'list' &&
+                !node.ordered) {
+                currentFields.push(...this.parseListFields(node));
+            }
+            else if (node.type === 'paragraph') {
+                const text = phrasingToText(node.children);
+                currentRelationships.push(...extractRelationshipsFromText(text));
+                if (currentDescription === undefined) {
+                    currentDescription = text;
+                }
+            }
+        }
+        // Flush last entity
+        if (currentFields.length > 0) {
+            entities.push(this.buildEntity(currentName, currentDescription, currentFields, currentRelationships));
+        }
+        return entities;
+    }
+    buildEntity(name, description, fields, relationships) {
+        const entity = {
+            name,
+            fields,
+            relationships,
+        };
+        if (description !== undefined)
+            entity.description = description;
+        return entity;
+    }
+    parseTableFields(table) {
+        const rows = table.children;
+        if (rows.length < 2)
+            return [];
+        const headerRow = rows[0];
+        const headers = headerRow.children.map((cell) => phrasingToText(cell.children).toLowerCase().trim());
+        // Find column indices
+        const nameIdx = headers.findIndex((h) => h === 'name' || h === 'field' || h === 'column');
+        const typeIdx = headers.findIndex((h) => h === 'type' || h === 'data type' || h === 'datatype');
+        const reqIdx = headers.findIndex((h) => h === 'required' ||
+            h === 'req' ||
+            h === 'nullable' ||
+            h === 'null');
+        const descIdx = headers.findIndex((h) => h === 'description' || h === 'desc' || h === 'notes');
+        if (nameIdx === -1)
+            return [];
+        const fields = [];
+        for (let i = 1; i < rows.length; i++) {
+            const row = rows[i];
+            const name = tableCellText(row, nameIdx).trim();
+            if (!name)
+                continue;
+            const type = typeIdx >= 0 ? tableCellText(row, typeIdx).trim() : 'string';
+            const reqValue = reqIdx >= 0
+                ? tableCellText(row, reqIdx).trim().toLowerCase()
+                : '';
+            const desc = descIdx >= 0 ? tableCellText(row, descIdx).trim() : undefined;
+            const required = REQUIRED_VALUES.has(reqValue);
+            const field = { name, type, required };
+            if (desc !== undefined && desc !== '')
+                field.description = desc;
+            fields.push(field);
+        }
+        return fields;
+    }
+    parseListFields(list) {
+        const fields = [];
+        for (const item of list.children) {
+            const text = contentNodesToText(item.children).trim();
+            if (!text)
+                continue;
+            // Try "name: type" or "name: type (required)" patterns
+            const colonMatch = text.match(/^(\w+)\s*:\s*(\w+)(?:\s*\(([^)]+)\))?/);
+            if (colonMatch?.[1] && colonMatch[2]) {
+                const meta = colonMatch[3]?.toLowerCase() ?? '';
+                fields.push({
+                    name: colonMatch[1],
+                    type: colonMatch[2],
+                    required: meta.includes('required'),
+                });
+                continue;
+            }
+            // Try "name - type" pattern
+            const dashMatch = text.match(/^(\w+)\s+-\s+(\w+)/);
+            if (dashMatch?.[1] && dashMatch[2]) {
+                fields.push({
+                    name: dashMatch[1],
+                    type: dashMatch[2],
+                    required: text.toLowerCase().includes('required'),
+                });
+            }
+        }
+        return fields;
+    }
+    // -----------------------------------------------------------------------
+    // Workflow Extraction
+    // -----------------------------------------------------------------------
+    extractWorkflows(tree) {
+        const sections = findKeywordSections(tree, WORKFLOW_KEYWORDS);
+        const workflows = [];
+        let counter = 0;
+        for (const section of sections) {
+            let currentName = section.heading;
+            let currentNodes = [];
+            let hasSubWorkflows = false;
+            for (const node of section.nodes) {
+                if (node.type === 'heading') {
+                    if (currentNodes.length > 0) {
+                        const wf = this.buildWorkflow(currentName, currentNodes, ++counter);
+                        if (wf)
+                            workflows.push(wf);
+                    }
+                    hasSubWorkflows = true;
+                    currentName = phrasingToText(node.children);
+                    currentNodes = [];
+                }
+                else {
+                    currentNodes.push(node);
+                }
+            }
+            // Flush: if no sub-headings, use the entire section
+            if (!hasSubWorkflows) {
+                currentNodes = section.nodes;
+            }
+            if (currentNodes.length > 0) {
+                const wf = this.buildWorkflow(currentName, currentNodes, ++counter);
+                if (wf)
+                    workflows.push(wf);
+            }
+        }
+        return workflows;
+    }
+    buildWorkflow(name, nodes, index) {
+        const orderedLists = nodes.filter((n) => n.type === 'list' && n.ordered === true);
+        if (orderedLists.length === 0)
+            return null;
+        const steps = [];
+        for (const list of orderedLists) {
+            let order = list.start ?? 1;
+            for (const item of list.children) {
+                const action = contentNodesToText(item.children).trim();
+                if (action) {
+                    steps.push({ order, action });
+                    order++;
+                }
+            }
+        }
+        if (steps.length === 0)
+            return null;
+        // Detect actors from step text
+        const fullText = steps.map((s) => s.action).join(' ');
+        const actorPattern = /\b(User|Admin|System|Customer|Manager|Client|Server|Developer|Operator)\b/gi;
+        const actorMatches = fullText.match(actorPattern);
+        const actors = actorMatches
+            ? [
+                ...new Set(actorMatches.map((a) => a.charAt(0).toUpperCase() + a.slice(1).toLowerCase())),
+            ]
+            : undefined;
+        const id = `WF-${String(index).padStart(3, '0')}`;
+        const workflow = {
+            id,
+            name,
+            steps,
+        };
+        if (actors !== undefined && actors.length > 0)
+            workflow.actors = actors;
+        return workflow;
+    }
+    // -----------------------------------------------------------------------
+    // API Style Detection
+    // -----------------------------------------------------------------------
+    detectApiStyle(content) {
+        const lower = content.toLowerCase();
+        if (lower.includes('rest api') || lower.includes('restful api'))
+            return 'rest';
+        if (lower.includes('graphql'))
+            return 'graphql';
+        if (lower.includes('grpc'))
+            return 'grpc';
+        return undefined;
+    }
+}
+//# sourceMappingURL=markdown-parser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-parser.js","sourceRoot":"","sources":["../../src/parsers/markdown-parser.ts"],"names":[],"mappings":"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"}

package/dist/parsers/structured-mapper.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared mapping logic for structured (YAML / JSON) specification files.
+ *
+ * Both the YAML and JSON parsers produce a raw `unknown` object after parsing
+ * their respective formats. This module validates the structure and maps it
+ * into the canonical {@link ParsedSpecification} model.
+ */
+import type { ParsedSpecification, SpecFormat } from '../types.js';
+/**
+ * Map a parsed structured object into the canonical specification model.
+ *
+ * Validates the data structure (title required, arrays are arrays, etc.)
+ * and maps to canonical types with safe defaults.
+ *
+ * @param data - Raw parsed data (from YAML or JSON)
+ * @param sourcePath - Original file path
+ * @param format - Specification format (`'yaml'` or `'json'`)
+ * @returns Parsed specification
+ * @throws {@link ForgeError} with code `FORGE-SPEC-001` if `title` is missing or data is not an object
+ */
+export declare function mapStructuredSpec(data: unknown, sourcePath: string, format: SpecFormat): ParsedSpecification;
+//# sourceMappingURL=structured-mapper.d.ts.map

package/dist/parsers/structured-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-mapper.d.ts","sourceRoot":"","sources":["../../src/parsers/structured-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,mBAAmB,EASnB,UAAU,EACX,MAAM,aAAa,CAAC;AAiDrB;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,UAAU,GACjB,mBAAmB,CAsCrB"}